154 lines
5.9 KiB
Markdown
154 lines
5.9 KiB
Markdown
# OPC 管理系统 PRD 修改日志
|
||
|
||
---
|
||
|
||
## v0.9 → v1.0（2026-06-01）
|
||
|
||
### 版本升级
|
||
- PRD 阶段从「需求核对稿」升级为「实际落地版」
|
||
- 版本号从 v0.9 → v1.0
|
||
- 匹配 OPC-Manager v1.0.2 代码实现
|
||
|
||
### 功能布局变更
|
||
|
||
| 模块 | v0.9 | v1.0 | 原因 |
|
||
|------|------|------|------|
|
||
| 业务方案 Tab | 一个版本一个**卡片** | 表格布局 | 与销售、运营保持一致的交互模式，表格更适合多版本扫描 |
|
||
| 产品 Tab | 一个版本一个**卡片** | 表格布局 | 同上，统一交互体验 |
|
||
|
||
### 交互细节补充
|
||
|
||
| 项 | v0.9 | v1.0 |
|
||
|----|------|------|
|
||
| 抽屉宽度 | 未指定 | 720px 固定宽度 |
|
||
| 保存方式 | "关闭抽屉时提示保存" | 字段失焦自动保存 + 状态反馈（保存中/已保存/失败） |
|
||
| 抽屉外点击关闭 | 未明确 | 已删除此交互 |
|
||
| 富文本编辑器 | 未指定 | Squire RTE v1（Fastmail） |
|
||
| 评论格式 | 未指定 | HTML 格式（encodeURIComponent 存储，decodeURIComponent 渲染） |
|
||
| 评论删除 | 未指定 | 所有评论 hover 显示删除图标，带确认弹窗 |
|
||
| Squire 工具栏 | 未指定 | 使用 onmousedown 防止编辑器失焦 |
|
||
| 列表渲染 | 未指定 | .rich-content ul/ol 使用 list-style: revert 覆盖 Tailwind reset |
|
||
|
||
### 数据模型变更
|
||
|
||
| 项 | v0.9 | v1.0 |
|
||
|----|------|------|
|
||
| FileAsset | operation_files 独立表 | 统一 file_assets 表，通过 module 字段区分 proposal/operation |
|
||
| FileAsset.is_external | 无 | 新增字段，标记原始文件索引（1）vs 本地上传（0） |
|
||
| FollowUpRecord.content | 文本 | HTML 格式 |
|
||
|
||
### 技术栈补充
|
||
|
||
| 项 | v0.9 | v1.0 |
|
||
|----|------|------|
|
||
| 富文本编辑器 | 未指定 | Squire RTE（squire-rte CDN v1，build/squire-raw.js） |
|
||
| Chart.js 版本 | 未指定 | 4.4.8 |
|
||
| Chart 配置 | 未指定 | maintainAspectRatio: false + 固定容器高度 140px |
|
||
| Flask 版本 | 未指定 | 3.1.3 |
|
||
| 项目结构 | 未列出 | 新增 7.6 节完整目录结构 |
|
||
|
||
### 章节结构变更
|
||
|
||
| 项 | v0.9 | v1.0 |
|
||
|----|------|------|
|
||
| 首页指标 | 6 项 | 7 项（新增"即将上线版本数"） |
|
||
| 首页指标布局 | 未指定 | 4 列网格（grid-cols-4）自动换行 |
|
||
| 设计规范 | 大量引用 ui-ux-pro-max-skill/frontend-design | 精简为实际的视觉规范表格 + 设计辅助工具已使用说明 |
|
||
| 版本历史 | 无 | 新增第 12 章版本历史 + 关联 CHANGELOG |
|
||
|
||
---
|
||
|
||
## 文件存档
|
||
|
||
| 文件 | 路径 |
|
||
|------|------|
|
||
| v0.9 原始 PRD | `docs/prd-history/OPC管理系统PRD-V0.9.md` |
|
||
| v1.0 当前 PRD | `OPC管理系统PRD.md`（根目录） |
|
||
| 修改日志（本文件） | `docs/prd/CHANGELOG.md` |
|
||
|
||
---
|
||
|
||
## v1.0 → v2.0（2026-06-16）
|
||
|
||
### 版本升级
|
||
|
||
- PRD 匹配 OPC-Manager v1.7.6 代码实现
|
||
- 新增 `OPC管理系统PRD-V2.0.md`
|
||
|
||
### 架构级变更
|
||
|
||
| 模块 | v1.0 | v2.0 | 原因 |
|
||
|------|------|------|------|
|
||
| 销售管理 + 运营管理 | 两个独立 Tab | 合并为「重点项目」Tab | 业务机会到执行是同一项目的不同阶段 |
|
||
| 任务追踪 | 无 | 6 阶段任务体系 + project_tasks 表 | 参考科普项目 Excel 台账管理 |
|
||
| 任务详情 | 无 | 二级页面（Tab 内渲染） | 替代弹窗，完整页面体验 |
|
||
| 任务编辑 | 无 | 右侧抽屉（fixed 定位，420px） | 不打断列表浏览 |
|
||
| 首页指标 | 7 项 | 14 项（两层：经营核心 + 财务分层） | 增加合同金额、年度/Q2 财务汇总 |
|
||
|
||
### Tab 数量变更
|
||
|
||
| v1.0 | v2.0 |
|
||
|------|------|
|
||
| 首页、销售管理、业务方案、运营管理、产品研发、财务管理（6 Tab） | 首页、重点项目、业务方案、产品研发、财务管理（5 Tab） |
|
||
|
||
### 重点项目详细变更
|
||
|
||
| 项 | v1.0 | v2.0 |
|
||
|----|------|------|
|
||
| 列表列 | 项目名称/类型/状态/金额/阶段/文件/跟进（7 列） | 项目/说明/阶段/金额/负责人/进展（6 列） |
|
||
| 筛选按钮 | 全部/业务机会/已签约执行 | 已去除，列表不做阶段筛选 |
|
||
| 抽屉字段 | 14 个字段 | 6 个字段（名称/阶段/金额/截止/负责人/说明）+ 删除按钮 |
|
||
| 当前阶段 | 文本输入 | 6 阶段下拉框（change 自动保存） |
|
||
| 阶段体系 | 无标准 | 商务洽谈→系统上线→团队分工→项目交付→上线推广→结项验收 |
|
||
| 版本号 | 项目名称含版本号 | 去除，仅保留项目名称 |
|
||
|
||
### 新增数据表
|
||
|
||
**project_tasks：**
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| project_id | INTEGER | 关联 operation_projects |
|
||
| phase | TEXT | 6 阶段之一 |
|
||
| milestone | TEXT | 里程碑 |
|
||
| task | TEXT | 任务名称 |
|
||
| owner | TEXT | 负责人 |
|
||
| due_date | TEXT | 截止时间 |
|
||
| blockers | TEXT | 卡点&备注 |
|
||
| notes | TEXT | 任务说明 |
|
||
|
||
### 产品 Tab 变更
|
||
|
||
| 项 | v1.0 | v2.0 |
|
||
|----|------|------|
|
||
| 平台字段 | 无 | 新增 platform 字段（真研平台/科普平台/关爱平台） |
|
||
| 列表列 | 产品/版本/目标/功能/日期/状态（6 列） | 产品/版本/目标/功能/平台/日期/状态（7 列） |
|
||
|
||
### 聚合指标变更
|
||
|
||
| 指标 | v1.0 | v2.0 |
|
||
|------|------|------|
|
||
| P0 客户数 | ✓ | ✓ |
|
||
| 跟进中销售机会 | ✓ | ✓ |
|
||
| 已签约执行项目 | ✓ | ✓ |
|
||
| 有风险项目 | ✓ | ✓ |
|
||
| 本月收入 | ✓ | ✓ |
|
||
| 本月净利 | ✓ | ✓ |
|
||
| 即将上线版本 | ✓ | ✓ |
|
||
| 已签约未执行金额 | — | ✓ 新增 |
|
||
| 已签约合同总额 | — | ✓ 新增 |
|
||
| 合同流程中金额 | — | ✓ 新增 |
|
||
| 年度累计确收 | — | ✓ 新增 |
|
||
| Q2 累计确收 | — | ✓ 新增 |
|
||
| 年度累计毛利 | — | ✓ 新增 |
|
||
| Q2 累计毛利 | — | ✓ 新增 |
|
||
|
||
### 技术实现变更
|
||
|
||
| 项 | v1.0 | v2.0 |
|
||
|----|------|------|
|
||
| 前端交互 | 弹窗 modal | Tab 内二级页面（state.projectView） |
|
||
| 任务编辑 | 无 | fixed 抽屉 + submitTaskForm/openTaskForm |
|
||
| 自动保存 | blur 事件 | blur（input）+ change（select） |
|
||
| Lucide 刷新 | render() 统一调用 | 各 render 函数独立调用 createIcons() |
|