docs(readme): 支撑页计数改四个(RBAC 上线后一直写错);模块④统一按侧栏叫法「每周工作」
- 第 5 行「三个支撑页」与第 14 行「支撑页四个」自相矛盾十余天(rbac 是 10-01 加的),改四个。 - 模块④名字收敛:README 里 8 处「每周重点工作」按用途分流——指模块/章节/导出行的改「每周工作」 (与 constants.MENUS、侧栏一致);指条目的(新增重点工作、本周工作重点、看板右栏联动)保留原文。 基准写死:模块名=侧栏标签,实体名=重点工作。 - MEMORY:测试例数 83→93 两处。main
parent
a1e6a2d70c
commit
730fa9c36e
|
|
@ -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周` 显式指定年份。
|
||||
|
|
|
|||
16
README.md
16
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=录入周(前端传顶栏当前周,不传按今天所在的周补)
|
||||
|
|
|
|||
Loading…
Reference in New Issue