140 lines
5.7 KiB
Markdown
140 lines
5.7 KiB
Markdown
# 商业化地基 8 项收口记录
|
||
|
||
更新时间：2026-05-30
|
||
|
||
本文件记录本轮按“商业化私有交付”目标推进的 8 项地基工作。它不是销售文案，也不是旧参考源码搬运清单；本文档只是 2026-05-30 的阶段快照，不是默认入口，后续判断以当前代码、配置和部署文件为准。
|
||
|
||
## 1. 客户安装和升级演练
|
||
|
||
当前事实：
|
||
|
||
- 标准客户入口仍是 `docker-compose.prod.yml + .env`。
|
||
- `deploy-registry.ps1` 是版本化发布和已有客户升级入口，不是完整首装向导。
|
||
- 当前自动备份主要覆盖 Compose 管理的 PostgreSQL；外部数据库、外部对象存储和离线包升级还需要单独演练。
|
||
|
||
本轮收口：
|
||
|
||
- 文档继续明确首装、发布、升级三件事不能混成一个命令。
|
||
- 全库清理接口新增确认短语，避免最高权限账号误触发后直接清空素材。
|
||
|
||
仍不能假装完成：
|
||
|
||
- 真实客户机上的外部数据库备份、对象存储快照、离线升级包、失败回滚，还需要单独实机演练。
|
||
|
||
## 2. 对象存储和历史公开权限
|
||
|
||
当前事实：
|
||
|
||
- 新安装和新上传默认不再公开素材桶，素材文件走登录态代理或分享票据。
|
||
- MinIO 初始化只能处理当前 Compose 管理的 bucket 匿名策略。
|
||
|
||
本轮收口：
|
||
|
||
- 上传失败时，生产环境不再把原始错误详情返回给前端，内部路径、数据库错误和存储错误只留在服务端日志。
|
||
|
||
仍不能假装完成：
|
||
|
||
- 外部 S3、历史 bucket、历史对象 ACL、公共 Logo / 头像与私有素材的拆分策略，需要单独只读审计。
|
||
|
||
## 3. 大文件和文件一致性
|
||
|
||
当前事实：
|
||
|
||
- 原始素材上传、下载、播放已经做了主要流式收口。
|
||
- 预览图、PSD 展示图、图片处理仍可能进内存，后续需要更明确限制。
|
||
|
||
本轮收口：
|
||
|
||
- 素材编辑换预览图时，改为先上传新图、数据库更新成功后再删旧图；如果数据库更新失败，会清理新上传图，避免数据库指向已被提前删掉的旧图。
|
||
- 软删除素材不再能通过下载接口继续下载。
|
||
|
||
仍不能假装完成：
|
||
|
||
- 分片上传、断点续传、上传失败重试、PSD 大图像素限制还没有完成。
|
||
|
||
## 4. 自定义模板深水区
|
||
|
||
当前事实：
|
||
|
||
- 自定义模板、字段池、分类字段、模板迁移已有第一轮加固。
|
||
- 大批量迁移、复杂字段、多选字段和大数据性能仍是后续重点。
|
||
|
||
本轮收口：
|
||
|
||
- 模板管理前端操作权限跟后端对齐：普通管理员可查看，但创建、复制、编辑、删除、迁移自定义模板只给最高权限账号开放。
|
||
- 未授权或非最高权限账号点击时，不再表现成“先能点、再失败”的错位体验。
|
||
|
||
仍不能假装完成：
|
||
|
||
- 大批量模板迁移任务化、迁移进度、失败清单、回滚方案仍待做。
|
||
|
||
## 5. 权限和监控可见性
|
||
|
||
当前事实：
|
||
|
||
- 多数破坏性操作已经收为最高权限账号。
|
||
- 系统监控、转码统计属于全局状态，不适合普通管理员默认可见。
|
||
- 私有化交付默认不应开放公开注册，账号入口应优先走最高权限账号创建或邀请链接。
|
||
|
||
本轮收口：
|
||
|
||
- `/api/admin/system-status` 改为最高权限账号可读。
|
||
- `/api/admin/video-transcode-stats` 改为最高权限账号可读。
|
||
- 头像菜单里的“监控仪表板”只对最高权限账号显示。
|
||
- 监控接口遇到数据库查询失败时不再继续报告 `healthy`，避免验收误判。
|
||
- 公开注册默认值已经贯穿数据库字段、系统设置兜底、首次创建设置和注册接口；没有系统设置记录时也不会默认开放普通自助注册。
|
||
- 后台“用户手动注册”开关只允许最高权限账号修改，普通管理员不能打开客户系统的公开注册入口。
|
||
|
||
仍不能假装完成：
|
||
|
||
- 剩余 `ADMIN` 写接口、批量导入、维护类入口仍需继续逐项扫。
|
||
|
||
## 6. 前端 UI 去模板感
|
||
|
||
当前事实：
|
||
|
||
- 当前 UI 已经比早期更克制，但局部仍有模板式视觉：渐变底、弹窗套壳、移动端固定宽度、彩色标签过多。
|
||
|
||
本轮收口：
|
||
|
||
- 全局 `body` 背景从渐变改为纯色。
|
||
- 登录页钉钉按钮降为普通次按钮规格，不再比主登录按钮抢眼。
|
||
- 素材预览弹窗去掉移动端固定最小宽度，降低窄屏横向溢出风险。
|
||
|
||
仍不能假装完成：
|
||
|
||
- 上传弹窗、模板编辑弹窗、首页素材卡动作区、邀请管理移动端表格还要继续收敛。
|
||
|
||
## 7. Go Agent 和版本来源
|
||
|
||
当前事实：
|
||
|
||
- Go Agent 已不再默认拉旧 Harbor / `latest`。
|
||
- 版本列表目前仍是 `FLNXI_VERSION_LIST_URL` 过渡口径。
|
||
|
||
本轮收口：
|
||
|
||
- 没有把 Go Agent 当成已经可正式客户交付的主入口写入默认安装流程。
|
||
- 内网穿透启动、停止和状态查询不再返回占位成功；即使最高权限账号和许可证都通过，真实提供商未接入时也会明确返回未实现。
|
||
|
||
仍不能假装完成：
|
||
|
||
- 正式版本来源要在许可证服务、发布管理接口、Registry tags 清单三种方案里定一个。
|
||
- Go Agent Web 管理界面还需要和主应用工作台风格统一。
|
||
|
||
## 8. 本机测试环境
|
||
|
||
当前事实：
|
||
|
||
- 本机调试默认入口是 `npm run dev:local` 和 `http://localhost:3002`。
|
||
- `.env.development.local` 应指向本机数据库和对象存储；如果本机 PostgreSQL / MinIO 没启动，浏览器管理页验收会失败。
|
||
|
||
本轮收口：
|
||
|
||
- 文档继续保留旧测试服务器不可作为事实来源的提示。
|
||
- 后续前端浏览器验收前，必须先确认本机数据库和对象存储已恢复。
|
||
|
||
本轮补充：
|
||
|
||
- 当前已在飞牛虚拟机里完成首装、初始化、免费版激活、上传、备份和恢复验收；后续任务转为继续收紧部署说明、权限口径和升级脚本。
|