5.7 KiB
5.7 KiB
商业化地基 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 没启动，浏览器管理页验收会失败。
本轮收口：
- 文档继续保留旧测试服务器不可作为事实来源的提示。
- 后续前端浏览器验收前，必须先确认本机数据库和对象存储已恢复。
仍不能假装完成：
- 当前没有在飞牛虚拟机或本机 Docker 里完成一轮完整客户安装验收；这仍是下一轮部署演练任务。