diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index ad7b4dd..eace8d1 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`:接口级测试(83 例,`./.venv/bin/python -m pytest`),`conftest.py` 把库指到临时文件,**不碰 `data/board.db`**。 +- `tests/` + `pytest.ini` + `requirements-dev.txt`:接口级测试(93 例,`./.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 起)。 @@ -97,7 +97,7 @@ ## 约定 - 当前工作分支:`main`(`origin/develop-chezhiqi` 已并入,不再是开发线)。 -- 跑测试:`./.venv/bin/python -m pytest`(83 例,约 6.5s,用临时库)。前端语法自检:`node --check web/app.js`。 +- 跑测试:`./.venv/bin/python -m pytest`(93 例,约 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 8960210..5ba0de0 100644 --- a/README.md +++ b/README.md @@ -2,14 +2,14 @@ 基于《软件开发部管理工作执行表.xlsx》构建的 DMS 管理平台。 -侧栏是**四个业务模块 + 三个支撑页**: +侧栏是**四个业务模块 + 四个支撑页**: | 模块 | 适用 | 关心什么 | 数据表 | |---|---|---|---| | **① 工作看板** | 每天进来的第一屏 | 三类工作本周期谁更新了、谁没动,点一条从一览看到详情 | 只读汇总(`/api/weekly` + `/api/focus`) | | **② 自研产品** | NEX云桌面、AI Agent、智飞无人机平台、内部运营… | 长期重点项目的迭代执行、子任务进展、风险阻塞 | `projects` / `tasks` / `updates` | | **③ 定制项目** | 各省市客户定制子项目 | 商务阶段流转(签单→开发→交付→验收→计收)+ 按进度确认收入 | `custom_projects` / `custom_updates` | -| **④ 每周重点工作** | 不值得单独建项目档案的短期活儿 | 一条就是一件事,面板里录,归在**录入周**这一周,跟到完成 | `weekly_focus` | +| **④ 每周工作** | 不值得单独建项目档案的短期活儿 | 一条就是一件事,面板里录,归在**录入周**这一周,跟到完成 | `weekly_focus` | 支撑页四个:**人力资源**(`staff`,全系统「负责人」的唯一来源)、**更新录入**(执行 / 交付记录的唯一写入口:粘贴原文 → AI 整理 → 确认写入)、**设置**(周期管理、AI 配置)、**权限管理**(角色 × 菜单授权、账号、在线会话、操作审计)。 @@ -289,7 +289,7 @@ python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智 | **详情抽屉** | 分「详情 / 修改」两档:详情只读(基础信息 + 收入确认四联卡 + 开票 / 回款行内输入 + 交付记录 + 阶段流转时间线),修改才给表单(名称、手动确认比例、交付环节日期、区域、**验收年度 + 验收季度**成对填写、开票与回款金额)。交付负责人是单人下拉,从人力资源库里选;「添加交付记录」在交付记录区里,一个弹窗录本周期一条 | | **归档** | 归档后不再出现在总览与统计中,历史周期记录完整保留,随时恢复 | -### 4. 每周重点工作 +### 4. 每周工作(重点工作清单) 不值得建项目档案的短期活儿:一条就是一个活儿,不用先建项目,录进来就能按周跟踪。 @@ -429,7 +429,7 @@ python scripts/legacy/add_entry_date.py --force # 全部重算 | 定制项目 | 定制项目周期记录(「项目总览」工具条「导出周期记录」,按顶栏所选周期 / 月份) | `GET /api/export/custom-updates` | | 项目管理 | 项目管理清单(分类、负责人、状态、标签、子任务数等) | `GET /api/export/projects` | | 工作看板 | 本周期(或本月)的执行记录明细(工具栏「导出 Excel」,不受负责人筛选影响) | `GET /api/export/updates` | -| 每周重点工作 | 重点工作清单(工作内容 / 说明 / 预计完成时间 / 录入周 / 执行状态 / 是否延期 / 结果反馈 / 更新) | `GET /api/export/focus` | +| 每周工作 | 重点工作清单(工作内容 / 说明 / 预计完成时间 / 录入周 / 执行状态 / 是否延期 / 结果反馈 / 更新) | `GET /api/export/focus` | | 人力资源库 | 花名册(含在管 / 定制项目数、合同额、待计收) | `GET /api/export/staff` | 导出的 xlsx 带表头样式、冻结首行、自动筛选,金额列按千分位格式;文件名含导出日期。 @@ -498,7 +498,7 @@ CustomProject(名称, 客户, 区域, 合同额, 阶段, 开发进度, 手动确 # 定制项目不做多负责人:other_owners 列保留在库里但不再读写 └── CustomUpdate(周期, 阶段, 内容, 进度, 本期新增下单, 本期新增计收, 风险, 下一步) -# 每周重点工作(独立:条目不是项目,不挂子任务与执行记录) +# 每周工作(独立:条目不是项目,不挂子任务与执行记录) WeeklyFocus(工作内容, 说明, 录入周→Period, 预计完成时间, 执行状态, 是否延期, 结果反馈, 归档) Staff(姓名, 归属小组, 人员归属, 说明, 排序, 归档) # 花名册:所有「负责人 / 团队成员」下拉的唯一来源 @@ -529,7 +529,7 @@ AuditLog(用户, 动作 create|update|delete|login|logout|deny, 菜单, 方法, - **项目管理**(常规执行记录):抽取 摘要 / 进度 / 状态 / 子任务列表 / 风险 / 下一步 - **定制项目类**:抽取 商务阶段 / 开发进度 / 合同额 / 累计计收 / 本期新增计收 / 摘要 / 风险 / 下一步 / 本期明细 -- **每周重点工作**不过 AI:在独立面板里直接填(工作内容 / 说明 / 预计完成时间填日历日期 / 执行状态) +- **每周工作**条目不过 AI:在独立面板里直接填(工作内容 / 说明 / 预计完成时间填日历日期 / 执行状态) - 默认走 **OpenAI 兼容协议**,支持 DeepSeek、通义千问(兼容模式)、Moonshot、智谱、OpenAI、本地 Ollama 等。 - Ollama 示例:Base URL `http://localhost:11434/v1`,模型 `qwen2.5:14b`,Key 任意填。 @@ -569,7 +569,7 @@ app/ main.py FastAPI 入口(API 挂载在 /api,静态页面在 /) config.py 配置与 .env 加载(DATABASE_URL、AI 参数、SESSION_DAYS) db.py engine / Session(按 URL 自动适配方言) - models.py ORM 模型(项目 + 定制项目 + 每周重点工作 + 花名册 + RBAC) + models.py ORM 模型(项目 + 定制项目 + 每周工作 + 花名册 + RBAC) constants.py 状态/阶段常量、收入确认比例、区域与阶段识别、权限菜单目录 security.py 口令散列、会话、权限解析与路由依赖(RBAC 的门) audit.py 操作审计写入 @@ -662,7 +662,7 @@ POST /api/ai/commit 确认写入:按 tasks 建子任务与执 POST /api/custom/ai/parse 定制版预览(阶段/合同额/本期计收/本期明细) POST /api/custom/ai/commit 定制版写入:按名称自动建档,绝对值优先、否则累加明细增量 -# 每周重点工作 +# 每周工作(重点工作) GET /api/focus?archived=false|true|all&status=&keyword= 条目清单(period_id / period_label 都是**录入周**,分堆由调用方判定) POST /api/focus 工作内容非空;period_id=录入周(前端传顶栏当前周,不传按今天所在的周补)