Compare commits
37 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
4911f24d40 | ||
|
|
8c24abd53e | ||
|
|
0a7f70757d | ||
|
|
29dc7e040e | ||
|
|
c8387011cc | ||
|
|
5061de70f8 | ||
|
|
ea3ba25da5 | ||
|
|
bd7125fab8 | ||
|
|
94dd1fe677 | ||
|
|
fa6c9b1711 | ||
|
|
f4eacfafe2 | ||
|
|
f8c816dc38 | ||
|
|
e2d9049e45 | ||
|
|
1b0049e342 | ||
|
|
87a5d4f81d | ||
|
|
d6ec7b24ec | ||
|
|
194c91cf25 | ||
|
|
68797e4fb5 | ||
|
|
af4ae1cbc3 | ||
|
|
c42abb05da | ||
|
|
4d1dc3b355 | ||
|
|
60bae583b2 | ||
|
|
c68fcaadcc | ||
|
|
2c199aae76 | ||
|
|
be6a7f5c38 | ||
|
|
6adc00a8a7 | ||
|
|
c4aacd5096 | ||
|
|
4f7db75a7f | ||
|
|
9707009895 | ||
|
|
6defe95a3f | ||
|
|
a1b154abd7 | ||
|
|
fc0ee66064 | ||
|
|
5af58c8faa | ||
|
|
b682427ea0 | ||
|
|
ec83bb5e22 | ||
|
|
921afd198b | ||
|
|
850ad340e5 |
@@ -316,13 +316,33 @@ def attach_common(conn, resource, items):
|
|||||||
return items
|
return items
|
||||||
|
|
||||||
|
|
||||||
def monthly_finance(conn):
|
def monthly_finance(conn, tenant="科普·无界"):
|
||||||
|
from datetime import date
|
||||||
|
today = date.today()
|
||||||
|
# 6 months: 3 before + current + 2 after
|
||||||
|
from dateutil.relativedelta import relativedelta
|
||||||
|
start = today + relativedelta(months=-3)
|
||||||
|
months = []
|
||||||
|
for i in range(6):
|
||||||
|
m = start + relativedelta(months=i)
|
||||||
|
months.append(m.strftime("%Y-%m"))
|
||||||
data = []
|
data = []
|
||||||
for item in rows(conn, "SELECT DISTINCT month FROM finance_records ORDER BY month"):
|
for month in months:
|
||||||
month = item["month"]
|
col_month = month.replace("-", "_")
|
||||||
revenue = one(conn, "SELECT COALESCE(SUM(amount),0) AS v FROM finance_records WHERE month=? AND record_type='revenue'", (month,))["v"]
|
col_rev = f"rev_{col_month}"
|
||||||
cost = one(conn, "SELECT COALESCE(SUM(amount),0) AS v FROM finance_records WHERE month=? AND record_type='cost_expense'", (month,))["v"]
|
col_gross = f"gross_{col_month}"
|
||||||
data.append({"month": month, "revenue": revenue, "gross_profit": revenue - cost, "cost_expense": cost, "net_profit": revenue - cost})
|
# Only project_finances has columns for 2026-06 through 2026-09
|
||||||
|
if month in ["2026-06", "2026-07", "2026-08", "2026-09"]:
|
||||||
|
revenue = one(conn, f"SELECT COALESCE(SUM({col_rev}),0) AS v FROM project_finances WHERE tenant=?", (tenant,))["v"]
|
||||||
|
gross = one(conn, f"SELECT COALESCE(SUM({col_gross}),0) AS v FROM project_finances WHERE tenant=?", (tenant,))["v"]
|
||||||
|
else:
|
||||||
|
revenue = 0
|
||||||
|
gross = 0
|
||||||
|
data.append({
|
||||||
|
"month": month, "revenue": revenue,
|
||||||
|
"labor": 0, "expense": 0, "purchase": 0,
|
||||||
|
"net_profit": gross,
|
||||||
|
})
|
||||||
return data
|
return data
|
||||||
|
|
||||||
|
|
||||||
@@ -333,27 +353,41 @@ def index():
|
|||||||
|
|
||||||
@app.route("/api/bootstrap")
|
@app.route("/api/bootstrap")
|
||||||
def bootstrap():
|
def bootstrap():
|
||||||
|
tenant = request.args.get("tenant", "科普·无界")
|
||||||
conn = db()
|
conn = db()
|
||||||
try:
|
try:
|
||||||
sales = attach_common(conn, "sales", rows(conn, "SELECT * FROM sales_leads ORDER BY id DESC"))
|
def q(sql, *args):
|
||||||
proposals = attach_common(conn, "proposals", rows(conn, "SELECT * FROM business_proposals ORDER BY id DESC"))
|
return rows(conn, sql, args)
|
||||||
operations = attach_common(conn, "operations", rows(conn, "SELECT * FROM operation_projects ORDER BY id DESC"))
|
sales = attach_common(conn, "sales", q("SELECT * FROM sales_leads WHERE tenant=? ORDER BY id DESC", tenant))
|
||||||
products = attach_common(conn, "products", rows(conn, "SELECT * FROM product_versions ORDER BY id DESC"))
|
proposals = attach_common(conn, "proposals", q("SELECT * FROM business_proposals WHERE tenant=? ORDER BY id DESC", tenant))
|
||||||
finance = rows(conn, "SELECT * FROM finance_records ORDER BY month DESC, id DESC")
|
operations = attach_common(conn, "operations", q("SELECT * FROM operation_projects WHERE tenant=? ORDER BY id DESC", tenant))
|
||||||
|
products = attach_common(conn, "products", q("SELECT * FROM product_versions WHERE tenant=? ORDER BY id DESC", tenant))
|
||||||
|
finance = q("SELECT * FROM finance_records WHERE tenant=? ORDER BY month DESC, id DESC", tenant)
|
||||||
|
tasks = q("SELECT * FROM project_tasks WHERE tenant=? ORDER BY phase, sort_order, id", tenant)
|
||||||
|
pfs = q("SELECT * FROM project_finances WHERE tenant=? ORDER BY id DESC", tenant)
|
||||||
current_month = "2026-06"
|
current_month = "2026-06"
|
||||||
# Finance aggregates
|
# Finance aggregates — from project_finances (project-based)
|
||||||
def sum_finance(months, rtype):
|
def pf_sum(field):
|
||||||
return sum(x["amount"] for x in finance if x["month"] in months and x["record_type"] == rtype)
|
return sum(x[field] or 0 for x in pfs)
|
||||||
months_2026 = [f"2026-{m:02d}" for m in range(1,7)]
|
rev_month = pf_sum("rev_2026_06")
|
||||||
months_q2 = ["2026-04","2026-05","2026-06"]
|
gross_month = pf_sum("gross_2026_06")
|
||||||
revenue_annual = sum_finance(months_2026, "revenue")
|
rev_q2 = pf_sum("rev_2026_06")
|
||||||
cost_annual = sum_finance(months_2026, "cost_expense")
|
gross_q2 = pf_sum("gross_2026_06")
|
||||||
revenue_q2 = sum_finance(months_q2, "revenue")
|
rev_annual = rev_q2
|
||||||
cost_q2 = sum_finance(months_q2, "cost_expense")
|
gross_annual = gross_q2
|
||||||
revenue_month = sum_finance([current_month], "revenue")
|
# Contract aggregates — time-based
|
||||||
cost_month = sum_finance([current_month], "cost_expense")
|
|
||||||
# Contract aggregates
|
|
||||||
signed_amount = sum(x["expected_contract_amount"] or 0 for x in operations if x["project_status"] == "已签约")
|
signed_amount = sum(x["expected_contract_amount"] or 0 for x in operations if x["project_status"] == "已签约")
|
||||||
|
from datetime import date
|
||||||
|
today = date.today()
|
||||||
|
def contract_in_period(op, start, end):
|
||||||
|
if op["project_status"] != "已签约": return False
|
||||||
|
try:
|
||||||
|
d = date.fromisoformat(op["created_at"][:10])
|
||||||
|
return start <= d <= end
|
||||||
|
except: return False
|
||||||
|
signed_annual = sum(x["expected_contract_amount"] or 0 for x in operations if contract_in_period(x, date(2026,1,1), date(2026,12,31)))
|
||||||
|
signed_q2 = sum(x["expected_contract_amount"] or 0 for x in operations if contract_in_period(x, date(2026,4,1), date(2026,6,30)))
|
||||||
|
signed_month = sum(x["expected_contract_amount"] or 0 for x in operations if contract_in_period(x, date(2026,6,1), date(2026,6,30)))
|
||||||
pipeline_amount = sum(x["expected_contract_amount"] or 0 for x in operations if x["project_status"] not in ["已签约","已丢单","已归档","已完成"])
|
pipeline_amount = sum(x["expected_contract_amount"] or 0 for x in operations if x["project_status"] not in ["已签约","已丢单","已归档","已完成"])
|
||||||
signed_not_executed = sum(x["expected_contract_amount"] or 0 for x in operations if x["project_type"] == "execution" and x["execution_progress"] < 100)
|
signed_not_executed = sum(x["expected_contract_amount"] or 0 for x in operations if x["project_type"] == "execution" and x["execution_progress"] < 100)
|
||||||
summary = {
|
summary = {
|
||||||
@@ -363,33 +397,41 @@ def bootstrap():
|
|||||||
"active_sales": len([x for x in sales if x["status"] in ["待跟进", "跟进中", "方案中", "商务谈判"]]),
|
"active_sales": len([x for x in sales if x["status"] in ["待跟进", "跟进中", "方案中", "商务谈判"]]),
|
||||||
"execution_projects": len([x for x in operations if x["project_type"] == "execution"]),
|
"execution_projects": len([x for x in operations if x["project_type"] == "execution"]),
|
||||||
"risk_projects": len([x for x in operations if x["project_status"] == "有风险" or x["risks"]]),
|
"risk_projects": len([x for x in operations if x["project_status"] == "有风险" or x["risks"]]),
|
||||||
"monthly_revenue": revenue_month,
|
"monthly_revenue": rev_month,
|
||||||
"monthly_net_profit": revenue_month - cost_month,
|
"monthly_net_profit": gross_month,
|
||||||
|
"monthly_gross": gross_month,
|
||||||
"upcoming_products": len([x for x in products if x["status"] in ["规划中", "设计中", "开发中", "测试中"]]),
|
"upcoming_products": len([x for x in products if x["status"] in ["规划中", "设计中", "开发中", "测试中"]]),
|
||||||
|
"total_projects": len(operations),
|
||||||
|
"total_proposals": len(proposals),
|
||||||
|
"total_products": len(products),
|
||||||
# Extended finance metrics
|
# Extended finance metrics
|
||||||
"signed_amount": signed_amount,
|
"signed_amount": signed_amount,
|
||||||
|
"signed_annual": signed_annual,
|
||||||
|
"signed_q2": signed_q2,
|
||||||
|
"signed_month": signed_month,
|
||||||
"pipeline_amount": pipeline_amount,
|
"pipeline_amount": pipeline_amount,
|
||||||
"revenue_annual": revenue_annual,
|
"revenue_annual": rev_annual,
|
||||||
"revenue_q2": revenue_q2,
|
"revenue_q2": rev_q2,
|
||||||
"gross_annual": revenue_annual - cost_annual,
|
"gross_annual": gross_annual,
|
||||||
"gross_q2": revenue_q2 - cost_q2,
|
"gross_q2": gross_q2,
|
||||||
"signed_not_executed": signed_not_executed,
|
"signed_not_executed": signed_not_executed,
|
||||||
},
|
},
|
||||||
"recent": rows(conn, "SELECT * FROM follow_up_records ORDER BY id DESC LIMIT 8"),
|
"recent": q("SELECT * FROM follow_up_records WHERE tenant=? ORDER BY id DESC LIMIT 8", tenant),
|
||||||
"risks": [{"title": "执行提醒", "content": x["next_action"]} for x in operations if x["next_action"]][:5],
|
"risks": [{"title": "执行提醒", "content": x["next_action"]} for x in operations if x["next_action"]][:5],
|
||||||
}
|
}
|
||||||
return jsonify({"summary": summary, "sales": sales, "proposals": proposals, "operations": operations, "products": products, "finance": finance, "financeMonthly": monthly_finance(conn), "tasks": rows(conn, "SELECT * FROM project_tasks ORDER BY phase, id")})
|
return jsonify({"summary": summary, "sales": sales, "proposals": proposals, "operations": operations, "products": products, "finance": finance, "projectFinances": pfs, "financeMonthly": monthly_finance(conn, tenant), "tasks": tasks, "tenant": tenant, "tenants": ["科普·无界","科研·无界","医患·无界"]})
|
||||||
finally:
|
finally:
|
||||||
conn.close()
|
conn.close()
|
||||||
|
|
||||||
|
|
||||||
TABLES = {
|
TABLES = {
|
||||||
"sales": ("sales_leads", ["target_customer", "priority", "status"]),
|
"sales": ("sales_leads", ["target_customer", "priority", "status", "tenant"]),
|
||||||
"proposals": ("business_proposals", ["customer_or_project_name", "version", "description", "status", "created_date"]),
|
"proposals": ("business_proposals", ["customer_or_project_name", "version", "description", "status", "created_date", "tenant"]),
|
||||||
"operations": ("operation_projects", ["project_name", "project_version", "project_type", "project_status", "current_stage", "owner", "target_customer", "customer_need", "expected_contract_amount", "expected_sign_date", "sign_probability", "next_action", "sop_stage", "execution_progress", "current_deliverable", "risks", "notes"]),
|
"operations": ("operation_projects", ["project_name", "project_version", "project_type", "project_status", "current_stage", "owner", "target_customer", "customer_need", "expected_contract_amount", "expected_sign_date", "sign_probability", "next_action", "sop_stage", "execution_progress", "current_deliverable", "risks", "notes", "tenant"]),
|
||||||
"products": ("product_versions", ["product_name", "version", "version_goal", "feature_list", "launch_date", "status", "platform", "notes"]),
|
"products": ("product_versions", ["product_name", "version", "version_goal", "feature_list", "launch_date", "status", "platform", "notes", "tenant"]),
|
||||||
"finance": ("finance_records", ["month", "project_name", "record_type", "category", "amount", "occurred_date", "notes"]),
|
"finance": ("finance_records", ["month", "project_name", "record_type", "category", "amount", "occurred_date", "notes", "tenant"]),
|
||||||
"tasks": ("project_tasks", ["project_id", "phase", "milestone", "task", "owner", "due_date", "blockers", "notes"]),
|
"tasks": ("project_tasks", ["project_id", "phase", "milestone", "task", "owner", "due_date", "blockers", "notes", "status", "sort_order", "tenant"]),
|
||||||
|
"projectFinances": ("project_finances", ["project_id", "tenant", "business_type", "customer_name", "sign_amount", "sign_month", "status", "sales_person", "rev_2026_06", "rev_2026_07", "rev_2026_08", "rev_2026_09", "gross_2026_06", "gross_2026_07", "gross_2026_08", "gross_2026_09"]),
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -472,6 +514,19 @@ def delete_followup(followup_id):
|
|||||||
conn.close()
|
conn.close()
|
||||||
|
|
||||||
|
|
||||||
|
@app.route("/api/tasks/batch-sort", methods=["POST"])
|
||||||
|
def batch_sort_tasks():
|
||||||
|
conn = db()
|
||||||
|
try:
|
||||||
|
items = request.get_json(force=True).get("items", [])
|
||||||
|
for item in items:
|
||||||
|
conn.execute("UPDATE project_tasks SET sort_order=? WHERE id=?", (item["sort_order"], item["id"]))
|
||||||
|
conn.commit()
|
||||||
|
return jsonify({"ok": True})
|
||||||
|
finally:
|
||||||
|
conn.close()
|
||||||
|
|
||||||
|
|
||||||
@app.route("/api/files/upload", methods=["POST"])
|
@app.route("/api/files/upload", methods=["POST"])
|
||||||
def upload_file():
|
def upload_file():
|
||||||
file = request.files["file"]
|
file = request.files["file"]
|
||||||
|
|||||||
@@ -1 +1,2 @@
|
|||||||
Flask==3.0.3
|
Flask==3.0.3
|
||||||
|
python-dateutil==2.9.0
|
||||||
|
|||||||
@@ -65,3 +65,89 @@
|
|||||||
| v0.9 原始 PRD | `docs/prd-history/OPC管理系统PRD-V0.9.md` |
|
| v0.9 原始 PRD | `docs/prd-history/OPC管理系统PRD-V0.9.md` |
|
||||||
| v1.0 当前 PRD | `OPC管理系统PRD.md`(根目录) |
|
| v1.0 当前 PRD | `OPC管理系统PRD.md`(根目录) |
|
||||||
| 修改日志(本文件) | `docs/prd/CHANGELOG.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() |
|
||||||
|
|||||||
338
docs/prd/OPC管理系统PRD-V2.0.md
Normal file
338
docs/prd/OPC管理系统PRD-V2.0.md
Normal file
@@ -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`。
|
||||||
416
static/app.js
416
static/app.js
File diff suppressed because one or more lines are too long
@@ -501,6 +501,7 @@ td {
|
|||||||
.task-panel {
|
.task-panel {
|
||||||
background: #fff; border-radius: 12px; width: 1000px; max-width: 96vw;
|
background: #fff; border-radius: 12px; width: 1000px; max-width: 96vw;
|
||||||
box-shadow: 0 20px 60px rgba(0,0,0,0.12); margin-bottom: 48px;
|
box-shadow: 0 20px 60px rgba(0,0,0,0.12); margin-bottom: 48px;
|
||||||
|
overflow: hidden;
|
||||||
}
|
}
|
||||||
.task-header {
|
.task-header {
|
||||||
display: flex; align-items: center; justify-content: space-between;
|
display: flex; align-items: center; justify-content: space-between;
|
||||||
@@ -512,7 +513,21 @@ td {
|
|||||||
padding: 4px; border-radius: 6px; display: flex;
|
padding: 4px; border-radius: 6px; display: flex;
|
||||||
}
|
}
|
||||||
.task-close:hover { color: #475569; background: #f1f5f9; }
|
.task-close:hover { color: #475569; background: #f1f5f9; }
|
||||||
.task-body { padding: 20px; display: flex; flex-direction: column; gap: 16px; }
|
.task-body-wrap, .task-page-wrap { position: relative; overflow: hidden; }
|
||||||
|
.task-body { padding: 20px; display: flex; flex-direction: column; gap: 16px; transition: margin-right 0.25s ease; }
|
||||||
|
.task-drawer {
|
||||||
|
position: fixed; top: 0; right: 0; width: 420px; height: 100vh;
|
||||||
|
background: #fff; border-left: 1px solid #e2e8f0;
|
||||||
|
transform: translateX(100%); transition: transform 0.25s ease;
|
||||||
|
z-index: 300; display: flex; flex-direction: column;
|
||||||
|
}
|
||||||
|
.task-drawer.open { transform: translateX(0); }
|
||||||
|
.task-drawer-hd {
|
||||||
|
display: flex; align-items: center; justify-content: space-between;
|
||||||
|
padding: 14px 20px; border-bottom: 1px solid #e2e8f0;
|
||||||
|
}
|
||||||
|
.task-drawer-title { font-size: 15px; font-weight: 600; color: #1e293b; }
|
||||||
|
.task-drawer-form { padding: 16px 20px; flex: 1; overflow-y: auto; display: flex; flex-direction: column; gap: 14px; }
|
||||||
.task-group {
|
.task-group {
|
||||||
background: #fff; border-radius: 8px;
|
background: #fff; border-radius: 8px;
|
||||||
border: 1px solid #e2e8f0; overflow: hidden;
|
border: 1px solid #e2e8f0; overflow: hidden;
|
||||||
@@ -528,13 +543,20 @@ td {
|
|||||||
padding: 1px 7px; border-radius: 10px;
|
padding: 1px 7px; border-radius: 10px;
|
||||||
}
|
}
|
||||||
.task-group-list { display: flex; flex-direction: column; }
|
.task-group-list { display: flex; flex-direction: column; }
|
||||||
|
.task-group-list.drag-over { background: #f0f9ff; }
|
||||||
.task-row {
|
.task-row {
|
||||||
display: flex; align-items: center; gap: 16px;
|
display: flex; align-items: center; gap: 16px;
|
||||||
padding: 10px 16px; border-top: 1px solid #f1f5f9;
|
padding: 10px 16px; border-top: 1px solid #f1f5f9;
|
||||||
cursor: pointer;
|
cursor: pointer; transition: background 0.15s;
|
||||||
}
|
}
|
||||||
|
.task-row.dragging { opacity: 0.4; background: #f1f5f9; }
|
||||||
|
.task-row.task-done .task-name { text-decoration: line-through; color: #94a3b8; }
|
||||||
.task-row:hover { background: #f8fafc; }
|
.task-row:hover { background: #f8fafc; }
|
||||||
.task-dot { display: flex; color: #cbd5e1; flex-shrink: 0; }
|
.task-dot { display: flex; color: #cbd5e1; flex-shrink: 0; cursor: pointer; }
|
||||||
|
.task-dot:hover { color: #6366f1; }
|
||||||
|
.task-grip { display: flex; color: #cbd5e1; flex-shrink: 0; cursor: grab; }
|
||||||
|
.task-grip:hover { color: #94a3b8; }
|
||||||
|
.task-grip:active { cursor: grabbing; }
|
||||||
.task-main { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 2px; }
|
.task-main { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 2px; }
|
||||||
.task-name { color: #1e293b; font-size: 13px; }
|
.task-name { color: #1e293b; font-size: 13px; }
|
||||||
.task-desc { color: #94a3b8; font-size: 12px; word-wrap: break-word; overflow-wrap: break-word; }
|
.task-desc { color: #94a3b8; font-size: 12px; word-wrap: break-word; overflow-wrap: break-word; }
|
||||||
|
|||||||
@@ -27,9 +27,18 @@
|
|||||||
</head>
|
</head>
|
||||||
<body class="min-h-screen bg-slate-50 text-slate-950">
|
<body class="min-h-screen bg-slate-50 text-slate-950">
|
||||||
<header class="topbar border-b border-slate-200 bg-white px-8 py-5">
|
<header class="topbar border-b border-slate-200 bg-white px-8 py-5">
|
||||||
<div>
|
<div class="flex items-center gap-3">
|
||||||
<p class="eyebrow text-xs font-semibold uppercase tracking-[0.18em] text-blue-700">OPC Manager · 单用户 · 单项目</p>
|
<div>
|
||||||
<h1 class="mt-1 text-2xl font-semibold">科普(慰心斋)OPC 工作台</h1>
|
<p class="eyebrow text-xs font-semibold uppercase tracking-[0.18em] text-blue-700">OPC Manager</p>
|
||||||
|
<div class="flex items-center gap-3 mt-1">
|
||||||
|
<h1 class="text-2xl font-semibold" id="workspaceTitle">科普 OPC 工作台</h1>
|
||||||
|
<select id="tenantSelect" class="rounded-md border border-slate-200 bg-white px-3 py-1.5 text-sm font-medium text-slate-700 outline-none focus:border-blue-500" onchange="switchTenant(this.value)">
|
||||||
|
<option value="科普·无界">科普·无界</option>
|
||||||
|
<option value="科研·无界">科研·无界</option>
|
||||||
|
<option value="医患·无界">医患·无界</option>
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<button id="refreshBtn" class="rounded-md border border-slate-200 bg-white px-3 py-2 text-sm font-medium hover:bg-slate-50" type="button"><i data-lucide="refresh-cw"></i>刷新</button>
|
<button id="refreshBtn" class="rounded-md border border-slate-200 bg-white px-3 py-2 text-sm font-medium hover:bg-slate-50" type="button"><i data-lucide="refresh-cw"></i>刷新</button>
|
||||||
</header>
|
</header>
|
||||||
|
|||||||
Reference in New Issue
Block a user