diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index eace8d1..546a03c 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -17,7 +17,7 @@ - `app/` 后端:`main.py`(入口,挂载 `/api` 子应用 + `/static`)、`models.py`、`schemas.py`、`constants.py`、`routers/{board,projects,custom,focus,weekly,staff,ai,export}.py`、`ai_parser.py`、`export.py`、`schema_patch.py`、`config.py`。 - `app/finance.py`(定制项目财务口径**唯一入口**)、`app/audit.py`(操作日志写入)。 - `web/` 前端:`index.html` / `app.js` / `styles.css` / `icons.js`(零构建,no-cache + ETag)。 -- `tests/` + `pytest.ini` + `requirements-dev.txt`:接口级测试(93 例,`./.venv/bin/python -m pytest`),`conftest.py` 把库指到临时文件,**不碰 `data/board.db`**。 +- `tests/` + `pytest.ini` + `requirements-dev.txt`:接口级测试(98 例,`./.venv/bin/python -m pytest`),`conftest.py` 把库指到临时文件,**不碰 `data/board.db`**。 - `scripts/`:启动/部署 `run.sh`、`deploy.sh`;建库 `init_db.py`;数据导入 `import_excel.py`、`import_staff.py`、**`import_custom_ledger.py`**(《定开项目.xlsx》市场台账 → `custom_projects`,支持 `--dry-run`/`--date`,按 项目ID→名称 upsert)。 - `scripts/legacy/`:历史一次性脚本(`migrate_custom.py`、`shift_year.py`、`fix_period_split.py`、`merge_project.py`、`add_entry_date.py`),不参与启动、不进镜像。 - `.workbuddy/memory/` 存每日工作日志(随仓库提交,2026-09-12 起)。 @@ -34,13 +34,13 @@ `custom_projects` 同时承载两套口径,**互不覆盖**: - **交付跟踪口径**(原有):`stage`(商务阶段)/`progress`/`revenue_amount`/`invoice_amount`/`received_amount`/`owner`(交付负责人,来自花名册) -- **市场台账口径**(2026-09-17 从《定开项目.xlsx》导入):`origin`(项目归属)/`project_code`(项目ID)/`office`(办事处)/`industry`(行业)/`man_days`(市场下单人天)/`market_owner`(市场责任人,销售侧,**不在花名册**)/`project_status`(已验收/待开发/交付完成/交付中/退单)/`accept_plan`(推动验收计划)/`risk_level`(1.高风险/2.低风险)/`update_date`(更新时间)。**`origin`(项目归属) 取值**:新签订单 / 存量项目 / 汇智直签 / **提前交付**(2026-09-20 增) / 其他;**`progress`**(Float, NOT NULL, 默认 0) 复用为「交付中」项目的**进度(%)** +- **市场台账口径**(2026-09-17 从《定开项目.xlsx》导入):`origin`(项目归属)/`project_code`(项目ID)/`office`(办事处)/`industry`(行业)/`man_days`(市场下单人天)/`market_owner`(市场责任人,销售侧,**不在花名册**)/`project_status`(已验收/待开发/交付完成/交付中/退单)/`accept_plan`(推动验收计划)/`risk_level`(1.高风险/2.低风险)/`update_date`(更新时间)。**`origin`(项目归属) 取值**:华智下单 / 存量项目 / 汇智直签 / **提前交付**(2026-09-20 增) / 其他;**`progress`**(Float, NOT NULL, 默认 0) 复用为「交付中」项目的**进度(%)** 映射要点:`下单时间→sign_date`、`办事处→region`(归一化)+`office`(原样)、`验收时间→accept_date`(存的是**季度文本** Q1..Q4,不是日期)、`备注→remark`。`accept_date` 与 `accept_plan` 互补(60+59=119)。 **`accept_date` vs `accept_date_real`**(2026-09-17 增):`accept_date` 存季度文本(Q1..Q4),只作展示;新增 **`accept_date_real`**(真实日期 YYYY-MM-DD)专门给「本月/本年验收」统计用。导入脚本会给「已验收 + 季度文本」的行补**当年季度末**占位(Q1→03-31…Q4→12-31),且**只在库中为空时补**,不覆盖界面手改的真日期。**统计口径(2026-09-20 定稿)**:下单看 `sign_date`(本季度/本年按日期归属);**验收看「验收时间」`accept_date`(季度文本 Q1~Q4)**——本季度验收 = `accept_date` 等于当前季度,本年验收 = 有验收时间(全部季度)。**不再用 `accept_date_real`**(它只作参考/展示,历史上有 4 条 Q3 行缺值,曾导致本季度验收少算)。 -明细表(`renderCustomList`)列顺序对齐 Excel 14 列 + 更新时间 + 操作;行内**只有「修改」**(详情靠点名称;归档按钮已按要求去掉)。**定制项目视图有 3 个 tab:项目总览 / 本周进展 / 年度任务**(`#view-custom .ctab[data-ctab=list|weekly|annual]`)(`state.customTab`;原交付流水线 / 阶段看板 / 财务跟踪已下线)。列表在客户端按 关键字 + **项目归属** + 区域 + 状态 过滤。统计条 `.stat-row` 基于**全部已下单项目**(不随搜索/筛选变化):**已下单项目 / 合同额** + 本季度下单 + 本年新增下单 + 本季度验收 + 本年验收——**已下单 = 项目归属 ∈ {新签订单, 存量项目, 汇智直签}**(`isPlaced()` / `CUSTOM_PLACED`),**提前交付不计入下单**。「本周进展」tab(`renderCustomWeekly`)列出「更新时间」在本周(周一~周日)的项目,上方 3 张卡:**验收情况**(本周更新 ∩ 已验收)/ **本周新增项目**(按「下单时间」`sign_date` 在本周 ∩ 已下单或提前交付)/ **交付项目**(本周更新 ∩ 交付中+交付完成)。「年度任务」tab(`renderCustomAnnual`)按《年度任务.xlsx》出表:季度 + 计收目标(万元,前端常量 `CUSTOM_ANNUAL_TARGETS` = Q1 35/Q2 225/Q3 160/Q4 260)+ 回填列——**计收项目**(`accept_date` == Qn)/ **新增签单**(`isPlaced` 且 `sign_date` 在本年该季度),金额元→万元,完成率 = 计收金额 ÷ 目标。表格 `customTableHtml(rows)` 两个 tab 共用,在「项目状态」后新增**进度**列(`progress`,仅 状态=交付中 或 >0 时显示 `N%`)。项目名称搜索框**回车才查询**(`bindKeyword(id,{enter:true})`;cKeyword 定制 / pKeyword 自研已启用)。导出 Excel 列与明细表一致(15 列),跟随 归档/区域/状态/关键字 筛选。`openNewCustomDialog`(新建,更新录入页共用)字段同样对齐 Excel,提交时 `region` 由后端按 `office` 归一化(深圳→广东)。 +明细表(`renderCustomList`)列顺序对齐 Excel 14 列 + 更新时间 + 操作;行内有「归档 / 修改」(详情靠点名称;归档切换带确认,卡头另有「含归档项目」开关)。**定制项目视图有 3 个 tab:项目总览 / 本周进展 / 年度任务**(`#view-custom .ctab[data-ctab=list|weekly|annual]`)(`state.customTab`;原交付流水线 / 阶段看板 / 财务跟踪已下线)。列表在客户端按 关键字 + **项目归属** + 区域 + 状态 过滤。统计条 `.stat-row` 基于**全部已下单项目**(不随搜索/筛选变化):**已下单项目 / 合同额** + 本季度下单 + 本年新增下单 + 本季度验收 + 本年验收——**已下单 = 项目归属 ∈ {华智下单, 存量项目, 汇智直签}**(`isPlaced()` / `CUSTOM_PLACED`),**提前交付不计入下单**。「本周进展」tab(`renderCustomWeekly`)列出「更新时间」在本周(周一~周日)的项目,上方 3 张卡:**验收情况**(本周更新 ∩ 已验收)/ **本周新增项目**(按「下单时间」`sign_date` 在本周 ∩ 已下单或提前交付)/ **交付项目**(本周更新 ∩ 交付中+交付完成)。「年度任务」tab(`renderCustomAnnual`)按《年度任务.xlsx》出表:季度 + 计收目标(万元,前端常量 `CUSTOM_ANNUAL_TARGETS` = Q1 35/Q2 225/Q3 160/Q4 260)+ 回填列——**计收项目**(`accept_date` == Qn)/ **新增签单**(`isPlaced` 且 `sign_date` 在本年该季度),金额元→万元,完成率 = 计收金额 ÷ 目标。表格 `customTableHtml(rows)` 两个 tab 共用,在「项目状态」后新增**进度**列(`progress`,仅 状态=交付中 或 >0 时显示 `N%`)。关键字搜索全站统一 320ms 防抖(`bindKeyword`,enter 专属模式已删,别再按回去)。导出 Excel 列与明细表一致(15 列),跟随 归档/区域/状态/关键字 筛选。`openNewCustomDialog`(新建,更新录入页共用)字段同样对齐 Excel,提交时 `region` 由后端按 `office` 归一化(深圳→广东)。 **`update_date`(更新时间)的语义**:只在台账字段**确有变化**时才刷新(无变化不刷新)。 - **取值**:导入/初始 = 该行「下单时间」`sign_date`(2026-09-17 全量刷过);界面「修改 / 新建」提交后 = **提交时间** `YYYY-MM-DD HH:MM`(2026-09-18 起)。字段是 `String(16)`,正好放「YYYY-MM-DD HH:MM」。 @@ -62,7 +62,7 @@ ## 定制项目财务口径(2026-10-01 定稿) - **唯一入口 `app/finance.py`**:`period_context` / `summary` / `read_annual_targets` / `write_annual_targets` / `backfill` / `is_placed` / `sign_period` / `accept_period` / `accept_label`。路由与前端都不得自己算一遍。 -- **已下单** `is_placed` = `origin ∈ CUSTOM_PLACED_ORIGINS`(新签订单 / 存量项目 / 汇智直签);**提前交付不算下单**。 +- **已下单** `is_placed` = `origin ∈ CUSTOM_PLACED_ORIGINS`(华智下单 / 存量项目 / 汇智直签);**提前交付不算下单**。 - **下单归属**:`sign_period` = `parse_year_month(sign_date)` 再落到季度;**验收归属**:`accept_period` = (`accept_year`, `parse_quarter(accept_date)`),**刻意不看 `accept_date_real`**。 - **年度目标**:`CUSTOM_ANNUAL_TARGETS_DEFAULT` = Q1 35 / Q2 225 / Q3 160 / Q4 260(万元),按年存 `Setting` 键 `custom_annual_targets:{年份}`。金额库内单位「元」,展示「万元」。 - **未分季(2026-10-01 修)**:认得出年份但认不出季度的行(如 `sign_date="2024/"`)**必须计入年度**,否则同屏「合计」会比 KPI 少一笔。`summary()` 输出 `kpi.{sign,accept}_no_quarter` 与 `annual.unscheduled`,**`annual.total` = 四季度 + 未分季**(target 只累加四季)。前端仅在 `unscheduled` 非 0 时插一行「未分季」,目标/完成率显示 `—`。 @@ -97,7 +97,7 @@ ## 约定 - 当前工作分支:`main`(`origin/develop-chezhiqi` 已并入,不再是开发线)。 -- 跑测试:`./.venv/bin/python -m pytest`(93 例,约 7s,用临时库)。前端语法自检:`node --check web/app.js`。 +- 跑测试:`./.venv/bin/python -m pytest`(98 例,约 7s,用临时库)。前端语法自检:`node --check web/app.js`。 - 改代码后重启服务即可(未开 DEV 热加载)。 - 动数据库前先备份:`cp data/board.db data/board.db.bak`。 - 周期标签格式 `9月第1周`,可写 `2027年1月第1周` 显式指定年份。 diff --git a/README.md b/README.md index 6f77124..754144f 100644 --- a/README.md +++ b/README.md @@ -382,7 +382,7 @@ python scripts/legacy/add_entry_date.py --force # 全部重算 每个路由都挂了 `security` 的权限依赖,按路径首段映射菜单(`SEGMENT_MENU`), 读请求要求 `ro`、写请求要求 `rw`;越权返回 403 并记一条 `audit_logs`(`action=deny`)。 `/api/auth/*`、`/api/meta` 这类只要求登录,不看菜单,否则无法登录与自助改密。 - 录入页跨菜单依赖单独开口:`GET /api/custom/meta`、`GET /api/custom/projects`、`POST /api/custom/updates` + 录入页跨菜单依赖单独开口:`GET /api/custom/meta`、`GET /api/custom/projects`、`POST /api/custom/updates`、`POST /api/custom/ai/parse`、`POST /api/custom/ai/commit` 按 **custom / intake 两者中较高的级别**判定——只有「更新录入 rw」的账号也能录入定制项目; 定制本体(详情 / 新建 / 修改 / 归档)仍严格走 custom。新增这类跨菜单读接口要同步改 `security.guard` 的 assist 白名单。 - **内置角色**:`管理员`(全部 `rw`)、`部门成员`(业务菜单 `rw`,设置与权限只读/无)、`只读访客`(除权限外全部 `ro`), @@ -543,7 +543,7 @@ AuditLog(用户, 动作 create|update|delete|login|logout|deny, 菜单, 方法, ```bash ./.venv/bin/pip install -r requirements-dev.txt -i https://pypi.tuna.tsinghua.edu.cn/simple -./.venv/bin/python -m pytest # 81 个用例,几秒钟跑完 +./.venv/bin/python -m pytest # 98 个用例,几秒钟跑完 ``` - 测试跑在临时库里:`tests/conftest.py` 在 import 业务模块之前就把 `DATABASE_URL` 指向临时文件,**不会碰 `data/board.db`**。 @@ -677,7 +677,7 @@ POST /api/staff PATCH|DELETE /api/staff/{id} 改名会把项目与定制项目上的负责人一起同步,返回值 synced 说明同步了几条) # 其他 -GET|PUT /api/settings AI 配置等(PUT 需要 settings 可编辑) +GET|PUT /api/settings AI 配置等(GET 需 settings 只读,PUT 需可编辑) # 导出(均返回 xlsx,筛选口径与页面对应) GET /api/export/custom ?region=&origin=&status=&risk=&accept_plan=&keyword=&archived=false|true|all(末尾带合计行) diff --git a/web/app.js b/web/app.js index b54519b..bdd2fe0 100644 --- a/web/app.js +++ b/web/app.js @@ -1261,10 +1261,10 @@ // 看板工具栏:负责人筛选只过滤两栏清单;导出按顶栏周期导出全部执行记录(与列表页「导出 Excel」同一位置语义) const toolbar = `
`; @@ -1561,7 +1561,7 @@ ` : ` - `); + `); const form = mode === "view" ? `