v1.7.7 — 更新产品文档 PRD v2.0 + CHANGELOG v1.0→v2.0

docs/prd/CHANGELOG.md

@@ -65,3 +65,89 @@
 | 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() |

docs/prd/OPC管理系统PRD-V2.0.md

@@ -0,0 +1,338 @@
+# OPC 管理系统 PRD
+
+版本：v2.0
+日期：2026-06-16
+阶段：当前落地版（匹配 OPC-Manager v1.7.6 代码实现）
+定位：以科普（慰心斋）为单项目独立版本，打造 OPC 工作台，从全局首页、重点项目、业务方案、产品研发、财务管理 5 个视角，直观、清晰、全面地管理业务全貌。
+
+> 历史版本参见 `OPC管理系统PRD-V1.0.md`、`OPC管理系统PRD-V0.9.md`，修改日志见 `CHANGELOG.md`。
+
+---
+
+## 1. 背景与目标
+
+### 1.1 需求原文
+
+以慰心斋为例，打造一个 OPC 工作台，让我能够直观地看到他销售、业务、运营、产品、财务的情况。另外，之前他为自己单独打造了一个财务体系，把这个财务 manager 系统直接合并进工作台里面，不再作为一个独立的系统。
+
+### 1.2 背景与 v2.0 核心变更
+
+v1.0 的 6 Tab 架构（销售管理 + 业务方案 + 运营管理 + 产品研发 + 财务管理 + 首页）在实际使用中暴露出销售与运营割裂的问题——业务机会和签约执行项目本质上是同一项目的不同阶段，分两个 Tab 管理不自然。
+
+v2.0 做了以下架构级调整：
+
+1. **合并销售 + 运营为「重点项目」**：一个 Tab 管全部项目，项目表格 6 列（项目/说明/阶段/金额/负责人/进展）。
+2. **引入项目任务体系**：每个项目内嵌 6 阶段任务清单（商务洽谈→系统上线→团队分工→项目交付→上线推广→结项验收），支持增删改。
+3. **任务详情改为页内二级页面**：点击「查看」进入项目任务页，有返回按钮，不弹出独立窗口。
+4. **任务编辑改为右侧抽屉**：新增/编辑任务从右侧滑入表单，不打断任务列表浏览。
+5. **首页指标分层**：从 7 项扩展到 14 项，分为经营核心层和财务分层。
+6. **产品增加平台分类**：真研平台/科普平台/关爱平台三种归属。
+
+本系统将承接并合并原有独立财务 manager 能力，财务不再作为单独系统存在，而是作为 OPC 管理系统中的一个 Tab。
+
+### 1.3 样板范围
+
+v2.0 以科普（慰心斋）作为首个单项目独立版本，当前包含信达·科普无界、圆心科技科普文章等多个重点项目。
+
+首版只做单项目、单用户版本，不做多项目、多用户、权限体系。
+
+---
+
+## 2. 信息架构
+
+系统顶部为全局标题和基础操作区，主体为 5 个一级 Tab：
+
+1. **首页** — 经营总览（14 项指标 + 财务趋势 + 风险提醒 + 近期动态）
+2. **重点项目** — 项目列表 + 点击进入任务清单（6 阶段任务管理）
+3. **业务方案** — 按版本管理方案/成本/SOP/财务流程文件
+4. **产品研发** — 按版本管理产品目标/功能/日期（含平台分类）
+5. **财务管理** — 趋势图 + 明细表（收入/成本/毛利/净利）
+
+---
+
+## 3. 功能需求
+
+### 3.1 首页 Tab
+
+首页是科普（慰心斋）单项目的经营总览页。
+
+#### 3.1.1 关键指标（14 项，两组 4 列网格）
+
+**第一组 — 经营核心层（8 项）：**
+
+- P0 客户数
+- 跟进中销售机会数
+- 已签约执行项目数
+- 有风险项目数
+- 本月收入
+- 本月净利
+- 即将上线产品版本数
+- 已签约未执行金额
+
+**第二组 — 财务分层（6 项）：**
+
+- 已签约合同总额
+- 合同流程中金额
+- 年度累计确收
+- Q2 累计确收
+- 年度累计毛利
+- Q2 累计毛利
+
+> 以上指标由后端在 `/api/bootstrap` 中聚合计算（年度=2026年1-6月，Q2=2026年4-6月）。金钱单位统一为万元。
+
+#### 3.1.2 财务趋势图
+
+- 首页展示收入/成本月度折线图（Chart.js，固定高度 140px）。
+- 财务 Tab 独立展示 4 条曲线（收入/毛利/成本/净利）。
+
+#### 3.1.3 风险提醒与近期动态
+
+- 风险提醒：从运营项目提取 next_action 非空的项目，最多展示 5 条。
+- 近期动态：最近 8 条跟进记录时间线。
+
+---
+
+### 3.2 重点项目 Tab
+
+> **v2.0 核心模块**，合并 v1.0 的「销售管理」和「运营管理」两个 Tab。
+
+#### 3.2.1 项目列表
+
+| 列 | 说明 |
+|----|------|
+| 项目 | 项目名称 |
+| 项目说明 | customer_need 或 notes 字段 |
+| 当前阶段 | 6 阶段之一（badge 样式） |
+| 项目金额 | expected_contract_amount（万元） |
+| 负责人 | owner |
+| 进展 | 「查看」按钮，点击进入任务清单页 |
+
+- 右上角「新增项目」按钮，点击展开创建表单。
+- 表单字段：项目名称、当前阶段（下拉）、项目金额、负责人。
+- 点击表格行打开右侧抽屉（720px），展示项目详情和评论区。
+- 抽屉内新增「删除」按钮（红色，点击 confirm 确认后删除）。
+
+#### 3.2.2 项目抽屉（详情）
+
+6 个字段（失焦自动保存）：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| 项目名称 | text | project_name |
+| 当前阶段 | select | 6 阶段下拉，change 自动保存 |
+| 截止时间 | text | expected_sign_date |
+| 金额 | text | expected_contract_amount |
+| 负责人 | text | owner |
+| 项目说明 | textarea | notes（多行文本） |
+
+- 评论区保留，使用 Squire 富文本编辑器。
+
+#### 3.2.3 任务清单页（二级页面）
+
+点击「查看」进入项目任务清单页，在重点项目 Tab 内渲染：
+
+- 顶部：「← 返回项目列表」按钮（左）+ 项目名（中）+「新增任务」按钮（右）
+- 主体：按 6 阶段分组的任务卡片，空阶段自动隐藏
+- 任务行格式：`○ 任务名  任务说明  |  负责人  截止时间`
+- 卡点以红色 `⚠` 标记显示
+
+#### 3.2.4 6 阶段体系
+
+| 阶段 | 含义 |
+|------|------|
+| 商务洽谈 | 合同签订、渠道对接、接口推流等前期商务工作 |
+| 系统上线 | 系统开发、SOP 制定、脚本生产等平台搭建 |
+| 团队分工 | 人员招聘、审核人员到位等团队组建 |
+| 项目交付 | 供应商准入、拍摄制作等执行交付 |
+| 上线推广 | 项目启动上线、渠道全面推广 |
+| 结项验收 | 客户验收、尾款结算等收尾工作 |
+
+#### 3.2.5 任务编辑抽屉
+
+- 点击任务行或「新增任务」→ 右侧抽屉滑入（fixed 定位，始终可见）
+- 表单字段：任务名称、任务阶段（下拉）、负责人、截止时间、任务说明、卡点&备注
+- 新增时标题「新增任务」，编辑时「编辑任务」
+- 提交后抽屉关闭，列表刷新
+
+#### 3.2.6 数据模型
+
+**project_tasks 表：**
+
+| 字段 | 说明 |
+|------|------|
+| id | 主键 |
+| project_id | 关联 operation_projects.id |
+| phase | 阶段（商务洽谈/系统上线/团队分工/项目交付/上线推广/结项验收） |
+| milestone | 里程碑 |
+| task | 任务名称 |
+| owner | 负责人 |
+| due_date | 截止时间 |
+| blockers | 卡点&备注 |
+| notes | 任务说明 |
+| created_at / updated_at | 时间戳 |
+
+---
+
+### 3.3 业务方案 Tab
+
+与 v1.0 保持一致：
+
+- 表格：客户/项目名称、版本号、状态、文件数
+- 抽屉：属性（可编辑）+ 4 组文件（方案/成本/SOP/财务流程）
+- 文件支持上传、预览、下载、删除
+- 评论区支持 Squire 富文本
+
+---
+
+### 3.4 产品研发 Tab
+
+与 v1.0 保持一致，增加平台分类：
+
+- 表格：产品名称、版本号、版本目标、核心功能、平台、上线日期、状态
+- 抽屉：可编辑版本详情 + 评论区
+- 平台字段：下拉选择（真研平台/科普平台/关爱平台）
+
+---
+
+### 3.5 财务管理 Tab
+
+与 v1.0 保持一致：
+
+- 趋势图：收入/毛利/成本/净利 4 条月度曲线（Chart.js）
+- 明细表：支持录入/编辑收入、成本/费用明细
+- 月份格式 YYYY-MM
+- 净利 = 收入 - 成本/费用
+
+---
+
+## 4. 数据对象
+
+### 4.1 SalesLead（销售线索）
+
+仍保留数据库表和 API，但前端不再有独立 Tab。通过重点项目页可间接查看。
+
+### 4.2 OperationProject（运营项目）
+
+- id, project_name, project_version
+- project_type（opportunity / execution，现主要用于区分链路，前端不做筛选）
+- current_stage（6 阶段之一）
+- owner, expected_contract_amount, expected_sign_date
+- customer_need, notes
+- project_status（保留兼容，不作为主要显示字段）
+- created_at, updated_at
+
+### 4.3 ProjectTask（项目任务）—— v2.0 新增
+
+- id, project_id
+- phase, milestone, task
+- owner, due_date
+- blockers, notes
+- created_at, updated_at
+
+### 4.4 其他数据对象
+
+BusinessProposal、ProductVersion、FinanceRecord、FileAsset、FollowUpRecord 与 v1.0 一致，详见 `OPC管理系统PRD-V1.0.md` 第 5 章。
+
+---
+
+## 5. 页面与交互规范
+
+### 5.1 通用能力
+
+- 所有列表支持新增（内联表单或右上角按钮）。
+- 项目详情通过 720px 右侧抽屉展示和编辑。
+- 任务清单在 Tab 内作为二级页面渲染，不弹出独立窗口。
+- 任务编辑通过右侧抽屉（420px，fixed 定位）。
+- 字段失焦自动保存（input/textarea → blur；select → change）。
+- 评论区使用 Squire 富文本，支持 HTML 格式。
+- 点击表格行打开抽屉，不需要单独的「详情」按钮。
+
+### 5.2 抽屉交互
+
+- 项目抽屉宽度 720px，任务抽屉宽度 420px。
+- 字段默认透明背景、hover 显示边框、focus 蓝色边框。
+- 字段失焦/选择自动保存，保存状态有视觉反馈。
+- 抽屉右上角关闭按钮关闭，项目抽屉额外有「删除」按钮。
+- 评论提交后抽屉保持打开。
+
+### 5.3 任务清单页交互
+
+- 进入：点击项目行的「查看」按钮 → state.projectView = projectId → 刷新 Tab 内容。
+- 退出：点击「返回项目列表」→ state.projectView = null → 回到列表。
+- 工具栏与下方卡片使用相同的 20px 左右内边距（px-5）。
+- 空阶段分组不渲染（直接跳过）。
+- 点击任务行打开编辑抽屉；点击「新增任务」打开空白新增抽屉。
+- Lucide 图标在每次渲染后调用 `createIcons()` 刷新。
+
+### 5.4 评论区
+
+与 v1.0 一致，详见 `OPC管理系统PRD-V1.0.md` 第 6.4 节。
+
+---
+
+## 6. 技术栈与实现约束
+
+与 v1.0 一致，核心为：
+
+- **前端**：Jinja2 + Tailwind CSS CDN + Vanilla JS + Chart.js + Lucide + Squire
+- **后端**：Flask + sqlite3（无 ORM）+ SQLite
+- **单服务**：Flask dev server, 端口 5177
+- **不提交** `data/opc.sqlite`
+
+详见 `OPC管理系统PRD-V1.0.md` 第 7 章。
+
+**v2.0 新增数据表**：`project_tasks`。
+
+---
+
+## 7. 首页指标要求
+
+v2.0 首页展示 14 项关键指标（两组 4 列网格）：
+
+**经营核心层：**
+- P0 客户数、跟进中销售机会数、已签约执行项目数、有风险项目数
+- 本月收入、本月净利、即将上线产品版本数、已签约未执行金额
+
+**财务分层：**
+- 已签约合同总额、合同流程中金额
+- 年度累计确收、Q2 累计确收
+- 年度累计毛利、Q2 累计毛利
+
+---
+
+## 8. 验收标准
+
+### 首页
+
+- 展示 14 项指标（两组 4 列网格）。
+- 展示财务趋势图、风险提醒和近期动态。
+- 点击指标可跳转到对应 Tab。
+
+### 重点项目
+
+- 项目列表 6 列展示（项目/说明/阶段/金额/负责人/进展）。
+- 右上角「新增项目」展开表单。
+- 点击行打开抽屉（6 字段 + 评论 + 删除按钮）。
+- 点击「查看」进入二级任务清单页。
+- 任务清单按 6 阶段分组，空阶段隐藏。
+- 任务行显示任务名、说明、负责人、截止时间、卡点。
+- 点击任务行打开右侧编辑抽屉。
+- 「新增任务」打开空白新增抽屉。
+- 「返回项目列表」回到列表页。
+- 任务保存后列表刷新、抽屉关闭。
+
+### 业务方案、产品研发、财务管理
+
+与 v1.0 验收标准一致，详见 `OPC管理系统PRD-V1.0.md` 第 11 章。
+
+---
+
+## 9. 版本历史
+
+| 版本 | 日期 | 说明 |
+|------|------|------|
+| v0.9 | 2026-05-29 | 初始 PRD，6 Tab 功能架构 |
+| v1.0 | 2026-06-01 | 匹配 v1.0.2，卡片→表格，补充技术栈与交互细节 |
+| v2.0 | 2026-06-16 | 匹配 v1.7.6，销售+运营合并为重点项目、6 阶段任务体系、二级页面、任务编辑抽屉、首页指标分层、产品平台分类 |
+
+详细修改日志见 `CHANGELOG.md`。