Files

mac 7009b7fe48 v1.0.3 — CDN 脚本加 defer + preconnect 解决页面加载阻塞

2026-06-04 12:07:26 +08:00

27 KiB

Raw Permalink Blame History

OPC 管理系统 PRD

版本：v1.0 日期：2026-06-01 阶段：实际落地版（匹配 OPC-Manager v1.0.2 代码实现）定位：以科普（慰心斋）为单项目独立版本，打造 OPC 工作台，从全局首页、销售、业务、运营、产品、财务 6 个视角，直观、清晰、全面地管理业务全貌。

历史版本参见 OPC管理系统PRD-V0.9.md，修改日志见 CHANGELOG.md。

1. 背景与目标

1.1 需求原文

以慰心斋为例，打造一个 OPC 工作台，让我能够直观地看到他销售、业务、运营、产品、财务的情况。另外，之前他为自己单独打造了一个财务体系，把这个财务 manager 系统直接合并进工作台里面，不再作为一个独立的系统。

1.2 背景

当前业务信息分散在销售表、方案文件、运营记录、产品路线图、财务台账等多个位置，难以一眼判断业务进展、交付风险、产品节奏和财务结果。

OPC 管理系统用于建立一个统一工作台，让负责人可以通过全局首页和 5 个业务 Tab 完成日常管理：

全局首页：集中展示科普（慰心斋）的经营关键指标和风险提醒。
销售管理：看清目标客户、优先级、状态和多条时间线跟进记录。
业务方案：按版本管理售前/商务阶段的方案、成本、SOP、财务流程等文件。
运营管理：承接交付的实际管理形态，将项目分为业务机会项目和已签约执行项目，分别看清签约推进和 SOP 执行过程。
产品管理：按版本管理产品目标、核心功能、上线日期和版本跟进。
财务管理：用曲线图和明细表查看收入、毛利、成本/费用、净利。

本系统将承接并合并原有独立财务 manager 能力，财务不再作为单独系统存在，而是作为 OPC 管理系统中的一个 Tab。

1.3 样板范围

v1.0 以科普（慰心斋）作为首个单项目独立版本，优先接入和整理慰心斋已有资料：

销售资料：/Users/mac/天机阁/地阁/慰心斋/1、销售管理
业务方案：/Users/mac/天机阁/地阁/慰心斋/2、业务方案
运营资料：/Users/mac/天机阁/地阁/慰心斋/3、运营方案
产品资料：/Users/mac/天机阁/地阁/慰心斋/4、产品方案
财务系统：/Users/mac/天机阁/地阁/慰心斋/5、财务管理/mananger

首版只做单项目、单用户版本，不做多项目、多用户、权限体系。系统形态应保留后续复制到其他业务单元或升级为多项目/多用户的扩展能力，但首版数据、页面样例和迁移逻辑以科普（慰心斋）为准。

2. 用户与使用场景

2.1 核心用户

业务负责人：查看全局进展，识别销售、运营、产品、财务风险。
销售负责人：维护目标客户和跟进记录。
项目/运营负责人：维护业务机会推进、已签约项目 SOP 执行、交付文件和项目进展。
产品负责人：维护版本规划、上线日期和功能清单。
财务负责人：维护收入、成本/费用、毛利、净利明细。

2.2 高频场景

每周例会前，先通过全局首页查看销售 pipeline、项目运营状态、产品版本进度、财务结果和风险提醒。
新增客户后，录入客户优先级、当前状态和跟进记录。
一个业务方案形成新版本后，上传方案、成本、SOP、财务流程文件。
项目处于机会阶段时，在运营 Tab 中跟进签约推进；项目签约后，在运营 Tab 中按 SOP 跟进执行过程和交付文件。
产品版本推进时，维护版本目标、核心功能、上线日期和跟进记录。
财务复盘时，查看收入、毛利、成本/费用、净利月度趋势和明细。

3. 信息架构

系统顶部为全局标题和基础操作区，主体为 6 个一级 Tab：

首页
销售管理
业务方案
运营
产品
财务

所有 Tab 均支持基础的新增、查看、编辑能力。删除能力作为后台管理能力保留，默认不突出展示，避免误删关键业务数据。

4. 功能需求

4.1 首页 Tab

首页是科普（慰心斋）单项目的经营总览页，用于在进入具体 Tab 前先看到整体情况。

页面形式

首页由关键指标卡、财务趋势图、风险提醒和近期动态组成。
首页展示的是销售、业务、运营、产品、财务五个模块的聚合信息，不承载复杂编辑。

关键指标（7 项，4 列网格自动换行）

P0 客户数
跟进中销售机会数
已签约执行项目数
有风险项目数
本月收入
本月净利
即将上线产品版本数

风险提醒

预计签约时间临近但状态未推进的业务机会项目。
已签约执行项目中标记为有风险或存在阻塞的项目。
产品上线日期临近但状态未进入测试/已上线的版本。
当月净利为负或成本/费用异常升高的月份。

近期动态

最近新增的销售跟进记录。
最近更新的运营项目跟进记录。
最近上传或更新的业务方案/运营交付文件。
最近新增的财务明细。

交互要求

首页指标点击后可跳转到对应 Tab 并带入筛选条件。
首页只做查看和跳转，不在首页直接编辑业务数据。
财务趋势图容器固定高度 140px，配合 Chart.js maintainAspectRatio: false。

4.2 销售管理 Tab

页面形式

内容按表格形式展示。
表格字段：
- 目标客户
- 优先级
- 状态
- 最新跟进记录

交互要求

用户可以新增销售线索/目标客户。
用户点击表格中的某一行后，以抽屉形式打开详情（720px 宽）。
抽屉内详情字段：
- 目标客户
- 优先级（下拉选择）
- 状态（下拉选择）
字段失焦自动保存，不需要保存按钮。
抽屉右上角关闭按钮关闭。
跟进记录必须是多条时间线记录，不使用单一文本字段。
用户可以在详情中通过 Squire 富文本编辑器新增评论，支持删除已有评论。

跟进时间线字段

跟进时间
跟进人
跟进方式
跟进内容
下一步动作
下次跟进时间

4.3 业务方案 Tab

v1.0 变更：从 v0.9 的"一个版本一个卡片"改为表格布局，保持与销售、运营一致的交互模式。

页面形式

按表格形式展示。
表格字段：
- 客户/项目名称
- 版本号
- 状态
- 文件数

每个版本包含 4 个文件要素

方案
成本
SOP
财务流程

文件规则

一个要素对应一个文件分组。
每个文件分组允许上传多个文件。
文件类型不限于：Word、Excel、PPT、PDF、图片、压缩包。

交互要求

用户可以新增一个业务方案版本。
用户点击表格行后，以抽屉形式展开（720px 宽）。
抽屉内展示两大部分：
1. 属性区：客户/项目名称、版本号、版本说明、创建日期、状态（均可编辑，失焦自动保存）
2. 方案文件区：按方案/成本/SOP/财务流程 4 个分组展示，每组支持上传、预览、下载、删除文件
用户可以查看每个要素下已上传的文件列表。
用户可以替换、追加或删除文件。
用户可以在线预览已上传文件。PDF 和图片优先支持浏览器内预览；Word、Excel、PPT 提供下载。
用户可编辑版本基础信息：客户/项目名称、版本号、版本说明、创建日期、当前状态。
抽屉内支持 Squire 富文本评论，评论支持删除。

4.4 运营 Tab

运营是项目从机会推进到签约交付的实际承载形式。系统不单独设置"交付 Tab"，交付过程、交付文件、项目执行状态统一归入运营 Tab 管理。

运营项目分为两类：

业务机会项目：尚未签约，以推动签约为核心目标，重点展示客户意向、签约推进状态、下一步动作和跟进记录。
已签约执行项目：已经签约，以按 SOP 交付为核心目标，重点展示 SOP 阶段、执行进度、交付物、风险和跟进记录。

首批运营文件来源：/Users/mac/天机阁/地阁/慰心斋/3、运营方案。当前已存在的文件按版本要求补充到对应运营项目，不建立"未归类文件池"。

页面形式

按表格形式展示。
表格顶部提供项目类型筛选按钮（三选一）：
- 全部项目
- 业务机会项目
- 已签约执行项目
表格字段：
- 项目名称（含版本号）
- 项目类型
- 项目状态
- 当前阶段
- 交付文件数
- 最新跟进

交互要求

用户可以新增运营项目。
新增项目时必须选择项目类型：业务机会项目或已签约执行项目。
用户点击表格行后，以抽屉形式展开（720px 宽）。
抽屉内展示所有字段（失焦自动保存）：
- 项目名称
- 项目版本
- 项目状态
- 当前阶段
- 目标客户
- 客户需求
- 预计签约金额
- 预计签约时间
- 签约概率
- SOP 阶段
- 执行进度
- 当前交付物
- 风险与阻塞
- 下一步动作
抽屉内支持 Squire 富文本评论，评论支持删除。
运营文件必须先归属到明确项目版本，再根据该版本要求补充文件。
已放入运营管理文件夹的文件，需要作为对应项目版本的初始文件导入或索引到运营 Tab。

业务机会项目 vs 已签约执行项目

两种项目类型共用同一个抽屉和数据模型，根据 project_type 字段区分：

当 project_type = opportunity 时，优先关注：目标客户、客户需求、预计签约金额、预计签约时间、签约概率、下一步动作。
当 project_type = execution 时，优先关注：SOP 阶段、执行进度、当前交付物、风险。

业务机会项目推荐状态

线索发现
需求沟通
方案准备
方案已提交
商务谈判
待签约
已签约
暂缓
已丢单

已签约执行项目推荐状态

未启动
SOP 执行中
有风险
待客户确认
已完成
已归档

SOP 阶段建议

项目启动
需求确认
方案确认
内容生产
审核确认
渠道分发
数据/效果回收
复盘验收

4.5 产品 Tab

v1.0 变更：从 v0.9 的"一个版本一个卡片"改为表格布局，保持与销售、业务方案、运营一致的交互模式。

页面形式

按表格形式展示。
表格字段：
- 产品名称
- 版本号
- 版本目标
- 核心功能
- 上线日期
- 状态

交互要求

用户可以新增产品版本。
用户点击表格行后，以抽屉形式展开（720px 宽）。
抽屉内展示版本详情（失焦自动保存）：
- 产品名称
- 版本号
- 版本目标
- 核心功能清单
- 上线日期
- 当前状态
- 备注
抽屉内支持 Squire 富文本评论，评论支持删除。

4.6 财务 Tab

页面结构

财务 Tab 分为趋势图区域和明细区域。

趋势图

需要展示 4 条月度曲线：

收入按月份的曲线图
毛利按月份的曲线图
成本/费用按月份的曲线图
净利按月份的曲线图

明细表

每个指标需要对应明细：

收入明细
毛利明细
成本/费用明细
净利明细

明细字段

收入明细：

月份
客户/项目
收入类型
金额
确认日期
备注

成本/费用明细：

月份
客户/项目
类型
金额
发生日期
备注

净利明细：

月份
收入合计
成本/费用合计
毛利
净利

5. 数据对象

5.1 SalesLead 销售线索

id
target_customer
priority
status
latest_follow_up_record
created_at
updated_at

5.2 FollowUpRecord 跟进时间线记录

id
target_type（sales / operation / product）
target_id
followed_at
follower
follow_up_method
content（HTML 格式，Squire 生成）
next_action
next_follow_up_at
created_at
updated_at

5.3 BusinessProposal 业务方案版本

id
customer_or_project_name
version
description
status
created_date
created_at
updated_at

文件通过 FileAsset 关联（module = "proposal"），按 file_category 分组：

方案
成本
SOP
财务流程

5.4 OperationProject 运营项目

id
project_name
project_version
project_type（opportunity / execution）
project_status
current_stage
owner
start_date
end_date
target_customer
customer_need
expected_contract_amount
expected_sign_date
sign_probability
next_action
related_business_proposal_id
sop_file_id
sop_stage
execution_progress
current_deliverable
risks
notes
created_at
updated_at

5.5 ProductVersion 产品版本

id
product_name
version
version_goal
feature_list
launch_date
status
notes
created_at
updated_at

5.6 FinanceRecord 财务记录

id
month（YYYY-MM 格式）
project_name
record_type（revenue / cost_expense）
category
amount
occurred_date
notes
created_at
updated_at

5.7 FileAsset 文件资产

id
module（proposal / operation）
owner_id
owner_version
file_category
file_name
file_type
file_size
file_path
is_external（1=原始索引文件，0=本地上传文件）
notes
created_at
updated_at

5.8 AppScope 系统范围

project_name：科普（慰心斋）
user_mode：single_user
project_mode：single_project
multi_user_enabled：false
multi_project_enabled：false

6. 页面与交互规范

6.1 通用能力

所有列表支持新增（内联表单置顶）。
所有详情通过抽屉展示和编辑。
所有日期字段使用文本输入。
所有状态字段使用下拉选择。
跟进记录统一使用多条时间线记录，Squire 富文本编辑器支持 HTML 格式。
字段失焦自动保存，保存状态有视觉反馈（保存中…/已保存/保存失败）。
点击表格行打开抽屉，不需要单独的"详情"按钮。
保存后列表与详情数据同步更新（自动触发全量 re-render）。

6.2 抽屉交互

所有 Tab 的详情均使用右侧抽屉。

抽屉固定宽度 720px，Plane 风格紧凑布局。
字段使用 drawer-value 样式：默认透明背景、hover 显示边框、focus 蓝色边框。
字段失焦自动保存，不需要保存按钮。
抽屉右上角关闭按钮关闭。
已删除"点击抽屉外区域自动关闭抽屉"的交互。
抽屉内支持评论区（Squire 富文本编辑器）。
评论提交后抽屉保持打开，触发数据刷新。

6.3 文件上传

业务方案 Tab 和运营 Tab 支持文件上传与在线预览。

上传文件必须归属于某个方案版本和某个要素。
上传后展示文件名、类型、大小、上传时间。
文件支持下载（Content-Disposition: attachment）。
文件支持在线预览（Content-Disposition: inline）。PDF 和图片优先使用浏览器内预览；Word、Excel、PPT 提供下载。
运营文件必须先归属到明确项目版本，再按该版本要求补充对应文件。
外部索引文件（慰心斋原始文件）通过 is_external=1 标记，不重复存储。

6.4 评论区

使用 Squire RTE（Fastmail）作为富文本编辑器。
支持格式：加粗、斜体、下划线、删除线、无序列表、有序列表、引用、撤销、重做。
工具栏按钮使用 onmousedown 事件，防止点击按钮时编辑器失焦。
评论 HTML 用 encodeURIComponent 存入 data-html 属性，渲染时 decodeURIComponent 解析到 .rich-content 容器。
评论内容区通过 .rich-content ul/ol { list-style: revert; } 覆盖 Tailwind CSS reset，确保列表编号/圆点正常显示。
所有评论记录均有删除图标（hover 时显示），点击后弹窗确认删除。

7. 技术栈与实现约束

7.1 前端技术栈

OPC 工作台前端采用：

Jinja2：服务端渲染单一页面模板（templates/index.html）。
Tailwind CSS CDN：样式系统、布局、间距、颜色和响应式规则，不使用 Vite 构建链。
原生 JavaScript（static/app.js，约 465 行）：Tab 切换、抽屉详情、表单提交、文件上传、数据刷新、自动保存。
自定义 CSS（static/styles.css，约 492 行）：Drawer 样式、Squire 编辑器样式、表格行 hover、状态 badge、评论区、活动时间线。
Chart.js CDN 4.4.8（chart.js）：财务趋势折线图（首页 + 财务 Tab 各一个），配置 maintainAspectRatio: false + 固定容器高度。
Lucide（unpkg CDN）：线性图标库，用于导航、操作按钮、文件预览/下载、属性标签等，尺寸 16px。
Squire RTE CDN v1（build/squire-raw.js）：富文本评论编辑器，支持 HTML 格式。

7.2 后端技术栈

OPC 工作台后端采用：

Flask 3.1.3：页面渲染（Jinja2 模板）、REST API、文件上传、文件访问、在线预览入口和静态资源服务。
sqlite3（Python 标准库，无 ORM）：SQLite 数据读写。
Flask development server：本地单用户运行，端口 5177，debug 模式。

7.3 数据库与存储

首版数据库采用 SQLite。

主数据库文件：data/opc.sqlite（已在 .gitignore 中排除）。
原财务 manager 的 SQLite 数据需要迁移或合并到 OPC 主数据库，不再作为独立系统运行。
SQLite 中存储销售、跟进时间线、业务方案版本、运营项目、文件元数据、产品版本、财务记录等结构化数据。
上传文件本体存储在本地文件系统（data/uploads/），不直接写入 SQLite。
外部引用文件（慰心斋原始文件）通过 file_assets 表的 is_external 字段标记，路径指向原始文件位置。
SQLite 仅保存文件元数据，包括文件名、类型、大小、所属模块、所属项目/版本、文件路径、上传时间。
后端提供文件下载和在线预览访问 URL（/api/files/<id>/content?inline=true|false）。

7.4 财务 manager 合并策略

原财务 manager 系统位于 /Users/mac/天机阁/地阁/慰心斋/5、财务管理/mananger。

合并要求：

不保留原财务 manager 作为独立入口。
复用或迁移原财务数据结构中的客户、回款、成本、文件索引等有价值数据。
将原财务 manager 的财务能力合并到 OPC 的财务 Tab。
财务数据最终统一进入 OPC 主数据库。
如存在字段差异，以 OPC v1.0 的 FinanceRecord 和财务口径为准。

7.5 API 设计原则

API 采用 REST 风格。
/api/bootstrap：一次性加载所有模块数据 + 首页聚合指标 + 财务月度汇总。
所有业务对象提供基础 CRUD 接口（/api/<resource> + /api/<resource>/<id>）。
文件上传接口通过 FormData 接收 file + module + owner_id + owner_version + file_category。
财务汇总接口由后端根据明细计算收入、毛利、成本/费用、净利月度数据。
首页指标接口由后端聚合销售、运营、产品、财务数据生成。
/api/followups/<target_type>/<target_id>：新增评论。
/api/followups/<id>：删除评论。
首版不做登录、鉴权、多用户权限和租户隔离。

7.6 项目结构

OPC-Manager/
├── backend/
│   ├── flask_app.py      # Flask 主应用（~480 行）
│   └── requirements.txt
├── templates/
│   └── index.html        # Jinja2 页面模板
├── static/
│   ├── app.js            # 原生 JS 页面交互（~465 行）
│   └── styles.css        # 自定义样式（~492 行）
├── data/
│   ├── opc.sqlite        # SQLite 数据库（gitignore）
│   └── uploads/          # 上传文件目录（gitignore）
├── docs/
│   ├── design-system-summary.md
│   └── frontend-design-checklist.md
├── scripts/
│   └── deploy.sh         # 标准部署脚本
├── VERSION_LOG.md        # 版本发布日志
└── README.md

7.7 开发约束

不使用 Ant Design、React、Vite、shadcn/ui 等重型框架。
不新增多套 UI 组件体系。
Tailwind CSS CDN 承接设计系统中的颜色、间距、字号、圆角、阴影和状态表达。
不使用 PostgreSQL、MySQL 等独立数据库服务。
不修改 AiMaMi 本地代理配置。
不使用 destructive git 命令。
不提交 data/opc.sqlite 到仓库。
修改代码后必须运行：node --check static/app.js + curl /api/health。
服务启动前先清理 5177 端口占用。

8. 设计规范

8.1 设计目标

OPC 工作台采用企业级经营管理后台风格，重点是清晰、稳定、可扫描、适合会议复盘。不做营销页风格，不使用过度装饰、强动效或大面积渐变。

8.2 视觉规范

要素	规范
主色	`#2563eb` (blue-600) / `#1d4ed8` (blue-700)
背景	`bg-slate-50` 浅灰
卡片/表格底色	`white` + `border-slate-200` 细边框
风险状态	红 `#fef2f2` / `#b91c1c`
待处理状态	琥珀 `#fffbeb` / `#b45309`
完成状态	绿 `#ecfdf5` / `#047857`
信息状态	蓝 `#eff6ff` / `#1d4ed8`
归档/默认	灰 `#f1f5f9` / `#475569`
圆角	表格 8px，按钮 6px，badge 全圆
表格行 hover	`#f1f5f9` 浅灰背景
字段编辑态	透明→hover 浅灰→focus 蓝边框

8.3 组件风格要求

销售管理：表格 + 状态标签 + 抽屉详情。
业务方案：表格 + 状态标签 + 文件分组（抽屉内 4 组文件上传/预览/下载）。
运营：表格 + 项目类型筛选 + 抽屉详情。
产品：表格 + 状态标签 + 抽屉详情。
财务：月度趋势折线图 + 明细表。

8.4 设计辅助工具（已使用）

v1.0 开发前使用了以下设计辅助工具：

ui-ux-pro-max-skill：生成设计系统摘要（docs/design-system-summary.md），定义色彩、布局、组件规则。
frontend-design：生成页面级 UI 落地清单（docs/frontend-design-checklist.md），定义各页面的检查要点和 Post-Development Audit 标准。

实际落地采用 Flask + Jinja2 + Tailwind CSS CDN + Lucide + Chart.js + 原生 JavaScript + SQLite 技术栈，设计规范作为指导但以代码实现为准。

9. 首页指标要求

v1.0 首页展示 7 项关键指标（4 列网格自动换行）：

P0 客户数
跟进中销售机会数
已签约执行项目数
有风险项目数
本月收入
本月净利
即将上线产品版本数

首页作为默认进入页，点击指标可跳转到对应 Tab。

10. 非功能需求

数据应持久化保存，刷新页面不丢失。
财务数据计算结果应与明细一致。
文件上传后应可追溯到对应业务方案版本。
运营文件上传后应可追溯到对应项目版本。
页面应支持桌面端优先使用（最小宽度 1180px）。
表格内容应清晰紧凑，适合会议和经营复盘场景。
系统应保留后续复用到其他业务单元的扩展能力。
前端实现必须符合 Jinja2 + Tailwind CSS CDN + Lucide + Chart.js + Squire + 原生 JavaScript 技术栈约束。
后端实现必须符合 Flask + sqlite3 + SQLite 技术栈约束。
上传文件必须采用本地文件系统存储，SQLite 存储文件元数据。
首版为单用户、单项目版本，项目名称为科普（慰心斋）。

11. 验收标准

首页

默认进入系统后展示全局首页。
首页展示 7 项关键指标（4 列网格）。
首页展示财务趋势图、风险提醒和近期动态。
点击首页指标可以跳转到对应 Tab。

销售管理

可以新增销售客户。
可以在表格中看到目标客户、优先级、状态、最新跟进记录。
点击行后可以打开抽屉查看和编辑详情（失焦自动保存）。
销售跟进记录以多条时间线形式展示，支持 Squire 富文本评论和删除。

业务方案

可以新增方案版本。
点击行后打开抽屉，展示属性和 4 个文件分组（方案/成本/SOP/财务流程）。
每个分组可以上传多个文件。
上传后文件能够在线预览和下载。
抽屉内支持评论。

运营

可以新增运营项目。
可以将运营项目分为业务机会项目和已签约执行项目。
可以在表格中看到项目名称、类型、状态、当前阶段、文件数、最新跟进。
顶部提供项目类型筛选按钮（全部/业务机会/已签约执行）。
点击项目后可以用抽屉查看和编辑详情。
抽屉内支持评论。

产品

可以新增产品版本。
表格展示产品名称、版本号、版本目标、核心功能、上线日期、状态。
点击行后可以用抽屉查看和编辑版本详情。
抽屉内支持评论。

财务

可以录入收入、成本/费用明细。
系统按月份展示收入、毛利、成本/费用、净利曲线（首页 + 财务 Tab 各一个）。
系统可以展示对应明细。
月份按自然月统计，格式为 YYYY-MM。
成本和费用统一作为成本/费用录入，再通过类型区分。
净利 = 收入 - 成本/费用。

UI/UX

前端页面基于 Jinja2 + Tailwind CSS CDN + 原生 JavaScript 实现。
图标库基于 Lucide 浏览器版实现。
富文本评论基于 Squire RTE 实现。
财务趋势图基于 Chart.js 实现。
页面符合企业级经营管理后台风格，信息清晰、表格紧凑、状态可扫描。
销售、运营、产品、业务方案详情通过 720px 抽屉承载。
字段失焦自动保存，有状态反馈。
财务图表与明细表可对应核对。

后端与数据

后端基于 Flask 实现页面渲染、REST API 和文件服务。
数据读写基于 sqlite3 实现。
数据持久化使用 SQLite，主数据库为 OPC 主库。
原财务 manager 不再作为独立系统运行，其能力合并进 OPC 财务 Tab。
文件本体存储在本地 uploads 目录，SQLite 存储文件元数据。
后端提供文件上传、下载和在线预览访问入口。
首页指标和财务月度曲线由后端基于明细数据计算生成。

12. 版本历史

版本	日期	阶段	说明
v0.9	2026-05-29	需求核对稿	初始 PRD，定义 6 Tab 功能架构、数据模型、技术选型
v1.0	2026-06-01	实际落地版	匹配 OPC-Manager v1.0.2 代码实现，修正业务方案/产品从卡片改表格，补充 Squire 编辑器、抽屉交互等实际落地细节

详细修改日志见 CHANGELOG.md。

27 KiB Raw Permalink Blame History Unescape Escape

OPC 管理系统 PRD

1. 背景与目标

1.1 需求原文

1.2 背景

1.3 样板范围

2. 用户与使用场景

2.1 核心用户

2.2 高频场景

3. 信息架构

4. 功能需求

4.1 首页 Tab

页面形式

关键指标（7 项，4 列网格自动换行）

风险提醒

近期动态

交互要求

4.2 销售管理 Tab

页面形式

交互要求

跟进时间线字段

推荐状态字段

推荐优先级字段

4.3 业务方案 Tab

页面形式

每个版本包含 4 个文件要素

文件规则

交互要求

推荐版本状态

4.4 运营 Tab

页面形式

交互要求

业务机会项目 vs 已签约执行项目

推荐项目类型

业务机会项目推荐状态

已签约执行项目推荐状态

SOP 阶段建议

4.5 产品 Tab

页面形式

交互要求

推荐版本状态

4.6 财务 Tab

页面结构

趋势图

明细表

推荐财务口径

明细字段

5. 数据对象

5.1 SalesLead 销售线索

5.2 FollowUpRecord 跟进时间线记录

5.3 BusinessProposal 业务方案版本

5.4 OperationProject 运营项目

5.5 ProductVersion 产品版本

5.6 FinanceRecord 财务记录

5.7 FileAsset 文件资产

5.8 AppScope 系统范围

6. 页面与交互规范

6.1 通用能力

6.2 抽屉交互

6.3 文件上传

6.4 评论区

7. 技术栈与实现约束

7.1 前端技术栈

7.2 后端技术栈

7.3 数据库与存储

7.4 财务 manager 合并策略

7.5 API 设计原则

7.6 项目结构

7.7 开发约束

8. 设计规范

8.1 设计目标

8.2 视觉规范

8.3 组件风格要求

8.4 设计辅助工具（已使用）

9. 首页指标要求

10. 非功能需求

11. 验收标准

首页

销售管理

业务方案

27 KiB

Raw Permalink Blame History