12 KiB
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 做了以下架构级调整：
- 合并销售 + 运营为「重点项目」：一个 Tab 管全部项目，项目表格 6 列（项目/说明/阶段/金额/负责人/进展）。
- 引入项目任务体系：每个项目内嵌 6 阶段任务清单（商务洽谈→系统上线→团队分工→项目交付→上线推广→结项验收），支持增删改。
- 任务详情改为页内二级页面：点击「查看」进入项目任务页，有返回按钮，不弹出独立窗口。
- 任务编辑改为右侧抽屉：新增/编辑任务从右侧滑入表单，不打断任务列表浏览。
- 首页指标分层：从 7 项扩展到 14 项，分为经营核心层和财务分层。
- 产品增加平台分类：真研平台/科普平台/关爱平台三种归属。
本系统将承接并合并原有独立财务 manager 能力，财务不再作为单独系统存在，而是作为 OPC 管理系统中的一个 Tab。
1.3 样板范围
v2.0 以科普（慰心斋）作为首个单项目独立版本，当前包含信达·科普无界、圆心科技科普文章等多个重点项目。
首版只做单项目、单用户版本，不做多项目、多用户、权限体系。
2. 信息架构
系统顶部为全局标题和基础操作区，主体为 5 个一级 Tab：
- 首页 — 经营总览（14 项指标 + 财务趋势 + 风险提醒 + 近期动态）
- 重点项目 — 项目列表 + 点击进入任务清单（6 阶段任务管理）
- 业务方案 — 按版本管理方案/成本/SOP/财务流程文件
- 产品研发 — 按版本管理产品目标/功能/日期（含平台分类）
- 财务管理 — 趋势图 + 明细表（收入/成本/毛利/净利）
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。