Compare commits
No commits in common. "main" and "develop-chezhiqi" have entirely different histories.
main
...
develop-ch
|
|
@ -1,28 +0,0 @@
|
|||
# 构建上下文只要 app/ web/ scripts/ requirements.txt,其余都排除:
|
||||
# 既避免把本机数据库和密钥烤进镜像,也让每次 build 的上下文保持很小
|
||||
.git
|
||||
.workbuddy
|
||||
.venv
|
||||
__pycache__
|
||||
*.pyc
|
||||
.DS_Store
|
||||
|
||||
# 数据库与用户文件:运行时用 volume 挂进来
|
||||
data
|
||||
|
||||
# 本机配置:容器内一律走 compose 的 env_file,不把 .env 打进镜像
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
|
||||
# 本机启动/部署脚本与历史一次性脚本,镜像里都不需要
|
||||
scripts/run.sh
|
||||
scripts/deploy.sh
|
||||
scripts/legacy
|
||||
tests
|
||||
web/node_modules
|
||||
web/dist
|
||||
requirements-dev.txt
|
||||
docker-compose.yml
|
||||
Dockerfile
|
||||
README.md
|
||||
|
|
@ -9,4 +9,4 @@ AI_API_KEY=
|
|||
AI_MODEL=deepseek-chat
|
||||
AI_TEMPERATURE=0.2
|
||||
|
||||
PORT=5173
|
||||
PORT=8770
|
||||
|
|
|
|||
|
|
@ -13,28 +13,3 @@ AI_TEMPERATURE=0.2
|
|||
|
||||
# ---- 服务 ----
|
||||
PORT=8770
|
||||
# 监听地址:默认 0.0.0.0(局域网可访问);只想本机访问就设 127.0.0.1
|
||||
HOST=0.0.0.0
|
||||
|
||||
# ---- 登录账号(首次启动时用来创建管理员,之后以数据库里的为准)----
|
||||
ADMIN_USERNAME=admin
|
||||
ADMIN_PASSWORD=admin123
|
||||
# 登录态有效天数
|
||||
SESSION_DAYS=30
|
||||
|
||||
# ---- Docker 部署(scripts/deploy.sh / docker-compose.yml 读取)----
|
||||
# 对外端口。容器内部固定监听 8770,换端口只改这里(上面的 PORT 是本机 scripts/run.sh 用的)
|
||||
HOST_PORT=8770
|
||||
# 周期/周次/入库时间等日期按此时区计算,别留 UTC,否则整体差 8 小时
|
||||
TZ=Asia/Shanghai
|
||||
|
||||
# ---- 国内网络加速(只在构建镜像时用到)----
|
||||
# 基础镜像:优先用本地已有的镜像,脚本不会联网去试各种加速站。
|
||||
# 先在机器上准备好 python:3.12-slim(docker pull / 内网仓库 / docker load)即可;
|
||||
# 本地是别的名字或别的 tag,就在下面钉死。别把某台机器上的前缀提交进仓库,换台机器就找不到了。
|
||||
# BASE_IMAGE=python:3.12-slim
|
||||
# pip 源:构建时在容器里装依赖,容器不认宿主机的代理,只能换源;
|
||||
# ./scripts/deploy.sh 会在容器里真访问一次挑可用的(默认清华源),想固定就取消注释:
|
||||
# PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
|
||||
# 关掉自动探测(源已在上面配好,或机器能直连官方源):CN_MIRROR=0 ./scripts/deploy.sh up
|
||||
# 跳过构建、直接用本地已有镜像(离线机器上 docker load 完之后用):NO_BUILD=1 ./scripts/deploy.sh up
|
||||
|
|
|
|||
|
|
@ -1,18 +0,0 @@
|
|||
# Python
|
||||
.venv/
|
||||
__pycache__/
|
||||
*.py[cod]
|
||||
.pytest_cache/
|
||||
|
||||
# 本地数据库备份(仓库里已归档的历史备份不受影响)
|
||||
data/
|
||||
|
||||
# 系统与编辑器
|
||||
.DS_Store
|
||||
|
||||
# 前端构建产物与依赖(nex.config.yaml 标准栈:npm + Vite)
|
||||
web/node_modules/
|
||||
web/dist/
|
||||
|
||||
# 设计规范文档(NEX 本地参考副本,自带 .git,不进仓库;栈配置 nex.config.yaml 与项目规则 AGENTS.md 仍入库)
|
||||
nex_design_system/
|
||||
|
|
@ -1,49 +0,0 @@
|
|||
# 2026-10-01
|
||||
|
||||
本轮目标(5 条):① 补表补代码做出**完整 RBAC** ② 修**跨季度财务统计** ③ 去掉冲突/不明确的交互 ④ 精简界面解释性文字 ⑤ 完整测试各模块。
|
||||
结果:83 个接口用例全绿(6.4s),8 个主菜单 + 全部子页签在浏览器实测无 console 报错、无横向溢出。
|
||||
|
||||
## ① RBAC 成体系(原来只有 `roles.menus` 一个 JSON 字段)
|
||||
|
||||
- **新表**:`roles` / `role_menus`(授权矩阵,一行 = 一个菜单一个级别)/ `users` / `user_roles`(多角色)/ `user_sessions`(服务端 token)/ `audit_logs`(操作日志)。旧库用 `security.migrate_legacy_rbac()` 把 `roles.menus` JSON 迁进 `role_menus`,`users.menus` 迁进 `user_roles`。
|
||||
- **模型**:菜单 8 项 `MENUS`(board/projects/custom/focus/staff/intake/settings/rbac),级别 `ro` / `rw`,**表里没这行 = 看不到该菜单**;多角色取并集(`constants.merge_levels`,同菜单取更高级别)。
|
||||
- **两端同时管**:前端 `canR/canW/can` 过滤侧栏与写按钮;后端 `security.guard` 按 `SEGMENT_MENU`(路径首段 → 菜单)二次校验,**直接调接口绕不过去**。`/api/meta` 之类只要求登录。
|
||||
- **会话**:HttpOnly Cookie `unis_session`(`SESSION_DAYS=30`)。**只认 Cookie,不认自定义头**;退出/停用/改密/强制下线都是删 token → 立即失效。启动时 `purge_expired_sessions()` 清过期。
|
||||
- **防锁死**:`ensure_seed()` 保证系统里至少留一个 `rbac: rw` 的启用账号,没有就把「管理员」角色补给最早的用户;内置角色(管理员/部门成员/只读访客)禁止删除。
|
||||
- **界面**:新增「权限管理」四个子页签 —— 角色权限(授权矩阵)/ 用户 / 在线会话(可强制下线)/ 操作日志(按菜单+动作+时间过滤,可清空)。
|
||||
- **审计**:`app/audit.py` 统一记录写操作与登录行为(操作人/动作/菜单/接口/状态码/说明)。
|
||||
- **README 纠偏**:原文写「所有接口带 `X-Auth-Token`」「login 返回 `{token,user}`」「前端存 localStorage」,**与实现不符**,已改为 Cookie 事实。
|
||||
|
||||
## ② 跨季度财务统计:漏算「认不出季度」的项目
|
||||
|
||||
- **缺陷**:`finance.summary()` 的年度 KPI 只要求认得出**年份**,而年度任务表按**季度**分桶。像 `sign_date="2024/"`(库里确有 1 条:定制项目 id=6 郑州高新区…(AR城市云图),320000 元)这种「认得出年、认不出季」的行,**进了年度 KPI 却不进任何一季度** → 同屏「合计」比 KPI 少一笔(2024:50 个/669.93 万 vs 49 个/637.93 万)。验收侧同理(只有 `accept_year` 没有季度)。
|
||||
- **修法**:`finance.summary()` 新增 `sign_no_q` / `acc_no_q` → 输出 `kpi.sign_no_quarter` / `kpi.accept_no_quarter` 与 `annual.unscheduled`,**`annual.total` = 四个季度 + 未分季**(目标仍只累加四季)。前端只在 `unscheduled` 非 0 时才插一行「未分季」(目标/完成率显示 `—`),干净库不显示。
|
||||
- **不造假数据**:库里 `2024/` 原样保留(业务字面量不可改)。
|
||||
- **不变式**:**四季度 + 未分季 = 合计 = KPI 年度**(下单、验收两条口径都成立)。
|
||||
- **验证**:`tests/test_custom_finance.py` 加 2 例(脏数据计入年度并单列未分季 / 未分季为空不影响原合计);独立脚本跑 **2024~2027 × 12 个月 = 48 组**:季度归属正确、年度表不随所选月份漂移、合计/完成率/KPI 三者自洽。UI 实测 2024 显示未分季 1 个/32 万、合计 50 个/669.93 万;2026 无未分季行。
|
||||
- 口径唯一入口仍是 `app/finance.py`(`period_context` / `summary` / `read_annual_targets` / `is_placed` / `sign_period` / `accept_period`)。
|
||||
|
||||
## ③④ 交互冲突与界面冗余
|
||||
|
||||
- **人力资源花名册**:行内 3 个编辑控件(归属小组 / 人员归属 / 说明)与铅笔「编辑人员」弹窗**改同一批字段 = 两处入口打架**,还把「最近更新」列挤没(sticky 操作列遮挡,over=50)。→ **删掉行内控件与行内保存**,单元格改只读文本,统一走弹窗。复验 over=0 / overlap=0。
|
||||
- **权限矩阵**表格改 `tbl-tight`(左右内边距 8px)+ `.rbac-role{min-width:138px}`,「用户/操作」列不再被遮;角色名旁的「内置」标记与说明改成名称同行、说明另起行。
|
||||
- **设置页**数据库卡片改成两行事实:当前引擎 sqlite / 数据文件 `data/board.db`。
|
||||
- **删解释性长句**:更新录入两处 AI 预览页底部的「正文用你的原文,AI 只补…」整行删除;「没有取到当前周期的起止日期(刚更新过后端的话,请重启服务后刷新)」去掉括号里的碎碎念。
|
||||
- **保留**(判定为必要):删除确认里「请改用归档」的一行、直接写入/AI 整理的 radio 短注、登录页品牌语。
|
||||
- **术语统一**:模块③ 界面统一叫**定制项目**(原「定开项目」),README 里残留的 2 处「定开财务口径 / 定开财务」描述改为「定制项目」;`《定开项目.xlsx》` 是台账文件名,保留。
|
||||
- **宽台账横向滚动**(设计如此,不改):项目总览 17 列(over=622)、本周进展 16 列(over=478)都靠 `.tbl-wrap` 横向滚动,「操作」列 sticky 在右侧。实测滚到最右(scrollLeft=max)时最后一列「备注」与操作列**紧邻 gap=0**,不存在遮挡。
|
||||
|
||||
## ⑤ 测试与数据卫生
|
||||
|
||||
- `./.venv/bin/python -m pytest` → **83 passed**:`test_auth` / `test_rbac` / `test_custom_finance`(13) / `test_periods_projects` / `test_staff_focus_weekly` / `test_ai_export`;`conftest.py` 把 `DATABASE_URL` 指到临时库,**绝不碰 `data/board.db`**,每个用例重建表 + 重新补种。
|
||||
- 浏览器端逐个点 8 个主菜单与全部子页签:console 无报错,`pageOverflow=0`。
|
||||
- 清掉开发库里 **51 条脚本产生的会话**(Python-urllib / curl / testclient / UA 为空),只留 1 条真实浏览器会话,「在线会话」列表恢复可信。
|
||||
- 新增 `.gitignore`(`.venv/`、`__pycache__/`、`*.pyc`、`.pytest_cache/`、`data/*.bak*`、`.DS_Store`),并把误跟踪的 `app/**/__pycache__/*.pyc` 从索引里移除。
|
||||
- **权限管理的行内写操作补上成功提示**(原来改矩阵 / 删角色 / 启停用户 / 下线会话 / 清空日志都是「静默成功」,和全站「写操作必提示」的惯例不一致 = 不明确):`renderRbac` 的 `save(fn, okMsg)` 统一在成功后提示,失败仍然重渲染把界面退回服务端真值;重置密码后补刷新列表(在线数会变)。UI 实测:新建角色 → 勾一格权限 → 删除角色,提示依次为「已新建角色…」「已更新「临时体检角色」的权限」「已删除角色「临时体检角色」」,角色数回到 3,console 无报错。
|
||||
- 全站扫描过一遍写操作的成功反馈:其余模块(更新录入 / 项目与定制项目新建修改 / 重点工作 / 周期 / 花名册 / 设置 / 年度目标)都已有 toast,无遗漏。
|
||||
|
||||
## 环境小抄(macOS)
|
||||
|
||||
- 起服务:`run.sh`;健康检查 **`GET /health`**(不是 `/api/health`)。改后端要重启,改前端刷新即可。
|
||||
- 接口枚举:`/api` 是 Mount,得 `mount.app.openapi()["paths"]`,子 app 路径**不带 `/api` 前缀**。
|
||||
- 脚本登录:`http.cookiejar` + `POST /api/auth/login {username:admin,password:admin123}`,返回体是 user dict(**没有 token**),后续靠 Cookie。
|
||||
|
|
@ -1,23 +0,0 @@
|
|||
# 2026-10-29
|
||||
|
||||
本轮:清理 `scripts/`,启动/部署脚本统一迁入 `scripts/`,补齐环境自动安装。
|
||||
|
||||
## 结构调整
|
||||
|
||||
- `run.sh` → `scripts/run.sh`,`deploy.sh` → `scripts/deploy.sh`;脚本内部用 `BASH_SOURCE/..` 定位项目根目录,任意目录可执行。
|
||||
- 历史一次性脚本迁到 `scripts/legacy/`:`migrate_custom.py`、`add_entry_date.py`、`fix_period_split.py`、`merge_project.py`、`shift_year.py`;同步修正 `sys.path`(多一层 `parents[2]`)与用法注释。
|
||||
- `scripts/` 保留启动脚本 + `init_db.py` + 三个导入脚本;新增 `scripts/README.md`、`scripts/legacy/README.md`。
|
||||
- 启动不再自动导入 Excel;全新库只建空表。导入脚本默认读 `data/import/`,支持 `XLSX` / `STAFF_XLSX` / `CUSTOM_LEDGER_XLSX` 覆盖,去掉了 `/Users/jiliu/...` 与 Desktop 硬编码。
|
||||
- `.dockerignore` 排除 `scripts/run.sh`、`scripts/deploy.sh`、`scripts/legacy`、`tests`、`requirements-dev.txt`;README / MEMORY / Dockerfile / compose / `.env.example` 路径同步更新。
|
||||
|
||||
## 启动兜底
|
||||
|
||||
- `scripts/run.sh`:Python 3.10+ 检测(缺了按 `AUTO_INSTALL=1` 用 dnf/yum/apt/apk/brew 装)→ 项目内 `.venv` → 按 `requirements.txt` 的 cksum 判断是否装依赖(默认源失败依次切清华/阿里)→ 缺 `.env` 从示例生成 → 建 `data/{uploads,exports,import}` → 首次建库 → 端口占用检查 → 跨平台开浏览器。
|
||||
- `scripts/deploy.sh`:任意目录执行;缺 docker 时优先包管理器、再退回 get.docker.com;守护进程没起来尝试 systemd / Docker Desktop;compose 缺失尝试补插件;`AUTO_INSTALL=0` 可关闭自动安装。
|
||||
|
||||
## 验证
|
||||
|
||||
- 空环境(系统 Python 3.11 无 fastapi)跑 `NO_OPEN=1 DEV=0 ./scripts/run.sh`:自动建 `.venv`、装依赖、建库、启动,`/health` 200,`/` 200。
|
||||
- 已在运行时重跑:直接提示地址并 `exit 0`;`/tmp` 下执行同样正常;`DEV=1` 热更新参数启动正常。
|
||||
- `./.venv/bin/python -m pytest -q` → **84 passed**。
|
||||
- 本机没有 docker,`AUTO_INSTALL=0 ./scripts/deploy.sh status` 按预期打印安装指引并 `exit 1`。
|
||||
|
|
@ -1,48 +0,0 @@
|
|||
# 2026-10-30
|
||||
|
||||
本轮目标(goal 第 1 轮):**全站重新整理**——统一 UI/交互、统一功能入口、删过时逻辑。按「先审计、后动刀、逐项验证」推进。
|
||||
|
||||
## 已完成(4 个提交)
|
||||
|
||||
1. `01a9521` 补提交:上午 scripts/ 整理的未提交改动(run.sh/deploy.sh 迁移 + legacy/ 归档)。
|
||||
2. `e1fbb89` **死代码清理(web)**:
|
||||
- `regionOptions` / `stackBar` / `barList`:全库 grep 只有定义无调用,删。
|
||||
- `state.idle` / `state.projects` / `state.customStage`:定义后再无读写、不在 UI_FIELDS,删。
|
||||
- styles.css:`.board-grid` `.pcard*` `.svg-chart` `.legend` `.risk-item` 零引用整块删;
|
||||
`.b-name .star` 选择器删。`bar-row/b-track/b-val` **保留**(人员归属卡手写模板在用,
|
||||
一开始误删后按 `grep -c 'bar-row' app.js` 复活——教训:删 CSS 前连类名一起查模板字符串)。
|
||||
- 过时注释纠偏(定制 tab 早已是 3 个、分类筛选器位置)+ README「.pcard 只做记录未删除」备注兑现。
|
||||
3. `b1ba391` **交互一致性补最后几处洞**:
|
||||
- 全局 `unhandledrejection` → toast 兜底:行内按钮(归档/星标/人员归档等)
|
||||
fire-and-forget 的失败不再静默。局部已有 catch 的不受影响(rejection 被消费)。
|
||||
- 项目/定制抽屉「标记重点/取消重点」补成功 toast(全站惯例「写操作必提示」的最后两处漏网)。
|
||||
- 设置页保存配置失败改 toast「保存失败:原因」;数据库卡片非 sqlite 不再显示 data/board.db。
|
||||
4. `b54cb19` **功能入口一致性:6 个导出端点 ↔ 6 个 UI 入口一一对应**:
|
||||
- 发现:10-01 精简看板时删了工具栏(`bcb3feb`),但 README 看板章节、导出表、
|
||||
`.board-toolbar` 样式、`/api/export/updates`(看板)与 `/api/export/custom-updates`
|
||||
(从未有过 UI)全留着 → 文档承诺 vs 实际按钮不一致。
|
||||
- 恢复:看板工具栏 = 负责人筛选(花名册下拉、进 UI_FIELDS、只过滤两栏清单)+「导出 Excel」
|
||||
(按顶栏周期,`/api/export/updates`);定制「项目总览」加「导出周期记录」→ `custom-updates`。
|
||||
- README 看板工具栏行 + 导出表两行改为与实现逐字一致。
|
||||
|
||||
## 机制核实(不改,属长期基础设施)
|
||||
|
||||
- `schema_patch.ensure_columns`:项目约定的「加字段免迁移」机制,永久保留。
|
||||
- `security.migrate_legacy_rbac`:幂等(目标表非空即跳过),服务老库升级,保留。
|
||||
- `guard` + `SEGMENT_MENU/EXPORT_MENU` 单点鉴权、`finance.py` 财务口径唯一入口:设计良好,未动。
|
||||
- constants.py 37 个常量全部有引用;index.html 34 个 id 全部被 JS 引用;无重复 id;
|
||||
原生 alert/confirm/prompt 零残留;无 TODO/FIXME/调试残留。
|
||||
|
||||
## 验证
|
||||
|
||||
- `node --check web/app.js` 每步通过;pytest 84 passed(后端零改动)。
|
||||
- 起临时实例 :8799 冒烟:login 200 → `/api/weekly?owner=` 200 →
|
||||
`/api/export/updates` 与 `/api/export/custom-updates` 均 200 且为合法 xlsx;测毕下线。
|
||||
- 用户本机 dev 实例 :5173(--reload)全程未受影响,前端刷新即见新版。
|
||||
|
||||
## 未做/遗留(下轮候选)
|
||||
|
||||
- 两个后台审计子代理尚未回稿(前端深度审计 + 后端死端点审计),回收后可能有增量清单。
|
||||
- `/api/tags`(GET/POST/DELETE)与 `POST /api/tasks` 前端零调用、仅测试引用——
|
||||
待后端审计交叉确认后删或留。
|
||||
- 浏览器实机点击看板新工具栏(负责人切换 + 两个导出)——接口已冒烟,界面回归需人工。
|
||||
|
|
@ -1,66 +0,0 @@
|
|||
# 2026-11-04 工作日志
|
||||
|
||||
全站整理改造第二轮:死代码大扫除(前端+模型层)、录入页权限闭环、交互统一收口、导出/参数一致性。
|
||||
|
||||
## 提交(按序)
|
||||
|
||||
1. `2026040` backend 死代码大扫除:security(menus_json/level_of/require_level/migrate_legacy_rbac 整体下线,MENUS/LEVEL_RANK/json/inspect 再导出清理)、audit(TRACKED_GETS、/purge 分支)、schemas(PeriodIn/TaskIn/SettingsIn)、constants(NEGATIVE_STATUS/PRIORITY_MAP/CUSTOM_STAGE_ORDER/CUSTOM_STEP_ORDER/custom_current_step)。token_hint 经查为活契约,保留。
|
||||
2. `7ff0242` **录入页跨菜单依赖**:guard 新增 assist 分支——GET custom/meta、GET custom/projects、POST custom/updates 按 custom/intake 较高级别放行;只有「更新录入 rw」的账号也能录定制项目(此前直接 403 白屏)。回归测试锁定四种越界组合。
|
||||
3. `5601950` web 死代码:intakeParsed/drawerProject/drawerCustom/孤立注释/restoreUI later 分支(UI_KEY→v2);styles.css 删 side-*/kanban(留 kcard-remark)/funnel/ab-foot/af-foot/ic-sm;icons.js 删 6 个零引用图标 + .kcol-title 选择器 + names 导出,剩 48 个全在用(脚本核验)。
|
||||
4. `cf0f3a1` 交互统一 A:弹窗按钮文案(保存修改/添加/新建/新增→保存/创建)、danger 对齐(强制下线、清空日志)、5 个 fire-and-forget 写处理器本地 catch、角色/重置密码防重复提交 + 密码 ≥6 前置校验、afterWrite 刷新失败不吞调用方流程、focus/projects 卡头 count 改过滤后条数。
|
||||
5. `2711046` 交互统一 B:定制三 tab 卡头补齐(周/年卡头 + 删无人用的 hdr 形参)、项目总览加「含归档」开关(customArchived)、**bindKeyword 删 enter 分支**——页内搜索与顶栏统一 320ms 防抖;抽屉报错收敛成 formError() 助手,顺带修 fdSave 缺完成时间时按钮卡死的 bug;README 设计语言补 4 条规范。
|
||||
6. `dd01827` 后端一致性:/export/projects 默认 all→false(跟随页面口径,搜归档要显式 archived=all,既有导出测试改写)、custom/projects 删零引用 key_only、补 4 个契约测试(meta 全集键 / 定制删除连带 / 导出默认 / ensure_columns 幂等)→ 93 passed。
|
||||
7. `0f201b8` 模型层:Period.start/end_date、Task.sort_order、CustomProject.currency、ImportLog.to_dict、**LedgerItem 整表下线**(连带 import_excel《项目明细表》段与 LEDGER_CATEGORIES)。Project/Category/Staff 的 sort_order 与 other_owners/accept_date_real 在用未动。
|
||||
8. `18f97cd` 卡头统一:7 处手写 .card-head 改 cardHead();录入页「新增定制项目」按钮补 canW(custom) 门槛 + 空引用保护。
|
||||
9. `2e4d0b7` **冒烟抓出的真 bug**:删 NOT NULL+default 列后存量库 INSERT 撞约束(新库测试全绿测不出)。schema_patch 新增 STALE_COLUMNS 白名单 + drop_stale_columns()(启动定点 DROP COLUMN,SQLite ≥3.35),main.py 接线;README 补「列级对齐」小节。
|
||||
|
||||
## 验证
|
||||
|
||||
- pytest 93 passed(本轮新增 9 个测试全绿);node --check app.js/icons.js。
|
||||
- :8799 存量库冒烟:启动自动清理 4 死列(PRAGMA 复核消失)、定制创建 200;intake-only 账号 meta/清单/交付记录 200、定制详情 403、管理员 200;日志服务端分页 total/items 正常;导出 200。
|
||||
- 用户 :5173 dev 服务器全程未动。
|
||||
|
||||
## 遗留(下一步)
|
||||
|
||||
- 「添加记录」入口三种走法(看板弹窗 / 项目抽屉跳录入页 / 定制抽屉两者都有)要不要统一成弹窗——待产品拍板。
|
||||
- 其余 6 个 dict 白名单 PATCH 端点保持 dict 语义(已写进 README 前言),暂不改 Pydantic。
|
||||
- legacy/ 归档脚本仍引用 LedgerItem,按历史留档不修。
|
||||
|
||||
## 追加(同日第二轮)
|
||||
|
||||
10. `7d54385` 登录页「请输入账户」→「请输入账号」。
|
||||
11. `bb651a6` legacy 归档脚本适配死列下线(migrate_custom 裸 SQL 读 ledger_items;不再写/排 Task.sort_order)。
|
||||
12. `1ca2cf1` **优先级整链下线**:Project.priority/description 前端零读写、库内 0 行、导出恒「P2 中」——模型列/schema 字段/to_dict 键/导出「优先级」列(测试列号 -1)//meta priorities/constants.PRIORITIES 全删;projects.priority(NOT NULL)+description 登记 STALE_COLUMNS。存量库冒烟:启动清列(PRAGMA 复核)、项目创建/导出 200。pytest 93 passed。
|
||||
注:uvicorn 重定向到文件时 Python stdout 是块缓冲,`[ok]` 清理行要等进程退出/缓冲区满才落盘,验证列删除别只 grep 日志,用 PRAGMA。
|
||||
|
||||
「添加记录」入口统一问题已向用户提问(弹窗 vs 跳转),超时未答,暂维持现状(README 已注明有意设计)。
|
||||
|
||||
## 第 5 轮(复审 + 一致性补口)
|
||||
|
||||
13. `a1e6a2d` 视图状态记忆补齐:UI_FIELDS +customStatus/customRisk/pageSize/intakeType/intakeMode;renderIntake 补 saveUI()(唯一没存的视图渲染器);restoreUI 加 PAGE_SIZES/枚举防呆。规则:**同一工具条上的筛选必须整体记忆**。
|
||||
14. `730fa9c` README 自洽修正:支撑页三→四(rbac 加了一月没跟上);模块④统一按侧栏叫法「每周工作」(8 处分流:指模块改每周工作,指实体保留重点工作)。基准:**模块名=侧栏标签,实体名=重点工作**。MEMORY 例数 83→93。
|
||||
15. `8504ef6` 固化确认分级:删除/清空/下线=danger 确认;归档/恢复=直切+toast;唯一例外=定制项目归档(warn 确认,影响财务口径)。全库 10 处 confirmDialog 逐一核对,破坏性 100% danger ✓。
|
||||
16. `290aeba` 负责人下拉归档后缀统一「(已归档)」(原两种写法混用 4 处)。
|
||||
17. 机械扫描三连:**styles.css 204 类零死码**(唯一字面缺失 accent-red 系 3446 行动态拼接);**69 条注册路由 README API 速览 0 缺漏**;**路由↔前端字面调用 0 孤儿**。index.html 全文过审(双空格×1、nav-label 注释漂移已修 d5d607d)。
|
||||
18. 进行中:前后端两个逐功能复审子代理(前端逐功能 + 后端逐路由),报告回来后开下一批。
|
||||
|
||||
工具教训:run_code 的 TS 程序里嵌 bash 字符串禁用 ${}(会被模板字符串吞掉),多行 python 用临时文件别用 heredoc(静默丢输出的坑又复现)。
|
||||
|
||||
## 第 6 轮(03:00–03:50):局域网部署 + 批次 D/E + 浏览器实测收口
|
||||
|
||||
**用户插单**:「服务端改成支持 0.0.0.0 访问」→「宿主机要能访问前后端」。
|
||||
- `scripts/run.sh` 绑定地址改 `HOST` 变量(默认 0.0.0.0,`.env` 可配),横幅用 UDP 探测打印局域网地址;`.env.example`/README 三处同步(含「run.sh 与容器共存」条目改写:现在两边都占全网卡 8770)。commit `8b7ecbe`。
|
||||
- 用户原来手起的 :5173 绑的还是 127.0.0.1,用新脚本原地重启(同端口同热更参数),宿主机经 http://172.16.105.2:5173 前后端全链路 200(登录→cookie→/api/meta)。
|
||||
- 插曲:DSH 加插件报 `spawn pnpm ENOENT`——本机没装 pnpm。`npm i -g pnpm`(npmmirror)解决;顺手清掉调试落在仓库根的 o*.js/out.js。
|
||||
|
||||
**批次 D**(`c9ec19f`):导出真正跟随页面筛选——/export/projects 补 owner(主/其他负责人)+idle_only(+周期);updates/custom-updates 认 keyword(前端一直在发、后端一直在丢);staff 补 group/keyword。「最近周期」排序改 Period.sort_key(补录历史周不再拿错「最近」);两处手写 status_names 并入 constants.STATUS_MAP;死 import Task/worst_status/_sort_by_entry 清。新增 test_导出精确跟随页面筛选(用现成 _sheet 助手,注意 xlsx 前两行是标题/时间、staff 首列是序号)。
|
||||
**批次 E**(`bde2a09` + 本轮前端):死 import/死正则清零(json、datetime、merge_levels 死引用、Project、LEVELS/LEVEL_RANK、_CN_NUM/_PCT_RE/_AMT_RE——每个都先 grep 验证再删,merge_levels 本体是活的别删错);Project.sort_order 整链下线(模型列+to_dict+两处排序+STALE_COLUMNS,reload 后 PRAGMA 复核存量库自动清列,Staff/Category 同名列是活的没动);PATCH /api/categories 改真部分更新(CategoryPatch/exclude_unset,{} 不再 422、空名 400),test_分类PATCH是部分更新。
|
||||
**前端 P3 收尾 15 处**:keywordFocus 声明归位+光标还原到原位置(原来一律跳末尾)+加载失败清旗标;deleteStaff 失败前缀;录入页定制「新增」升 primary;cdSave/dwSave 本地必填前置(校验不过不锁按钮);空态文案四处统一「点右上角『新增』」(定制空列表额外提示开「含归档项目」);restoreUI 对 customArchived/staffArchived 归一。
|
||||
**frontend-verify 实测**:登录、关键字搜索防抖与空态、定制抽屉清空名称保存→内联「项目名称不能为空」且按钮未卡死、录入页定制 tab 按钮 primary;控制台零新增错误;截图留档。
|
||||
**套件**:98→102 passed;README/MEMORY 用例数与耗时(42s)同步。
|
||||
|
||||
**目标终审(第 6 轮收尾)**:
|
||||
- 全新空库冷启动:三内置角色+admin 自举、登录、7 个核心端点、19 张表全通(此前 drop_stale_columns 方言守卫、ensure_seed 兜底就为这一刻)。
|
||||
- 新增 test_前端查询参数必须在后端有声明:静态扫 app.js 的 query 键对 OpenAPI 双形态校验(严格挂路由+宽松全局),变异验证注入假键必红。103 passed。
|
||||
- Period.kind 裁决:留门字段保留(无读取方但删除收益<动 schema 风险),README「年/月/周」误导已纠正为「一行=一自然周」。
|
||||
- 三个目标维度对照检查:①UI/交互(反馈矩阵/防抖/空态/主按钮/光标/持久化)批次 A-E 清零;②入口与规范(8 处新增、7 处导出联动、PATCH 语义、审计 deny/revoke/500、参数契约测试)清零;③过时清理(死列机制+priority/sort_order、死 import 清零、文案保鲜 103 例/Docker 共存/localhost)清零。评审积压无剩余已知问题。
|
||||
|
|
@ -1,22 +0,0 @@
|
|||
# 2026-11-12 工作日志
|
||||
|
||||
按新引入的 NEX Design System 0.1.7(`nex_design_system/` + `nex.config.yaml`)完整改造前端。**技术栈没动**(FastAPI + 零构建原生 JS + SQLite,NEX §2:已有项目以真实代码为准),改动只落在 `web/` 四个文件 + README/MEMORY 口径,后端一行未改(103 例 pytest 全绿,含前后端参数契约测试)。
|
||||
|
||||
## 改了什么
|
||||
|
||||
1. **`styles.css`(700 → 985 行):token 单一来源**。顶部 `:root` 重写成语义层(`--text/--text-2/--muted/--surface-*/--primary*/--success/--warning/--danger/--radius-*/--sp-*/--ctrl-h-*/--shadow-*/--dur-*/--z-*/--h-topbar/--sidebar-w`),断点登记注释 1180/1100/900/780/640;`.pill/.tag-mini/.arch-badge` 改成只吃 `--c` + `color-mix()` 派生(废掉成对 hex);新增 `.page-head/.dlg-title/.link-btn/.th-sort/.tabpanel/.sk*(骨架)/.sr-only/.skip-link/.is-archived/.trunc`;补 1100 抽屉式侧栏 + 折叠按钮、900 顶栏换行 + 抽屉全宽、640 单列表单 + 底部弹窗 + 40px 触控高度;`prefers-reduced-motion` / `forced-colors` 兜底;auth 页渐变局部化为 `--auth-*`。
|
||||
2. **`index.html`(117 → 129 行)**:`<main id="mainContent" tabindex="-1">` + skip-link + landmark;品牌标题 `<strong>`→`<h1>`;`nav aria-label` + 当前项 `aria-current`;周期段控件 `role="group"` + `aria-pressed`;抽屉/弹窗/登录框补 `role="dialog" aria-modal aria-labelledby` 与 `.dlg-title`;toast 改 `role="status" aria-live="polite"`;图标按钮补 `aria-label`。
|
||||
3. **`app.js`(4191 → 4345 行)**:新增 `INK`(数据色常量,JS 模板里 hex 归零)、`VIEW_META/pageHead()`(八视图统一 h2 抬头 + 说明)、`loadingHtml()`(11 处「加载中…」文本 → 骨架)、`openLayer/closeLayer/focusableIn`(焦点进入 + Tab 锁层 + 关闭归还,三个抽屉入口都接上)、`withBusy()`、`bindTablist()`、`download(url, btn)` 忙态;弹层标题 → `h2.dlg-title id=modalTitle`;`starMark` 有语义(`role="img" aria-label`);卡片头 h4→h3、区块标题 div→h4、`ro()` 四份重复合成一份;排序表头 → `<th aria-sort>` + `.th-sort` 按钮;定制/权限页签 → tablist/tab/tabpanel;分页 → `<nav>` + `aria-current`;23 个图标按钮补名;`<a href="javascript:;">` → `<button class="link-btn">`;表格容器 `role="region" tabindex="0"`;108 个裸 `<label>` 全部要么 `for` 关联、要么改 `.fld-label`(现在 0 裸标签);错误槽 `role="alert"`;导出按钮 `disabled + aria-busy`;用户菜单补 `role=menu/menuitem/aria-expanded` + Escape。
|
||||
4. **`icons.js`**:加 `menu` 图标;自动前导图标的选择器跟 `.card-head h3` 同步。
|
||||
5. **README「界面设计语言」/ MEMORY.md**:补 token 单一来源、`--c` 算法、弹层焦点、状态不靠颜色、断点登记五条长期口径。
|
||||
|
||||
## 踩到的两个坑(记下来)
|
||||
|
||||
- 全局「hex → token」批量替换把 **`:root` 自己**也替换了,产出 12 条 `--panel: var(--panel)` 自引用 → CSS 整段失效白屏;同类误伤还有局部 `z-index: 2` 被提成全局 `--z-*`(页签压住顶栏)和非控件几何被换成 `--ctrl-h-*`(图标底板变长方形)。批量映射必须排除定义区。
|
||||
- 给 `<label>` 加 `for` 的正则把控件开标签 **id 之后的属性全吞了**(80 个 input/select 丢 `value/type/placeholder/data-autofocus`),靠 `git show HEAD:web/app.js` 按前缀 + id 逐个还原。教训:改写开标签要捕获整段 `[^>]*>`,别只捕获到 id。
|
||||
|
||||
## 验证
|
||||
|
||||
- `node --check web/app.js` / `icons.js` 通过;`.venv/bin/python -m pytest -q` → **103 passed**。
|
||||
- 浏览器(`frontend-verify`):八视图逐一点开,控制台 0 错误 0 失败请求;`.wk-split` 两栏、`.wk-head-ops` 归位;Tab 首落 skip-link → 回车跳到 `<main>`;新建项目弹窗首落 `#npName`、连按 Tab 锁在层内、Esc 归还到触发按钮;详情抽屉同上;定制页表头 `aria-sort` 切换、三页签 `aria-selected` 正确;390px / 820px iframe 下侧栏转抽屉、顶栏换行、KPI 两栏、无横向溢出。
|
||||
- **未提交**(等确认);未做:`refresh()` 切周期的请求竞态守卫、RBAC 行内写操作的部分 `withBusy` 覆盖、`ro()/on()/stat()` 之外剩余重复块的抽取——都是 P2/P3,界面行为已合规。
|
||||
|
|
@ -1,76 +0,0 @@
|
|||
# 2026-11-13 工作日志
|
||||
|
||||
按用户要求把前端换成 `nex.config.yaml` 声明的 nex-standard-fullstack:**React 19 + TypeScript + Vite + Ant Design 6 + Tailwind CSS v4 + CSS Variables + Zustand + React Router 7 + Axios(lockfile 必交)**。后端 FastAPI/SQLite、接口、业务流程与默认值一行未改(103 例 pytest 全绿)。这是用户明确要求的迁移,覆盖了 NEX §2「已有项目不迁移」。
|
||||
|
||||
## 落地的结构与长期口径(后续前端改动照这几条走)
|
||||
|
||||
- `web/src/` 是唯一前端源码;`web/dist/` 是构建产物(不入库);`web/legacy/` 是改造前的零构建版,**只在没有 `dist` 时被 `app/main.py` 当作兜底**,同时保留作业务口径对照。
|
||||
- **Token 单一来源仍是 `web/src/styles/tokens.css` 的 `:root`**(阶段一成果):Tailwind v4 只通过 `@theme inline` 指回同一批变量,AntD 主题在 `web/src/theme/antd.ts` 里读同一批色值并带 dev 期漂移告警(`assertTokensMatch`)。任何新色值先进 `:root`,不要在组件里写 hex。
|
||||
- **查询参数集中在 `web/src/api/endpoints.ts`**:一个接口一个函数,视图只允许传该函数点名的键,没点名的会被静默丢掉。`tests/test_api_contract.py::test_前端查询参数必须在后端有声明` 据此对表 OpenAPI(get/del 比 parameters,写请求比 requestBody schema)。加接口就改这一个文件。
|
||||
- 界面状态在 `web/src/store/ui.ts`(Zustand + 手写 sessionStorage 持久化,键 `unis.ui.v2`,字段与旧版 `state` 同名 + `sanitize()` 防呆);字典/周期/台账缓存在 `store/meta.ts`(`dataRev` + `bump()` 是全站刷新信号);会话与权限在 `store/session.ts`(`useCan().r/w(menu)`)。
|
||||
- 反馈只三条通道:弹层内错误用行内 `<Alert type="error" showIcon title>`(AntD 6 已把 `message` 改名 `title`);其余用 `App.useApp().message`;破坏性动作 `modal.confirm`(危险按钮 `okButtonProps:{danger:true}`)。导出统一 `download(url, btn, message)`(fetch+blob,按钮 `disabled + aria-busy`)。
|
||||
- 弹层/焦点不再自研:Modal/Drawer 一律 AntD(自带 `role=dialog`、焦点陷阱、Esc、焦点归还);图标仍是项目自有 `web/src/icons`(52 个 24×24 线性 SVG),AntD 自带图标不参与业务语义;`ConfigProvider autoInsertSpaceInButton={false}` 保证按钮文案与旧版逐字一致。
|
||||
- 顶栏控件按视图给(旧版 `setView` 名单):周期条只在 `board/projects/custom/focus/intake`,搜索框只在 `board/projects/custom/focus/staff`。周期口径 helper(跨月周摊算、下拉标签)统一在 `web/src/utils/period.ts`,新建周期弹窗统一在 `components/NewPeriodModal.tsx`。
|
||||
|
||||
## 追加:新增 / 修改面板统一为侧滑(用户要求)
|
||||
|
||||
- 12 处表单弹窗全部换成右侧抽屉,统一走新增的 `components/FormDrawer.tsx`(取消 + 保存/创建 固定右下、提交中 busy 时禁 Esc、层内 Alert 报错、窄屏全宽):个人设置、新建周期(顶栏下拉与设置页共用)、新建项目、添加·修改执行记录(自研 + 看板两套)、添加·修改交付记录、新建定制项目(定制页 + 录入页)、新增·编辑人员、新建·修改角色、新建·编辑用户、重置密码。
|
||||
- **删除类保持弹出确认**:`modal.confirm`(危险按钮)与需要逐字输入名称的删除弹窗(项目、定制项目)不是「新增 / 修改表单」,没跟着改。
|
||||
- 表单内容一律原样搬进抽屉,字段顺序、标签、校验文案没动。
|
||||
|
||||
## 追加:录入字段一致 + 正文富文本(用户提的两条)
|
||||
|
||||
- **字段对齐**:各模块的「添加/修改执行记录」「添加/修改交付记录」补齐了「一句话摘要」(后端 Update.summary / CustomUpdate.summary 一直支持,前端从没填过),标签措辞改成与更新录入页一致:内容 *→执行内容(正文,原文照录)*、进度(%)→总进度(定制为开发进度(%))、状态→整体状态、风险→风险 / 阻塞、下一步→下一步计划。自研的「子任务」保留(录入页不建子任务,属于模块特有的轴)。
|
||||
- **正文富文本**:新建 `web/src/components/RichEditor.tsx`(加粗/下划线/斜体/5 个语义色/清除格式,contentEditable + execCommand,不引第三方库)与 `RichText.tsx`(消毒后注入),约定写在 `web/src/utils/richtext.ts` 顶部:只允许 `<b> <i> <u> <br> <span data-c="语义名">`,颜色存语义名不存 hex,显示时映射 var(--*) token,于是改主题会跟着变;旧的纯文本数据不用迁移(换行转 `<br>`)。
|
||||
- 接的位置:执行记录(自研页 + 看板)、交付记录(定制页 + 看板)、更新录入的「整理结果」正文(自研/定制两处)、重点工作的说明与结果反馈;展示端 UpdItem / 阶段流转 / 列表截断(先 `richToText` 再切,否则会把标签切一半)。「原始内容」粘贴框故意保持纯文本,掺标记会打乱规则解析的分行与提示词。
|
||||
- 后端:`app/export.py` 加 `plain()`(标签剥掉、`<br>` 变真换行、实体还原),`build_xlsx` 每个单元格过一遍,六张表都跟着降级;导出关键词匹配也改成在纯文本上比(重点工作的量小,排序后再筛)。契约测试 `tests/test_api_contract.py::test_正文富文本按约定存_按纯文本出表` 钉住这套约定(含「项目名里的尖括号不能误伤」)。
|
||||
- 踩坑:execCommand 只吃具体色值,浏览器给的 `<span style="color:#hex">` 或 `<font color>` 要在提交前换回 `<span data-c>`(`normalizeColors`,色表按主题算一次缓存);工具栏按钮点下去会抢焦点导致选区丢失、格式打不上,必须 `onMouseDown preventDefault` + 失焦时存 Range、下次恢复。
|
||||
- 验证:tsc 0 错、`vite build` 通过、`104 passed`;浏览器实测在看板新建一条正文加粗+标红的记录,库里存回来是 `<b><span data-c="danger">…</span></b>`,时间线渲染红色计算值 `rgb(180, 35, 24)`(= `--danger-strong`),截图后把这条测试记录删掉了;重点工作抽屉两个富文本框正常、0 控制台错误。更新录入的「整理结果」预览这次没等到(点了 AI 整理一直「整理中…」,本机 AI 接口没配/超时),改动只是把 TextArea 换成同一个组件,编译与另外三处同路径。
|
||||
|
||||
## 第一轮用户验收(两个返工点)
|
||||
|
||||
- 用户反馈「加了富文本但显示时没有富文本」。原因在我:列表 / 卡片那类预览我沿用旧版的「先转纯文本再按字数截断」(`richToText(...).slice(0,48)`),格式在这一步就被抹平了;抽屉详情是好的,所以他看到抽屉里对、列表里不对。改法:所有展示这些字段的地方一律 `<RichText/>`,需要截断的地方加 `className="clamp"`(app.css 里 `-webkit-line-clamp: 2`),不再数字数。改到:每周工作的说明 / 结果反馈列、看板交付行的摘要、定制台账备注列、三个模块 UpdItem 的风险 / 下一步、定制备注行、看板卡片备注。
|
||||
- 第二条要求是「需要输入富文本的地方都加统一编辑器」。把剩下的长文本框全铺上同一个 `RichEditor`:执行 / 交付记录的 风险 / 阻塞 与 下一步计划(自研页、定制页、看板)、定制项目备注(新建 + 抽屉编辑 + 录入页新建)、更新录入的「原始内容」粘贴框(自研 + 定制两处)与整理结果里的 风险 / 下一步。单行字段(一句话摘要、重点工作「工作内容」)故意不铺,格式在那里没意义。
|
||||
- 「原始内容」铺富文本的代价与处理:规则解析器 `app/ai_parser.py` 是按行找「风险 / 下一步」的,标记会打断它。所以发给 `/ai/parse` 的那份先 `richToText`(块级标记还原成换行),直接写入与 AI 写入入库的正文仍带标记(`/ai/commit` 是 `content = raw_text`,保格式)。整理结果的风险 / 下一步要发数组给后端,新增 `richToLines()`:按 `<br>` 与块级标签拆行,行内 `<b>/<span data-c>` 跟着这一行走,否则用户给某一行上的色会在保存时静默消失。
|
||||
- 浏览器实测:每周工作列表说明列与自研时间线都是加粗+标红(红色计算值 `rgb(180, 35, 24)` = `--danger-strong`);五个页面正文里都不露尖括号标签、控制台 0 错误;看板抽屉 3 个富文本框、定制 1 个、重点工作 2 个、录入页 1 个,字段齐;录入页直接写入端到端跑通(测试记录已删)。`tsc 0 / vite build 通过 / pytest 104 passed`。
|
||||
- 坑(记一下):Playwright 的 `type` 是 fill 语义,整段替换 contentEditable 的内容,所以「先点加粗再打字」在这种自动化里看不到 `<b>`(真人打字是有格式的,execCommand 的 typing state 在)。要在自动化里验证富文本,得先输入再选中再点工具栏(`press Shift+End`)。
|
||||
## 编辑器重做(用户第二轮反馈:不像标准编辑器 + 输入有问题)
|
||||
|
||||
- 「输入有问题」是真的:我在 `emit()` 里做 `el.innerHTML = 归一后的字符串`,每次按键都把 DOM 重排一遍 → 光标回到开头,逐字敲 abc 得到 **cba**。改法:编辑区改成**非受控**——只有外部回填且焦点不在里面时才写 DOM;归一「只改属性、不重排」;`compositionstart/end` 期间不抛值(中文输入法候选词会被打断)。Playwright 逐字符 `press` 复现最快,`type`(fill 语义)反而看不出来。
|
||||
- 工具栏改成标准排布:图标按钮(`bold/italic/underline/eraser/chevron-down` 五个图标加进唯一图标层 `icons/paths.ts`)+ 颜色按钮(A + 当前色条 + ▾)弹出**色板面板**(AntD Popover,6 格:默认色 + 5 个语义色,当前色带勾);`aria-pressed` 跟着选区状态走;Esc 先关面板再关抽屉(`stopPropagation`)。
|
||||
- 上色不再走 `execCommand("foreColor")`:那条路要「浏览器给 hex/rgb 的 span 或 font 标记 → 我们再换算回语义色」,各内核还不一样,实测选区上色直接被下一环吃掉。改成 `Range` 手工包 `<span data-c>`:选区有内容就 extractContents 后包一层(顺带摘掉途经的旧色,替换语义不嵌套);光标处点色就插一个零宽占位 span 并把光标放进去,紧接着打的字带色,失焦时若没打字把占位清掉。
|
||||
- 三个连环坑(都是「颜色点了没反应」):① 色板面板是 portal 出去的,点色块会抢走焦点、选区被吞 → 面板也要 `onMouseDown preventDefault` 并在打开时 `saveRange()`;② `normalizeInPlace` 把我自己刚包的 `<span data-c>` 当成浏览器野标记解包了(要先认自己的标记);③ CSS 里写了不存在的 `--primary-strong`/`--success-strong`,`var()` 失效就退回继承色,看着像「没上色」——语义色映射统一用真实 token:`--danger/--warning/--primary/--success/--muted`。
|
||||
- 验证(逐字符键入 + 局部选区上色):`abcd` 顺序对、光标位置对;局部加粗只包中间两字 `红橙<b>蓝绿</b>灰`;连点五色只剩一层(不嵌套);「默认色」摘色保留加粗;五种语义色计算值与 token 一致(蓝 = rgb(37,99,235));看板新建一条加粗标红的执行记录,库里存 `<b><span data-c="danger">…</span></b>`、时间线渲染 rgb(220,38,38),测完删掉。`tsc 0 / vite build 通过 / pytest 104 passed`。
|
||||
- 遗留:更早那一版编辑器留下的嵌套 span(`<span data-c=danger><span data-c=primary>`)在旧数据里还在,显示以内层为准,没做一次性清洗(要洗就一条 SQL 的事,等用户点头)。
|
||||
## 换内核:Tiptap 3(用户第三轮反馈:色板别写中文 / 回车有问题)
|
||||
|
||||
- 色板去掉中文标签,只留 6 个色块(第一个是「无色」,白底 + 红斜杠,比白底在深色主题下更清楚);名字进 `title` / `aria-label`,当前色描一圈。
|
||||
- 回车确实是坏的:Chrome 的 contentEditable 用 `<div>` 分块,双回车多一整行空行、行首回车还会把字放错位置(逐字符 `press` 复现:`a<div>b</div><div><br></div><div>c</div>`,innerText 4 行变 5 行)。手写追不完,经用户同意换 Tiptap 3.34(`@tiptap/react` + `@tiptap/pm` + `starter-kit` + `extension-text-style` + 显式 `extension-bold/italic`),React 19 peer 兼容。
|
||||
- 换内核后仍然要守三件事,都是踩出来的:
|
||||
1. 官方 `Color` 扩展存 hex,会脱离主题 token;自己写 `TableStyle` 上的 `data-c` 属性(`TextStyle.extend` 改 `parseHTML/renderHTML`)。注意 `TableStyle.parseHTML` 默认要求 `span` 带 `style` 属性才认,我们旧数据是 `<span data-c>` 没 style,不改 `getAttrs` 就解析不进来。
|
||||
2. 加粗/斜体默认产 `<strong>/<em>`,不在展示端白名单里(会被解包成纯文本,加粗当场消失)→ `Bold.extend`/`Italic.extend` 只发 `<b>/<i>`,收还是两种都收;`sanitizeRich` 也加了 STRONG→B / EM→I 的别名映射兜粘贴进来的内容。
|
||||
3. `getHTML()` 的空段落是 `<p></p>`,展示端没有行盒 → 编辑时看得见的空行保存后消失。`normalizeOut` 里补成 `<p><br></p>`,另外 `.rich-view p:empty` 给个 `min-height` 兜旧数据。
|
||||
- 换行口径三端对齐:`richToText` 改成 DOM 走一遍(块前/块后各补一个换行,绝不双计),`app/export.py.plain()` 加 `_ADJACENT_BLOCK` 先把相邻 `</p><p>` 合成一个换行再断;契约测试补了两条断言钉住(`plain("<p>L1</p><p>L2</p><p><br></p><p><b>L4</b></p>") == "L1\nL2\n\nL4"`)。
|
||||
- 实测:逐字符输入顺序对、光标对;`Ctrl+A` 跨四段选区点色 → 每段各自一个 `<span data-c>`、空段 `<p><br></p>`,入库与编辑区一字不差;只读抽屉正好 4 行(含一个空行),橙 = `--warning`;导出说明列 `'L1 aaa L2 bbb L4 ddd'`(换行按老规矩变空格);`Ctrl+Z` 撤销/重做可用(ProseMirror 自己的历史栈,比 `execCommand` 靠谱);用户那条嵌套 span 的旧数据(`<span data-c=primary><span data-c=muted><b>`)在新编辑器里正确回显、颜色按内层。`tsc 0 / build 通过 / pytest 104 passed`,四个视图抽屉里编辑器都在、控制台 0 错误、正文没有裸标签泄漏。
|
||||
- 代价:新增 6 个 `@tiptap/*` 包;`RichEditor` 独立 chunk 130.78 kB gzip(Vite 自动切的,不在首屏 preload 里,跟着用到它的视图 chunk 走)。要再瘦就把组件 `React.lazy` 到抽屉打开时。
|
||||
- 备注:`/focus` 那个抽屉是业务详情抽屉 `FocusDrawer`(`fc-drawer`),不是 `FormDrawer`,所以页面上没有 `.form-drawer` 类名——我测试时选错选择器误判过一次「抽屉打不开」。
|
||||
## 踩到的坑(都写进工程了)
|
||||
|
||||
- 本仓库在共享盘挂载上:`npm install` 会 `EPERM chmod`(要 `--no-bin-links`,代价是 `node_modules/.bin` 为空 → 只能 `node node_modules/vite/bin/vite.js` 直调);`tools.write` 同因失败 → 一律 Node `fs.writeFile`。`scripts/run.sh` 已对这两点做了自动降级。
|
||||
- `vite.config.ts` 必须 `base: "/static/"`,否则 FastAPI 的 `/static` 挂载与深链 SPA 回退对不上。
|
||||
- 契约测试从「扫 app.js 字符串」换成「扫接口层」时,写请求要拿 requestBody schema 的属性比,不能拿 parameters 比,否则 `label/values` 这类 body 键全成误报。
|
||||
- 迁移期最大的时间黑洞是**并行改同一批共享件**:子代理各自复制了 `NewPeriodModal`/周期 helper/`fetchHealth`/`refreshMeta`,回收成共享件后它们的视图才收敛。下次同类迁移应当先把共享层写完再派视图。
|
||||
|
||||
## 验证(2026-11-13 上午)
|
||||
|
||||
- `cd web && node node_modules/typescript/bin/tsc --noEmit` → **0 错**(八个视图 + 共享层全项目);`vite build` 通过(首屏 index JS ~945KB / CSS 40.8KB,八个视图各自切 chunk)。
|
||||
- `.venv/bin/python -m pytest` → **103 passed**(后端只动了 `app/main.py` 静态托管与两处注释)。
|
||||
- 构建版 `http://127.0.0.1:5173` 逐视图走查,控制台 0 错误 0 失败请求:看板(KPI 五卡对 `/api/custom/finance` 原值、左栏三分组、右栏四种分支、月/周切换、负责人筛选、导出 xlsx、抽屉与弹窗)、自研(列表 + 项目抽屉 + 按周/月反馈 + Esc 焦点归还)、定制(三 tab、130 条 21 列、年度 Q4 本季度标记与目标合计 680 / 64.3%、抽屉含交付环节与收入确认)、每周工作(分堆计数 0/0/3/19、表头吸顶 + 操作列吸右)、人力(归属统计 + 22 人花名册)、录入(两形态两模式 + 写入周期标签)、设置(三张卡 + 60 条周期分页 + 禁用删除原因气泡)、权限(四 tab:矩阵 / 用户 2 / 会话 7 / 日志 70)。
|
||||
- 全局搜索联动:顶栏输入「云桌面」→ 自研列表 5 → 1 条,320ms 防抖生效。
|
||||
- `app.css` 结构层删掉 31 组没人用的规则(旧版 modal/drawer/skeleton/pager/登录页与 AntD 取代的部分),1057 → 973 行;删后布局与样式复测正常(`.wk-split` grid、`.sidebar` sticky 宽度不变)。备份在 `/tmp/app.css.bak`。
|
||||
- `web/legacy/` **保留**:没有 `web/dist` 时的兜底 + 业务口径对照;`app/main.py` 自动择优加载。
|
||||
|
||||
## 还欠的技术债(下次动前端时优先收)
|
||||
|
||||
- 视图里仍有几份局部复制的共享件:`focusBuckets`、`customWeeklySections`(+`CM_DEFAULTS/cmList/isPlaced`)、执行记录弹窗(project/custom 两套)、`PipelineBar`、`Pre/UpdItem`、`scopeRangeOf`,以及吸顶表格壳与图标按钮复位样式 —— 建议抽 `utils/focus.ts`、`utils/customSections.ts`、`components/UpdateRecordModal.tsx`、`components/PipelineBar.tsx` 并把样式并进 `app.css`。
|
||||
- 只读角色(某菜单只有 r)的界面分支没有账号可实测(本机只有 admin),逻辑都是 `useCan().w(menu)` 判定,需要在有普通账号的环境再走一遍。
|
||||
|
|
@ -2,45 +2,41 @@
|
|||
|
||||
软件部关键任务追踪看板。FastAPI 后端 + 原生 JS 前端 + SQLite。
|
||||
|
||||
## 运行环境
|
||||
## 运行环境(Windows)
|
||||
|
||||
启动脚本在 `scripts/` 下,macOS / Linux / Windows Git Bash 都能跑,自带环境兜底:
|
||||
`run.sh` 是 macOS 专用(`open`、`/Users/jiliu/...` 绝对路径),Windows 上按以下方式手动跑:
|
||||
|
||||
- 启动:`./scripts/run.sh`(自动找 Python 3.10+、建 `.venv`、缺依赖自动装、缺 `.env` 从示例生成、首次建库)
|
||||
- 只检查不安装:`AUTO_INSTALL=0 ./scripts/run.sh`
|
||||
- 端口/配置来自 `.env`(`PORT=8770`)。DB 用 SQLite,落在 `data/board.db`;首次启动自动建库,已有库直接复用。
|
||||
- Python 解释器(已装好依赖):`C:/Users/Administrator/.workbuddy/binaries/python/envs/default/Scripts/python.exe`
|
||||
- 装依赖:`<PY> -m pip install -r requirements.txt`
|
||||
- 启动:`<PY> -m uvicorn app.main:app --host 127.0.0.1 --port 8770`
|
||||
- 端口/配置来自 `.env`(`PORT=8770`)。DB 用 SQLite,落在 `data/board.db`,仓库里已带数据。
|
||||
- 健康检查:`GET /health`;API 文档:`/api/docs`;首页:`/`。
|
||||
- Docker:`./scripts/deploy.sh up`(缺 docker / compose 时默认尝试自动安装,`AUTO_INSTALL=0` 关闭)。
|
||||
|
||||
## 关键结构
|
||||
|
||||
- `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/` 前端:**已换成 nex.config.yaml 标准栈**(React 19 + TS + Vite + AntD 6 + Tailwind v4 + Zustand + React Router + Axios,源码 `web/src/`,产物 `web/dist/` 由 FastAPI 托管)。`web/legacy/` 是改造前的零构建版,没有 `dist` 时兜底。**设计 token 单一来源是 `web/src/styles/tokens.css` 的 `:root`**(NEX 0.1.7):JS 只注入 `--c` 数据色;查询参数集中在 `web/src/api/endpoints.ts`(契约测试据此对表 OpenAPI)。**设计 token 单一来源是 `styles.css` 顶部 `:root`**(NEX 0.1.7 改造,2026-11-12):JS 只注入 `--c` 数据色,弹层焦点走 `openLayer/closeLayer`,口径见 README「界面设计语言」。
|
||||
- `tests/` + `pytest.ini` + `requirements-dev.txt`:接口级测试(102 例,`./.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`),不参与启动、不进镜像。
|
||||
- `web/` 前端:`index.html` / `app.js` / `styles.css` / `icons.js`(零构建,no-cache + ETag)。
|
||||
- `scripts/` 运维脚本:`init_db.py`、`import_excel.py`、`import_staff.py`、`migrate_custom.py`、`shift_year.py`、`fix_period_split.py`、`merge_project.py`、`add_entry_date.py`、**`import_custom_ledger.py`**(把《定开项目.xlsx》市场台账导入 `custom_projects`,支持 `--dry-run`/`--date`,按 项目ID→名称 匹配做 upsert + 变更比对)。
|
||||
- `.workbuddy/memory/` 存每日工作日志(随仓库提交,2026-09-12 起)。
|
||||
- `schema_patch.ensure_columns` 会在启动时自动给已有表补上模型里**新增的可空列**(`ALTER TABLE ... ADD COLUMN`),所以加字段只需改 `models.py`,不用写迁移脚本。
|
||||
- **删字段同样要动老库**:删掉 `NOT NULL + Python default` 的列后,存量库的残留列会让 INSERT 直接撞 NOT NULL(新库测试全绿也发现不了,2026-11-04 冒烟踩实)。规矩:删列必须同步登记 `schema_patch.STALE_COLUMNS` 白名单,启动时定点 `DROP COLUMN`(SQLite ≥3.35);只删白名单,不做「模型没有就删」的全量对账。`LedgerItem` 台账快照表已同日下线(只有 import_excel 写、零读取方),老库 `ledger_items` 表原地保留。
|
||||
|
||||
## 业务模型
|
||||
|
||||
四模块:① 工作看板(只读汇总 `/api/weekly`+`/api/focus`)② 项目管理(`projects`/`tasks`/`updates`)③ 定制项目(曾用名「定制交付」「定开项目」,表 `custom_projects`/`custom_updates`)④ 每周重点工作(`weekly_focus`)。
|
||||
四支撑页:人力资源(`staff`,全系统负责人唯一来源)、更新录入、设置、权限管理(`rbac`)。
|
||||
四模块:① 工作看板(只读汇总 `/api/weekly`+`/api/focus`)② 项目管理(`projects`/`tasks`/`updates`)③ 定开项目(原「定制交付」,表 `custom_projects`/`custom_updates`)④ 每周重点工作(`weekly_focus`)。
|
||||
三支撑页:人力资源(`staff`,全系统负责人唯一来源)、更新录入、设置。
|
||||
②③ 两套独立项目体系,共用一个花名册。
|
||||
|
||||
### 定制项目的两套字段(2026-09-17 起)
|
||||
### 定开项目的两套字段(2026-09-17 起)
|
||||
|
||||
`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%`)。关键字搜索全站统一 320ms 防抖(`bindKeyword`,enter 专属模式已删,别再按回去)。导出 Excel 列与明细表一致(15 列),跟随 归档/区域/状态/关键字 筛选。`openNewCustomDialog`(新建,更新录入页共用)字段同样对齐 Excel,提交时 `region` 由后端按 `office` 归一化(深圳→广东)。
|
||||
明细表(`renderCustomList`)列顺序对齐 Excel 14 列 + 更新时间 + 操作;行内**只有「修改」**(详情靠点名称;归档按钮已按要求去掉)。**定开视图有 3 个 tab:项目明细 / 本周进展 / 年度任务**(`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` 归一化(深圳→广东)。
|
||||
|
||||
**`update_date`(更新时间)的语义**:只在台账字段**确有变化**时才刷新(无变化不刷新)。
|
||||
- **取值**:导入/初始 = 该行「下单时间」`sign_date`(2026-09-17 全量刷过);界面「修改 / 新建」提交后 = **提交时间** `YYYY-MM-DD HH:MM`(2026-09-18 起)。字段是 `String(16)`,正好放「YYYY-MM-DD HH:MM」。
|
||||
|
|
@ -49,43 +45,14 @@
|
|||
|
||||
导入「市场责任人」等销售侧人名**不走花名册校验**,不要往 `staff` 里塞。
|
||||
|
||||
## 登录与权限 / RBAC(2026-10-01 成体系)
|
||||
## 登录与权限(2026-09-23 合并 main V 0.1.1 起)
|
||||
|
||||
- 全站需**登录**:未登录访问 `/api/*` 返回 **401**。默认管理员 **admin / admin123**(`app/config.py` 的 `ADMIN_PASSWORD`,可用 `.env` 覆盖);另有 `user`(部门成员)。
|
||||
- **三层模型**:`users` ←(`user_roles`)→ `roles` ←(`role_menus`)→ 菜单授权。`role_menus` 一行 = 一个菜单一个级别(`rw` 可编辑 / `ro` 只读),**表里没这行 = 看不到该菜单**;一个用户可挂多个角色,最终权限取**并集**(同菜单取更高级别,`constants.merge_levels` + `LEVEL_RANK`)。`security.migrate_legacy_rbac()`(一次性旧库迁移)已于 2026-11-04 删除——2026-10-01 之前形态的库要先跑含迁移的版本中转。`audit_logs` 记写操作与登录行为。
|
||||
- **两端同时管**:前端 `canR/canW/can` 过滤侧栏与写操作按钮;后端 `security.guard` 按 `SEGMENT_MENU`(接口路径首段 → 菜单)二次校验,直接调接口绕不过去。**唯一跨菜单开口**:录入定制项目要读的 `custom/meta`、`custom/projects`(GET) 与要写的 `custom/updates`(POST) 按 custom/intake 较高级别放行(guard 里的 assist 分支)。`/export/*` 未登记 `EXPORT_MENU` 一律 403(fail-closed)。菜单 = `constants.MENUS` 八项:board / projects / custom / focus / staff / intake / settings / rbac。
|
||||
- **会话 = 服务端 token + HttpOnly Cookie `unis_session`**(`SESSION_DAYS=30`,启动时 `purge_expired_sessions()` 清过期)。**只认 Cookie,不认自定义头**;退出 / 停用 / 改密 / 强制下线都是删 token,立即失效。写脚本登录用 `http.cookiejar` + `POST /api/auth/login`,响应体是 user dict,**不含 token**。
|
||||
- **防锁死**:`ensure_seed()` 保证至少留一个 `rbac: rw` 的启用账号;内置角色(管理员 / 部门成员 / 只读访客)`is_builtin`,禁止删除。
|
||||
- **界面**:「权限管理」四个子页签 `#view-rbac .ctab[data-rbactab=roles|users|sessions|logs]`:角色权限(授权矩阵)/ 用户 / 在线会话(强制下线)/ 操作日志(菜单 + 动作 + 时间过滤,可清空)。
|
||||
- **密码**:pbkdf2(`hashlib` + `hmac` + `secrets`,标准库,**没有额外依赖**)。
|
||||
- 全站需**登录**:未登录访问 `/api/*` 返回 **401**。默认管理员 **admin / admin123**(`app/config.py` 的 `ADMIN_PASSWORD` 默认值,可用 `.env` 覆盖);另有 `user`(部门成员)。
|
||||
- 权限模型:`roles.menus` 是 JSON(board/custom/focus/intake/projects/rbac/settings/staff,值 `rw` / `ro`);内置角色 管理员 / 部门成员 / 只读访客。代码:`app/security.py`(hashlib+hmac 手写,无新依赖)、`app/routers/auth.py`、`app/routers/rbac.py`;表 `users` / `roles` / `user_sessions`。
|
||||
|
||||
## 定制项目财务口径(2026-10-01 定稿)
|
||||
## 术语(2026-09-16 起)
|
||||
|
||||
- **唯一入口 `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`(华智下单 / 存量项目 / 汇智直签);**提前交付不算下单**。
|
||||
- **下单归属**:`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 时插一行「未分季」,目标/完成率显示 `—`。
|
||||
- **不变式**:**四季度 + 未分季 = 合计 = KPI 年度**(下单、验收两条口径都成立);年度表不随顶栏所选月份漂移(`current` 标记除外)。回归覆盖 4 年 × 12 月。
|
||||
- **脏数据留在库里**(如 `sign_date="2024/"` 的定制项目 id=6):不改业务字面量,靠口径容纳。
|
||||
|
||||
## 界面约定(2026-10-01)
|
||||
|
||||
- **一处入口**:同一批字段只能有一个编辑入口。花名册的行内控件与「编辑人员」弹窗改同一批字段 → 已删行内控件,统一走弹窗。
|
||||
- **宽台账横向滚动是设计如此**:`.tbl-wrap{overflow-x:auto}`,「操作」列 sticky 在右。项目总览 17 列 / 本周进展 16 列都靠横向滚动,滚到最右时末列与操作列紧邻(gap=0),**不算遮挡**,别为了“消除溢出”去砍列。
|
||||
- **文案**:界面不放解释性长句;只保留删除确认里的「请改用归档」一行、直接写入/AI 整理的 radio 短注、登录页品牌语。
|
||||
- **表格紧凑**:列多时加 `tbl-tight`(左右内边距 8px)。
|
||||
- **导出入口一一对应(2026-10-30)**:`app/routers/export.py` 的 6 个 xlsx 端点各有唯一 UI 入口:custom/custom-updates → 定制「项目总览」工具条(导出 Excel / 导出周期记录,后者按顶栏周期);projects → 自研产品;updates → 工作看板工具栏「导出 Excel」(按顶栏周期,不受负责人筛选影响);focus / staff → 各自列表。新增导出端点必须同时给按钮并登记 README 导出表。
|
||||
- **写操作必有 toast 反馈 + 全局兜底(2026-10-30)**:所有写成功都提示(含星标切换这类小动作);失败提示在局部 catch,另有全局 `unhandledrejection → toast("操作失败:…")` 兜底(`toast()` 定义后紧跟注册)。fire-and-forget 的行内按钮因此不会静默失败。
|
||||
- **删样式前查模板字符串**:类名可能由 JS 模板手写引用(`bar-row` 曾被误判死代码——`barList()` 函数死了但人员归属卡仍在手写该结构),按「类名在 app.js/index.html 出现次数」判定,不按「函数是否有调用」。
|
||||
- **反馈矩阵(2026-11-04 定稿)**:弹窗报错只走 `modalError()`(#mErr)、抽屉表单报错只走 `formError(id,msg)`(fdErr/cdErr/dwErr)、其余一律 `toast()`、破坏性动作只走 `confirmDialog()`;fire-and-forget 写处理器先本地 try/catch 并中断后续(刷新/重开),不靠全局兜底。
|
||||
- **按钮文案(2026-11-04 定稿)**:新建=「创建」、编辑=「保存」、确认=「确认+动词」;主按钮提交即 disabled 防重复;危险动作触发钮 `.danger` + `confirmDialog({danger:true})`。
|
||||
- **搜索只有一个行为(2026-11-04)**:`bindKeyword` 与顶栏全局搜索都是 320ms 防抖实时,enter 选项已删,别再加回去。卡头「共 N 条」= 过滤后条数(shown.length),列表卡头一律 `cardHead()`,不许再手写 `.card-head`。
|
||||
- **归档过滤**:projects/focus/custom 用「含归档」switch(custom 走 `customArchived=false|all`),staff 用三态下拉;导出默认一律 `archived=false`(含 /export/projects,2026-11-04 起,搜归档项目需显式 all)。
|
||||
|
||||
## 术语(2026-10-01 更新)
|
||||
|
||||
模块③ 的界面称呼现在是 **「定制项目」**(`constants.MENUS` 里 `custom` 的标签),历史曾用名「定制交付」「定开项目」,界面与 README 已统一为「定制项目」。`categories` 表里仍有一行分类叫「定开项目」(业务数据,**不改**);`web/app.js` 里两处提到《定开项目.xlsx》的是台账文件名,保留。
|
||||
模块③ 的正式称呼是 **「定开项目」**(旧称「定制交付」),界面统一用「定开」:定开项目 / 定开项目明细 / 定开合同额 / 定开记录 / 定开动态 / 定开待计收。`categories` 表里也有一行分类叫「定开项目」。
|
||||
|
||||
**但这些字面量必须保留「定制」,改了会坏数据或逻辑**:
|
||||
- `"定制开发"` —— 历史 Excel 的项目容器名,是 `import_excel.py` / `migrate_custom.py` / `fix_period_split.py` / `add_entry_date.py` 里的匹配条件。
|
||||
|
|
@ -96,8 +63,7 @@
|
|||
|
||||
## 约定
|
||||
|
||||
- 当前工作分支:`main`(`origin/develop-chezhiqi` 已并入,不再是开发线)。
|
||||
- 跑测试:`./.venv/bin/python -m pytest`(102 例,约 40s,用临时库)。前端语法自检:`node --check web/app.js`。
|
||||
- 当前开发分支:`develop-chezhiqi`(跟踪 `origin/develop-chezhiqi`;main 为发布线)。
|
||||
- 改代码后重启服务即可(未开 DEV 热加载)。
|
||||
- 动数据库前先备份:`cp data/board.db data/board.db.bak`。
|
||||
- 周期标签格式 `9月第1周`,可写 `2027年1月第1周` 显式指定年份。
|
||||
|
|
@ -107,4 +73,3 @@
|
|||
- 查端口占用:`netstat -ano | grep "127.0.0.1:8770.*LISTENING"`
|
||||
- 停服务:git bash 下 `taskkill //PID` 会被路径转换破坏参数,改用 PowerShell `Stop-Process -Id <PID> -Force` 更稳。
|
||||
- 服务重启后 `/health` 的 `BOOT_ID` 会变,可据此确认是新进程。
|
||||
- 2026-11-13:前端按 nex.config.yaml 换成 React+TS+Vite+AntD+Tailwind v4+Zustand+Router+Axios(`web/src`,产物 `web/dist`,`web/legacy` 留作兜底)。长期口径与验证记录见 `.workbuddy/memory/2026-11-13.md`。
|
||||
|
|
|
|||
64
AGENTS.md
64
AGENTS.md
|
|
@ -1,64 +0,0 @@
|
|||
# NEX Design System — Agent Development Rules (0.1.7)
|
||||
|
||||
NEX 的目标是统一设计规范并约束 Agent 开发行为。NEX 不负责测试体系、测试覆盖率、自动化测试、质量闸门或测试报告。
|
||||
|
||||
## 1. 每个任务的最小读取范围
|
||||
|
||||
开始任务时读取:
|
||||
1. 本文件;
|
||||
2. 项目根目录 `nex.config.yaml`(如存在);
|
||||
3. 项目根 `AGENTS.md` 中的项目规则;
|
||||
4. 项目已有的 UI/UX 规范(如存在)。
|
||||
|
||||
然后**按任务读取** NEX 文档,不得默认全量读取:
|
||||
- 视觉风格/页面:`docs/01-design-principles.md`、`docs/08-page-patterns.md`;
|
||||
- 颜色/主题/Token:`docs/02-design-tokens-and-theme.md`;
|
||||
- 页面布局/导航/移动端:`docs/03-layout-and-responsive.md`;
|
||||
- 公共组件:`docs/04-component-system.md`;
|
||||
- 表单/表格/弹层/反馈:`docs/05-interaction-system.md`;
|
||||
- 语义/键盘/辅助技术支持:`docs/06-accessibility-design.md`;
|
||||
- 体验性能/加载呈现:`docs/07-performance-aware-design.md`;
|
||||
- 新项目技术栈:`docs/10-project-stack-defaults.md`;
|
||||
- 首次接入:`docs/11-project-adoption.md`。
|
||||
|
||||
## 2. 新项目与已有项目
|
||||
|
||||
- 新项目:`nex.config.yaml` 的 `stack` 是明确技术选型。按它初始化,不得自行换栈。
|
||||
- 已有项目:以真实代码、依赖和锁文件为准,保留现有技术栈;不得因为 NEX 默认值不同而迁移。
|
||||
- 项目具体视觉参数、Token 名称、组件 API、布局尺寸和断点以项目级 UI 规范为准。
|
||||
|
||||
## 3. 开发时必须遵守
|
||||
|
||||
1. 先理解现有页面和组件,再改代码;优先复用,不重复造组件。
|
||||
2. 使用项目既有 Token 和主题单一来源,不另建重复变量层。
|
||||
3. 保持同类页面、组件和交互的一致性。
|
||||
4. 不擅自改变业务流程、交互路径、默认值或数据语义。
|
||||
5. 不擅自升级依赖、替换 UI 库、改变语言或重构目录。
|
||||
6. 仅修改完成当前任务所需的范围;不顺手重构无关页面。
|
||||
7. 响应式、无障碍和体验性能按对应设计规范实现;不把这些要求扩展成 NEX 自建测试流程。
|
||||
8. 若项目实现与 NEX 示例不同,先判断是否是合理的项目适配,不强制套用示例尺寸或命名。
|
||||
9. 设计要求有冲突时,以安全/适用规范底线、项目级 UI 规范和用户明确要求为依据;无法确定时只提出一个关键问题。
|
||||
|
||||
## 4. 执行方式
|
||||
|
||||
默认采用轻量开发:
|
||||
- 对当前需求做必要分析;
|
||||
- 查找相关现有组件、Token、页面模式;
|
||||
- 读取相关 NEX 章节;
|
||||
- 直接实施必要修改;
|
||||
- 在对话中简要汇报文件和行为变化。
|
||||
|
||||
只有涉及全局 Token、应用 Shell、导航体系、共享组件 API 或大范围视觉统一时,才先提交简短影响说明和实施计划。
|
||||
|
||||
## 5. NEX 的文件和工具边界
|
||||
|
||||
- 普通任务不得创建阶段报告、审计报告、`reports/` 目录或截图证据目录。
|
||||
- 不得为了遵守 NEX 新建 `scripts/ui/`、自定义检查脚本、自动化测试或质量闸门。
|
||||
- 不得自动引入 Playwright、axe、Vitest、Pytest 或其他测试工具;它们由项目自身工程规范决定。
|
||||
- 不得启动 VoiceOver、NVDA、Orca 等屏幕阅读器;NEX 不定义其测试流程。
|
||||
- 不得把 NEX 规范文档复制成项目中的第二套完整 UI 规范。项目只需保留必要的项目专属设计说明。
|
||||
- 只有用户明确要求,或确有长期设计决策需要留档时,才新增/更新文档。
|
||||
|
||||
## 6. 汇报要求
|
||||
|
||||
用简洁对话汇报:完成内容、主要文件、关键设计选择、尚未解决的阻塞。除用户明确要求外,不生成长篇报告,不列出与本任务无关的测试证据。
|
||||
70
Dockerfile
70
Dockerfile
|
|
@ -1,70 +0,0 @@
|
|||
# 部门关键任务追踪看板 · 运行镜像
|
||||
#
|
||||
# 构建:docker build -t unis-board . (日常部署建议用 ./scripts/deploy.sh up)
|
||||
# 跑: docker run -d -p 8770:8770 -v $PWD/data:/app/data unis-board
|
||||
#
|
||||
# 镜像里只有依赖和代码,数据库/附件都在 data/,靠 bind mount 挂进来。
|
||||
# data/ 已被 .dockerignore 排除,不会把本机 board.db 打进镜像。
|
||||
#
|
||||
# 基础镜像。国内直连 docker.io 会在 load metadata 阶段 TLS 超时,所以支持指成本地已有的镜像:
|
||||
# docker pull python:3.12-slim && docker build --build-arg BASE_IMAGE=python:3.12-slim .
|
||||
# ./scripts/deploy.sh 会优先用本地已有的同名镜像,不会去联网试各种加速站。
|
||||
# ---------- 阶段 1:前端构建(nex.config.yaml 标准栈:npm + Vite + React)----------
|
||||
# 基础镜像同样可以指到本地已有的:docker build --build-arg NODE_IMAGE=node:22-alpine .
|
||||
ARG NODE_IMAGE=node:22-alpine
|
||||
FROM ${NODE_IMAGE} AS webbuild
|
||||
ARG NPM_REGISTRY=https://registry.npmmirror.com
|
||||
WORKDIR /web
|
||||
# 依赖单独一层:只改业务代码时不重装 node_modules(国内直连 npmjs 慢时用 NPM_REGISTRY 换源)
|
||||
COPY web/package.json web/package-lock.json ./
|
||||
RUN npm ci --no-audit --no-fund --registry "${NPM_REGISTRY}"
|
||||
COPY web ./
|
||||
RUN npm run build # 产物在 /web/dist,由 FastAPI 挂在 /static 下托管
|
||||
|
||||
# ---------- 阶段 2:运行镜像 ----------
|
||||
ARG BASE_IMAGE=python:3.12-slim
|
||||
FROM ${BASE_IMAGE}
|
||||
|
||||
ENV PYTHONUNBUFFERED=1 \
|
||||
PYTHONDONTWRITEBYTECODE=1 \
|
||||
PIP_NO_CACHE_DIR=1 \
|
||||
PIP_DISABLE_PIP_VERSION_CHECK=1
|
||||
|
||||
# 业务代码用 datetime.now() 取本地时间(周期/周次/入库时间/更新时间),
|
||||
# 容器默认 UTC 会让这些日期整体差 8 小时,所以必须显式设时区(compose 里的 TZ 会覆盖这里)。
|
||||
ENV TZ=Asia/Shanghai
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
# 依赖单独一层:改业务代码不触发重装依赖
|
||||
COPY requirements.txt ./
|
||||
# pip 源:默认清华源(国内直连 pypi.org 基本超时,而且换基础镜像/代理都救不了它,
|
||||
# 构建容器里的请求只能靠这里换源)。境外机器或内网自建源就覆盖:
|
||||
# docker build --build-arg PIP_INDEX_URL=https://pypi.org/simple .
|
||||
# ./scripts/deploy.sh up 会自动探测可用源并写进 .env,正常不用手工传。
|
||||
ARG PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
|
||||
RUN pip install --retries 5 --timeout 60 -i "$PIP_INDEX_URL" -r requirements.txt
|
||||
# 用 MySQL 部署时放开下面这行(与 requirements.txt 的注释一致)
|
||||
# RUN pip install "pymysql>=1.1" "cryptography>=42.0"
|
||||
|
||||
COPY app ./app
|
||||
COPY scripts ./scripts
|
||||
# 运行镜像只要前端构建产物;web/legacy 是没构建时的兜底(app/main.py 里择优加载)
|
||||
COPY --from=webbuild /web/dist ./web/dist
|
||||
COPY web/legacy ./web/legacy
|
||||
|
||||
# 上传件 / 导出件目录;SQLite 库同样落在这里,实际内容由 volume 提供
|
||||
RUN mkdir -p data/uploads data/exports
|
||||
|
||||
# 容器内固定监听 8770,对外端口由 compose 的 HOST_PORT 控制。
|
||||
# 镜像默认以 root 运行:macOS 上 bind mount 只有 root 写 data/ 最省心。
|
||||
# Linux 上想换成非特权账号,在 compose 里加 user: "1000:1000"
|
||||
#(前提是 ./data 的属主也是这个 uid,否则 SQLite 写不进去)。
|
||||
ENV PORT=8770
|
||||
EXPOSE 8770
|
||||
|
||||
HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
|
||||
CMD python -c "import os,urllib.request;urllib.request.urlopen('http://127.0.0.1:%s/health' % os.environ.get('PORT','8770'),timeout=3).read()"
|
||||
|
||||
# 首次启动建表 + 预置分类(幂等,不覆盖已有数据);内置角色与管理员账号由 app/main.py 启动时补齐
|
||||
CMD ["sh", "-c", "python scripts/init_db.py && exec python -m uvicorn app.main:app --host 0.0.0.0 --port \"${PORT:-8770}\""]
|
||||
|
|
@ -1,46 +1,22 @@
|
|||
# DMS管理平台
|
||||
# 软件开发部 · 关键任务追踪看板
|
||||
|
||||
基于《软件开发部管理工作执行表.xlsx》构建的 DMS 管理平台。
|
||||
基于《软件开发部管理工作执行表.xlsx》构建的部门关键任务追踪系统。
|
||||
|
||||
侧栏是**四个业务模块 + 四个支撑页**:
|
||||
侧栏是**四个业务模块 + 三个支撑页**:
|
||||
|
||||
| 模块 | 适用 | 关心什么 | 数据表 |
|
||||
|---|---|---|---|
|
||||
| **① 工作看板** | 每天进来的第一屏 | 三类工作本周期谁更新了、谁没动,点一条从一览看到详情 | 只读汇总(`/api/weekly` + `/api/focus`) |
|
||||
| **② 自研产品** | NEX云桌面、AI Agent、智飞无人机平台、内部运营… | 长期重点项目的迭代执行、子任务进展、风险阻塞 | `projects` / `tasks` / `updates` |
|
||||
| **③ 定制项目** | 各省市客户定制子项目 | 商务阶段流转(签单→开发→交付→验收→计收)+ 按进度确认收入 | `custom_projects` / `custom_updates` |
|
||||
| **④ 每周工作** | 不值得单独建项目档案的短期活儿 | 一条就是一件事,面板里录,归在**录入周**这一周,跟到完成 | `weekly_focus` |
|
||||
| **② 项目管理** | NEX云桌面、AI Agent、智飞无人机平台、内部运营… | 长期重点项目的迭代执行、子任务进展、风险阻塞 | `projects` / `tasks` / `updates` |
|
||||
| **③ 定开项目** | 各省市客户定开子项目 | 商务阶段流转(签单→开发→交付→验收→计收)+ 按进度确认收入 | `custom_projects` / `custom_updates` |
|
||||
| **④ 每周重点工作** | 不值得单独建项目档案的短期活儿 | 一条就是一件事,面板里录,归在**录入周**这一周,跟到完成 | `weekly_focus` |
|
||||
|
||||
支撑页四个:**人力资源**(`staff`,全系统「负责人」的唯一来源)、**更新录入**(执行 / 交付记录的唯一写入口:粘贴原文 → AI 整理 → 确认写入)、**设置**(周期管理、AI 配置)、**权限管理**(角色 × 菜单授权、账号、在线会话、操作审计)。
|
||||
支撑页三个:**人力资源**(`staff`,全系统「负责人」的唯一来源)、**更新录入**(执行 / 交付记录的唯一写入口:粘贴原文 → AI 整理 → 确认写入)、**设置**(周期管理、AI 配置)。
|
||||
|
||||
②③ 是**两套彼此独立的项目体系**(数据表也完全分开),共用一个**人力资源库**:项目与定制项目的「负责人」都从花名册里选,人员进出只维护一处。④ 的条目不是项目,不挂子任务与执行记录。① 只做汇总与跳转,自己不落数据。
|
||||
②③ 是**两套彼此独立的项目体系**(数据表也完全分开),共用一个**人力资源库**:项目与定开项目的「负责人」都从花名册里选,人员进出只维护一处。④ 的条目不是项目,不挂子任务与执行记录。① 只做汇总与跳转,自己不落数据。
|
||||
|
||||
## 周期管理
|
||||
|
||||
### 周期口径:自然周 + 周四归属
|
||||
|
||||
一周 = **自然周(周一~周日)**;这一周算哪个月,看**它的周四落在哪个月**(等价于「这一周至少 4 天在本月」)。实现见 `app/constants.py` 的 `month_week1()` 与 `week_of_date()`,两者互为逆运算。
|
||||
|
||||
2026 年的跨月边界:
|
||||
|
||||
| 周期 | 日期范围 | 说明 |
|
||||
|---|---|---|
|
||||
| 2026年9月第3周 | 09/14–09/20 | |
|
||||
| 2026年9月第4周 | 09/21–09/27 | 9 月就这 4 个自然周(整个 9 月 = 08/31–09/27) |
|
||||
| **2026年10月第1周** | **09/28**–10/04 | 周四是 10/1 → 整周计入 10 月 |
|
||||
|
||||
所以 **9/28(一)、9/29(二)、9/30(三) 写的记录统计在 10 月**:9/28 一打开页面,顶栏的默认周期已经是「10月第1周」(`GET /api/periods` 用 `week_of_date(today)` 定位当期,`app/routers/board.py`),录入时写进去的 `period_id` 就是它。
|
||||
|
||||
推论:**月口径 = 该月各自然周的并集,不等于自然月 1 号~月末**(2026年9月 = 08/31–09/27、2026年10月 = 09/28–11/01)。这是「一周 7 天」+「一周不跨月」的必然结果——月份不是 7 天的整数倍,一个月只可能是 **4 或 5 周**(不是固定 4 周,第 5 周是合法周期,`_week_period()` 遇到会自动建),月底那几天总要归到某一边。
|
||||
|
||||
口径已经直接标在界面上,不用靠记忆:
|
||||
|
||||
- 顶栏周期下拉带日期范围:`2026年10月第1周(9/28–10/4)`、`2026年10月(9/28–11/1 · 5 周)`
|
||||
- 跨月周在顶栏右侧、录入页「写入周期」旁、执行/交付记录弹窗里挂橙色「跨月周」提示,写明几天在 9 月、几天在 10 月
|
||||
- 设置 → 周期管理 有「起止日期」列,跨月的行标「跨月周」
|
||||
|
||||
边界规则由 `tests/test_periods_projects.py::test_跨月周按周四所在月归属` 锁死。**要换口径**(改成「周一所在月」,或记录带真实日期后「按自然日归月」)**必须连带迁移历史 `period_id` 并核对已发布过的数字**,不要只改函数。
|
||||
|
||||
### 新增周期
|
||||
|
||||
三个入口,都会自动接续年份:
|
||||
|
|
@ -48,7 +24,7 @@
|
|||
| 入口 | 操作 |
|
||||
|---|---|
|
||||
| 顶部周期下拉 | 选「+ 新建周期…」 |
|
||||
| 更新录入页(常规 / 定制都有) | 周期下拉选「+ 新建周期…」 |
|
||||
| 更新录入页(常规 / 定开都有) | 周期下拉选「+ 新建周期…」 |
|
||||
| 设置页 → 周期管理 | 「+ 新建周期」按钮 |
|
||||
|
||||
输入格式 `9月第1周`(也可写 `2027年1月第1周` 显式指定年份),年份按以下规则自动推断:
|
||||
|
|
@ -67,174 +43,56 @@
|
|||
历史数据的年份口径需要整体调整时:
|
||||
|
||||
```bash
|
||||
python scripts/legacy/shift_year.py --dry-run # 先预演,看清楚了再执行
|
||||
python scripts/legacy/shift_year.py # 全部 +1 年
|
||||
python scripts/legacy/shift_year.py --years -1 # 反向回滚
|
||||
python scripts/shift_year.py --dry-run # 先预演,看清楚了再执行
|
||||
python scripts/shift_year.py # 全部 +1 年
|
||||
python scripts/shift_year.py --years -1 # 反向回滚
|
||||
```
|
||||
|
||||
> 历史一次性修数脚本统一收在 `scripts/legacy/`,不参与启动流程。
|
||||
|
||||
> 内部按年份从大到小更新,避免 2024→2025 撞上尚未更新的 2025;执行后会校验 sort_key 无重复,有重复则整体回滚。
|
||||
> 执行前建议手动备份:`cp data/board.db data/board.db.bak`
|
||||
|
||||
## 快速开始
|
||||
|
||||
```bash
|
||||
cd /path/to/unis_manager
|
||||
./scripts/run.sh
|
||||
cd /Users/jiliu/WorkSpace/unis_manager
|
||||
./run.sh
|
||||
```
|
||||
|
||||
打开 <http://127.0.0.1:8770>。服务默认监听 **0.0.0.0**:同事在局域网里用 `http://<本机IP>:8770` 直接访问(脚本启动时会把这行地址打印出来);只想本机访问就 `HOST=127.0.0.1 ./scripts/run.sh`。
|
||||
打开 <http://127.0.0.1:8770>
|
||||
|
||||
首次运行 `scripts/run.sh` 会自动完成:检查 Python 3.10+ → 建项目内 `.venv` → 缺依赖自动安装(默认源失败会依次切国内镜像)→ **装前端依赖并构建 `web/dist`**(没有 node 时用 `web/legacy` 旧版兜底)→ 缺 `.env` 时从 `.env.example` 生成 → 建库 → 启动并打开浏览器。已有 `data/board.db` 时直接复用,不会覆盖数据。
|
||||
|
||||
**前端技术栈(`nex.config.yaml` 里的 nex-standard-fullstack)**:React 19 + TypeScript + Vite + Ant Design 6 + Tailwind CSS v4(只作工具类,颜色仍走 CSS Variables)+ Zustand + React Router 7 + Axios;源码在 `web/src/`。后端 FastAPI 只托管构建产物 `web/dist`(资源挂 `/static/`,深链回 `index.html`;没有 dist 时退回 `web/legacy` 的零构建旧版)。
|
||||
|
||||
| 前端命令 | 作用 |
|
||||
|---|---|
|
||||
| `cd web && npm install` | 装依赖(锁文件 `web/package-lock.json`,必须随仓库提交) |
|
||||
| `cd web && npm run dev` | 5174 热更新开发,`/api` 代理到本地后端 |
|
||||
| `cd web && npm run build` | `tsc --noEmit` + Vite 构建,产出 `web/dist` |
|
||||
| `cd web && npm run typecheck` | 只做类型检查 |
|
||||
|
||||
`scripts/run.sh` 里对应:源文件比 `web/dist` 新就自动重建;`WEB=0` 跳过构建、`WEB=force` 强制重建、`NPM_REGISTRY=...` 换 npm 源。
|
||||
首次运行 `run.sh` 会自动完成:选择带依赖的 Python 解释器 → 缺依赖则安装 → 建库 → 导入历史 Excel → 拆分定开项目,然后启动并打开浏览器。
|
||||
|
||||
### 启动方式与排错
|
||||
|
||||
| 场景 | 命令 |
|
||||
|---|---|
|
||||
| 正常启动 | `./scripts/run.sh` |
|
||||
| 报 `permission denied` | `chmod +x scripts/run.sh` 后重试(**不要用 sudo**) |
|
||||
| 不想改权限 | `bash scripts/run.sh` |
|
||||
| 缺 Python / 依赖 | 脚本自动安装;不想自动装就设 `AUTO_INSTALL=0`,脚本只打印命令 |
|
||||
| 缺 Node / 前端构建失败 | 装 Node 20+ 再跑;只想先把服务跑起来可以 `WEB=0 ./scripts/run.sh`(界面用 `web/legacy` 旧版)|
|
||||
| 换端口 | `PORT=8771 ./scripts/run.sh` |
|
||||
| 关闭热加载 | `DEV=0 ./scripts/run.sh`(默认是开着的) |
|
||||
| 不自动开浏览器 | `NO_OPEN=1 ./scripts/run.sh` |
|
||||
| 正常启动 | `./run.sh` |
|
||||
| 报 `permission denied` | `chmod +x run.sh` 后重试(**不要用 sudo**) |
|
||||
| 不想改权限 | `bash run.sh` |
|
||||
| 换端口 | `PORT=8771 ./run.sh` |
|
||||
| 关闭热加载 | `DEV=0 ./run.sh`(默认是开着的) |
|
||||
| 不自动开浏览器 | `NO_OPEN=1 ./run.sh` |
|
||||
| 提示"端口已被占用" | 原窗口 `Ctrl+C`,或 `lsof -ti:8770 \| xargs kill` 后重跑 |
|
||||
| 用 Docker 部署(不装 Python) | `./scripts/deploy.sh up`,见下面「Docker 部署」 |
|
||||
|
||||
> ⚠️ 不要用 `sudo` 启动:数据库文件会变成 root 属主,后续写入会失败。
|
||||
|
||||
> **热更新(默认开启)**:uvicorn 监听 `app/**.py` 与 `.env`,改后端即重启。
|
||||
> 改前端走另一条路:`cd web && npm run dev`(Vite 自带 HMR,`/api` 代理到后端),或改完 `npm run build` 再刷新——产物文件名带哈希,浏览器不会拿旧版。
|
||||
> `DEV=0 ./scripts/run.sh` 关掉后端热重载;`data/*.db` 的写入不会触发重启。旧零构建版(`web/legacy/`)的 `livereload.js` 只在没有 `web/dist` 时生效。
|
||||
> **热更新(默认开启)**:uvicorn 除 `*.py` 外还会监听 `web/**` 的 js/css/html 与 `.env`,改动即重启;
|
||||
> 页面里的 `web/livereload.js` 每秒读一次 `/health` 的启动代际,发现服务重启后自动刷新浏览器。
|
||||
> 也就是说改完代码**不用手动重启、也不用手动刷新**。`DEV=0 ./run.sh` 可关掉(关闭后该脚本首轮即自行停止)。
|
||||
> `data/*.db` 的写入不会触发重启。
|
||||
|
||||
### 手动分步执行(等价于 scripts/run.sh 干的事)
|
||||
### 手动分步执行(等价于 run.sh 干的事)
|
||||
|
||||
```bash
|
||||
python3 -m venv .venv
|
||||
./.venv/bin/pip install -r requirements.txt
|
||||
cd web && npm ci && npm run build && cd .. # 前端产物 web/dist
|
||||
./.venv/bin/python scripts/init_db.py
|
||||
./.venv/bin/python -m uvicorn app.main:app --port 8770
|
||||
pip install -r requirements.txt
|
||||
python scripts/init_db.py
|
||||
python scripts/import_excel.py "/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx"
|
||||
python scripts/migrate_custom.py
|
||||
python -m uvicorn app.main:app --port 8770
|
||||
```
|
||||
|
||||
> Windows 把 `.venv/bin/` 换成 `.venv/Scripts/`。
|
||||
|
||||
**从旧 Excel 还原历史数据**(一次性,相关脚本已归档到 `scripts/legacy/`):
|
||||
|
||||
```bash
|
||||
./.venv/bin/python scripts/import_excel.py "<软件开发部管理工作执行表.xlsx>" --reset
|
||||
./.venv/bin/python scripts/legacy/migrate_custom.py
|
||||
./.venv/bin/python scripts/import_staff.py "<软件开发部人员名单.xlsx>"
|
||||
```
|
||||
|
||||
> 现在 `scripts/run.sh` 首次启动**只建空库**,不再自动导入 Excel。已有数据库的机器直接把 `data/board.db` 带过去即可。
|
||||
|
||||
### Docker 部署(换机器 / 上服务器)
|
||||
|
||||
不想装 Python,或者要放到服务器上常开,用 Docker:
|
||||
|
||||
```bash
|
||||
cd /path/to/unis_manager
|
||||
./scripts/deploy.sh up # 构建镜像 + 后台启动 + 等健康检查
|
||||
```
|
||||
|
||||
打开 <http://127.0.0.1:8770>(局域网访问 `http://<本机IP>:8770`,监听地址由 `.env` 的 `HOST` 控制,默认 `0.0.0.0`)。首次启动自动建表、预置分类,并创建内置角色与 `admin` 账号(密码见 `.env`)。
|
||||
|
||||
| 文件 | 作用 |
|
||||
|---|---|
|
||||
| `Dockerfile` | 运行镜像:装依赖 + 拷 `app/ web/ scripts/`;启动时先跑 `init_db.py`(幂等)再起 uvicorn |
|
||||
| `docker-compose.yml` | 编排:`./data` 挂进容器存数据库、`HOST_PORT` 控对外端口、`restart: unless-stopped` 随 Docker 自启 |
|
||||
| `scripts/deploy.sh` | 命令封装:`up` / `update` / `restart` / `down` / `logs` / `status` / `backup` / `mirror`,顺带检查 docker 是否在跑、`.env` 与 `data/` 是否存在,并在构建前定好基础镜像与 pip 源 |
|
||||
| `.dockerignore` | 保证 `data/`、`.env`、`.git` 不会被烤进镜像 |
|
||||
|
||||
| 场景 | 命令 |
|
||||
|---|---|
|
||||
| 改完代码上线 | `./scripts/deploy.sh update`(重建镜像并替换容器) |
|
||||
| 改了 `.env`(AI Key / 端口) | `./scripts/deploy.sh restart` |
|
||||
| 看日志排错 | `./scripts/deploy.sh logs` |
|
||||
| 看状态与健康检查 | `./scripts/deploy.sh status` |
|
||||
| 停止(数据保留) | `./scripts/deploy.sh down` |
|
||||
| 换对外端口 | `.env` 里 `HOST_PORT=8080`,再 `./scripts/deploy.sh up` |
|
||||
| 裸 compose 命令 | `docker compose up -d --build` / `docker compose down` |
|
||||
| 构建时基础镜像 / pip 下载超时 | `./scripts/deploy.sh mirror` 重探,或手工指定 `PIP_INDEX_URL=... BASE_IMAGE=... ./scripts/deploy.sh up`(见下「国内网络加速」) |
|
||||
| 把现有数据带到新机器 | `./scripts/deploy.sh backup` → 拷到目标机 `data/board.db` → `./scripts/deploy.sh up` |
|
||||
|
||||
#### 国内网络加速(docker.io / pypi.org 连不上时)
|
||||
|
||||
国内构建会撞两道**互不相干**的墙,得分开治,只治一道必然还剩一道:
|
||||
|
||||
| 卡在哪 | 典型报错 | 治法 |
|
||||
|---|---|---|
|
||||
| ① 守护进程拉基础镜像 | `failed to resolve source metadata for docker.io/library/python:3.12-slim: ... TLS handshake timeout` | 用本地已有的镜像(`BASE_IMAGE=` 指定),或先 `docker pull` / 给守护进程配 registry-mirrors |
|
||||
| ② 构建容器里装依赖 | `[4/8] RUN pip install ... -i https://pypi.org/simple` 非零退出 | 换 pip 源 `PIP_INDEX_URL`(清华 / 阿里 / 腾讯) |
|
||||
|
||||
`./scripts/deploy.sh up` 构建前把这两道都定下来,原则是**能本地解决就不联网**:
|
||||
|
||||
- 基础镜像只看本地有没有:`BASE_IMAGE` 指定的镜像在本地 → 直接用;只有同名 tag(如 `python:3.12-slim`)→ 也用(仓库前缀只是当初从哪儿拉的,镜像是同一份)。本地确实没有才试拉一次(守护进程配的 registry-mirrors 在这一步生效),还拉不到就**直接报错停下**并打印补救命令——不去逐个试加速站,那种循环只会白等几分钟。
|
||||
- pip 源:在构建用的容器里真 `urlopen` 一次逐个试(容器网络 = 构建网络,比宿主机 curl 准),默认清华源。
|
||||
- 定下来的值只 export 给本次构建,**不写回 `.env`**(`.env` 在 git 里,把某台机器的地址带到另一台机器正是故障源)。
|
||||
|
||||
```bash
|
||||
./scripts/deploy.sh up # 定源(本地有镜像就不联网)→ 构建 → 等健康检查
|
||||
./scripts/deploy.sh mirror # 重探一次 pip 源,并打印可写进 .env 的两行
|
||||
```
|
||||
|
||||
> **别把某台机器上的 `BASE_IMAGE` 前缀提交进仓库。** 换机器后那个前缀对应的镜像本地不存在,构建就会卡在 `load metadata`;这行留空或写裸 `python:3.12-slim`,让每台机器自己的镜像说了算。
|
||||
|
||||
不想用脚本,等价的两条 build-arg:
|
||||
|
||||
```bash
|
||||
docker compose build \
|
||||
--build-arg BASE_IMAGE=python:3.12-slim \
|
||||
--build-arg PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
几个必须知道的点:
|
||||
|
||||
- **基础镜像拉成功 ≠ 构建能过**:`docker pull` 只治①,容器里的 `pip install` 照旧撞 pypi.org,必须另外给②换源。
|
||||
- **shell 里的 `HTTP(S)_PROXY` 对构建没用**:Docker 守护进程和构建容器都不读宿主机的代理变量。要走代理得在 Docker Desktop → Settings → Resources → Proxies 里配 `http://host.docker.internal:7897`(端口换成你本机代理的)。
|
||||
- **境外机器 / 内网有自建源**:`CN_MIRROR=0 ./scripts/deploy.sh up` 跳过 pip 探测,源完全由 `.env` 说了算。
|
||||
- **目标机完全不能上网**:走离线路。`docker save -o unis-board.tar unis-board:latest` → 拷过去 `docker load -i unis-board.tar` → `NO_BUILD=1 ./scripts/deploy.sh up`(跳过构建直接用本地镜像)。
|
||||
- 构建失败时脚本会自己打印一份排查清单(`scripts/deploy.sh` 的 `build_hint`),照抄命令即可。
|
||||
|
||||
几个坑:
|
||||
|
||||
- **数据只落在 `./data`**:重建镜像、`down` 再 `up` 都不动数据;备份依旧是拷走 `data/board.db`。
|
||||
- **时区必须设**:容器默认 UTC,而周期/周次/入库时间都按本地日期算,所以 compose 固定传 `TZ=Asia/Shanghai`,别删。
|
||||
- **容器内端口固定 8770**:`.env` 的 `PORT` 是本机 `scripts/run.sh` 用的,compose 里覆盖成 8770;要换端口只改 `HOST_PORT`。
|
||||
- **别和 `scripts/run.sh` 同时跑**:一是 SQLite 是文件库,同一份 `board.db` 不要同时被本机进程和容器读写;二是默认两边都监听全部网卡的 8770(run.sh 的 `HOST=0.0.0.0` × compose 的 `HOST_PORT=8770`),后启动的那个会直接撞端口。两者要共存就给一边换端口:`HOST_PORT=8899 ./scripts/deploy.sh up` 或 `PORT=8899 ./scripts/run.sh`。
|
||||
- **换 MySQL**:放开 `Dockerfile` 里 `pymysql` 那行重新 build,再把 `.env` 的 `DATABASE_URL` 指过去(见「迁移到 MySQL」)。
|
||||
|
||||
### 带着现有数据部署
|
||||
|
||||
镜像里**故意不含数据**(`.dockerignore` 排除了 `data/`),容器读的是宿主机挂载进来的 `./data/board.db`,所以:
|
||||
|
||||
- **就在本机这个目录部署** → 什么都不用做,`./scripts/deploy.sh up` 起来读的就是当前这份库;连 `user_sessions` 里的登录态都延续,别人不用重新登录。
|
||||
- **换一台机器部署** → 先把数据取出来,落到目标机的 `./data/board.db`:
|
||||
|
||||
```bash
|
||||
./scripts/deploy.sh backup # 一致性快照 → data/backups/board-YYYYmmdd_HHMMSS.db
|
||||
scp data/backups/board-*.db user@host:/srv/unis_manager/data/board.db
|
||||
ssh user@host 'cd /srv/unis_manager && ./scripts/deploy.sh up'
|
||||
```
|
||||
|
||||
> - 数据库不在 git 里(`data/` 已忽略),`git clone` 不会带数据;要迁移请用 `./scripts/deploy.sh backup` 的快照(走 SQLite 备份 API,本机服务正在写也能拿到一致的库)。
|
||||
> - 启动时的 `init_db.py` 和 `ensure_seed` 只会**补**缺失的表 / 分类 / 内置角色,`users` 非空就不再创建 `admin`,不会覆盖或清空任何数据。实测:拿当前生产库快照起容器,启动前后逐表行数完全一致,123 个定制项目、22 名人员、老 token 全部照常可用。
|
||||
> - 目标机上的 `./data` 属主要和运行容器的人对得上(compose 以 root 跑则无此顾虑);SQLite 是文件库,同一份库别让两个实例同时写。
|
||||
> 重新导入:`python scripts/import_excel.py <xlsx> --reset` 之后再跑一次 `python scripts/migrate_custom.py`
|
||||
> (迁移脚本会删除常规表里的「定制开发」容器,重复执行前请先 reset)
|
||||
|
||||
## 功能
|
||||
|
||||
|
|
@ -244,16 +102,17 @@ ssh user@host 'cd /srv/unis_manager && ./scripts/deploy.sh up'
|
|||
|
||||
| 区域 | 内容 |
|
||||
|---|---|
|
||||
| 顶部 KPI | 重点项目(含本期已更新数)/ 重点项目未更新 / **本周重点工作**(本周到期的重点工作条数,脚注「逾期 N 条 · 已完成 N 条」)/ 执行记录 / 定制合同额(含项目数与本期计收)/ 风险阻塞 |
|
||||
| **左栏** | **三组**清单,顺序固定:① **本周工作重点**(列表,逾期的置顶)② **重点项目**(列表:`is_key` 的项目,另含本期补了执行记录的非重点项目,条目前用 ★ 区分)③ **定制项目**——**只给一个入口**「本周定制项目动态」,左栏不铺清单(100 多个项目会淹没看板),点开才在右栏列本周有动态的。组头显示条数与「几个已更新 / 几条逾期 / 本周动态几个」;每条带负责人、状态或阶段、本期摘要、风险条数,本期有记录的点亮标记 |
|
||||
| **右栏** | 点左栏任意一条即可联动。重点项目 → 本期执行记录 / 进度与状态(含子任务)/ 近 8 期趋势;**定制项目入口 → 本周动态总览**(顶部标签:本周新增 / 本周验收 / 有交付动态 / 合同额合计 / 本期计收,下面分「本周新增」「本周验收」「本周有变化」三段,每条带阶段、负责人、金额、本期计收与摘要),点某一条再下钻到该项目 → 交付环节五段条 / 财务跟踪四联卡 + 开票·回款行内输入 / 本期交付记录 / 更早的交付记录,改开票、回款、环节日期即时保存(改日期会自动推进商务阶段);每周重点工作 → 只读的说明与状态,要改点「修改」开抽屉 |
|
||||
| 工具栏 | 「负责人」筛选(只过滤左右两栏清单,不改变顶部 KPI)、「导出 Excel」(导出顶栏所选周期 / 月份的全部执行记录,不带负责人条件);顶栏可切周 / 月视图(月视图自动汇总该月所有周)。「列入全部在途」开关(`all_custom`)在右栏定制总览的头部 |
|
||||
| 顶部 KPI | 重点项目(含本期已更新数)/ 重点项目未更新 / **本周重点工作**(本周到期的重点工作条数,脚注「逾期 N 条 · 已完成 N 条」)/ 执行记录 / 定开合同额(含项目数与本期计收)/ 风险阻塞 |
|
||||
| **左栏** | **三组**清单,顺序固定:① **本周工作重点**(列表,逾期的置顶)② **重点项目**(列表:`is_key` 的项目,另含本期补了执行记录的非重点项目,条目前用 ★ 区分)③ **定开项目**——**只给一个入口**「本周定开项目动态」,左栏不铺清单(100 多个项目会淹没看板),点开才在右栏列本周有动态的。组头显示条数与「几个已更新 / 几条逾期 / 本周动态几个」;每条带负责人、状态或阶段、本期摘要、风险条数,本期有记录的点亮标记 |
|
||||
| **右栏** | 点左栏任意一条即可联动。重点项目 → 本期执行记录 / 进度与状态(含子任务)/ 近 8 期趋势;**定开项目入口 → 本周动态总览**(顶部标签:本周新增 / 本周验收 / 有交付动态 / 合同额合计 / 本期计收,下面分「本周新增」「本周验收」「本周有变化」三段,每条带阶段、负责人、金额、本期计收与摘要),点某一条再下钻到该项目 → 交付环节五段条 / 财务跟踪四联卡 + 开票·回款行内输入 / 本期交付记录 / 更早的交付记录,改开票、回款、环节日期即时保存(改日期会自动推进商务阶段);每周重点工作 → 只读的说明与状态,要改点「修改」开抽屉 |
|
||||
| 工具栏 | 「负责人」筛选、「导出本周期记录」,提示里带本期项目数与定开动态数;顶栏可切周 / 月视图(月视图自动汇总该月所有周)。「列入全部在途」开关(`all_custom`)不在工具栏,挪到了右栏定开总览的头部 |
|
||||
| 统计概览 | 页面最底部的折叠区(原「执行面板」,已不占主导航位):周期活跃度柱状图、分类环形图、状态分布、进度 Top10、低进度预警、风险清单,数据来自 `GET /api/stats`;加载失败也不影响看板主体 |
|
||||
|
||||
数据分两路:`GET /api/weekly?period_id=|year&month&owner=&all_custom=` 一次返回重点项目清单 + 定制项目清单 + 顶部 KPI(含 `custom_new` 本期新入库数、`custom_updated` 本期有交付记录数);**「本周工作重点」不在 `/api/weekly` 里**,前端并发取 `GET /api/focus` 后合并,分堆也在这一步判定(按条目的**录入周**:本周录入的 + 更早周次标了「延期」又没做完的结转条目)。
|
||||
数据分两路:`GET /api/weekly?period_id=|year&month&owner=&all_custom=` 一次返回重点项目清单 + 定开项目清单 + 顶部 KPI(含 `custom_new` 本期新入库数、`custom_updated` 本期有交付记录数);**「本周工作重点」不在 `/api/weekly` 里**,前端并发取 `GET /api/focus` 后合并,分堆也在这一步判定(按条目的**录入周**:本周录入的 + 更早周次标了「延期」又没做完的结转条目)。
|
||||
|
||||
定制项目的口径:`/api/weekly` 返回**本期有交付记录**、**被标为重点**、**本周期新入库**(`is_new`:入库日期落在本周期首末日之内)、**本周期新下单**(`sign_date` 落在本周期)或**本周期已验收**(`update_date` 落在本周期且项目状态为「已验收」)的定制项目;右栏总览默认列「本周新增」「本周验收」「本周有变化」三段,其中**前两段与「定制项目 → 本周进展」的「新增项目 / 验收情况」口径完全一致**(前者按「下单时间」、后者按「更新时间 + 状态=已验收」),其余只在组头计数里出现,并在底部提示「另有 N 个在途定制项目本周没有动态」。勾选总览头部的「列入全部在途」后,后端补上处于在途阶段(商机 → 已验收)的项目,总览多出一段「其他在途项目」。头部几枚标签与「合同额合计」只加总**当前列出来的行**(同一项目同时落在两段时只算一次),勾与不勾数字会跟着清单变。
|
||||
定开项目的口径:`/api/weekly` 返回**本期有交付记录**、**被标为重点**、**本周期新入库**(`is_new`:入库日期落在本周期首末日之内)、**本周期新下单**(`sign_date` 落在本周期)或**本周期已验收**(`update_date` 落在本周期且项目状态为「已验收」)的定开项目;右栏总览默认列「本周新增」「本周验收」「本周有变化」三段,其中**前两段与「定开项目 → 本周进展」的「新增项目 / 验收情况」口径完全一致**(前者按「下单时间」、后者按「更新时间 + 状态=已验收」),其余只在组头计数里出现,并在底部提示「另有 N 个在途定开项目本周没有动态」。勾选总览头部的「列入全部在途」后,后端补上处于在途阶段(商机 → 已验收)的项目,总览多出一段「其他在途项目」。头部几枚标签与「合同额合计」只加总**当前列出来的行**(同一项目同时落在两段时只算一次),勾与不勾数字会跟着清单变。
|
||||
|
||||
### 2. 自研产品(项目管理)
|
||||
### 2. 项目管理
|
||||
|
||||
长期重点项目(`projects` + `tasks` + `updates`)。执行记录的写入逻辑没变,仍旧统一走「更新录入」。
|
||||
|
||||
|
|
@ -261,25 +120,27 @@ ssh user@host 'cd /srv/unis_manager && ./scripts/deploy.sh up'
|
|||
|---|---|
|
||||
| **项目管理** | 表格展示分类、负责人、状态、进度、更新情况(标签只在详情抽屉里维护,列表不放,避免挤占名称列);**列表只读**,行内不放任何输入框和下拉,每行只有 **详情 / 修改 / 归档** 三个按钮(操作列吸附在表格右侧,横向滚动也不会被挤出可视区);负责人筛选下拉来自人力资源库;支持新建与「含归档」筛选。详情抽屉里的**周期反馈**可切「按周 / 按月」与「本周 · 近 4 周 · 近 12 周 · 全部」(按月为「本月 · 近 3 月 · 近 6 月 · 全部」),用 ‹ › 翻页看更早的周期,默认跟随顶栏选中的周期 |
|
||||
|
||||
> 「执行面板」不再单列模块,已折进工作看板底部的「统计概览」折叠区。
|
||||
|
||||
#### 项目维护操作
|
||||
|
||||
| 操作 | 说明 |
|
||||
|---|---|
|
||||
| **面板分区** | 抽屉用标准对话框式标题栏:**标题在左(下面一行副标题),基础信息的操作按钮成排在右,✕ 在最右**,按钮条嵌在标题栏里(不悬浮、不吸顶,滚动时跟着标题栏常驻)。详情档是「删除 · 归档/恢复 · 标记重点 · **修改**」,修改与新增档是「取消 · **保存/添加**」,主按钮永远在最右、危险动作在最左,按钮文字不再重复对象名(标题栏已经写了是哪个项目/条目)。附表的写入只有一处入口:附表标题下的「添加执行记录」,它跳到「更新录入」并带上该项目与顶栏当前周期——抽屉里不另做一套基础信息之外的录入表单,避免两条路写出两份数据;改某一条已有记录用的是行内「修改」,走全站唯一的记录弹窗(`openUpdateDialog`,看板右栏与定制抽屉共用)。基础信息的按钮在标题栏、附表的更新按钮在附表上方,两类按钮不在同一个位置混着放;编辑与新增档的报错信息显示在正文最上方;周期反馈上方的 按周/按月 + 本周/近 4 周/… 标成「查看范围(只读筛选)」,只翻看不改数据 |
|
||||
| **改名** | 改名就是改基本信息:在详情面板点「修改」,表单第一行即项目名称(项目管理与定制项目同一套逻辑)。名称非空校验 + 重名检测,失败信息显示在面板正文最上方,不弹提示跑路 |
|
||||
| **负责人与团队** | **多负责人只适用于重点项目**:重点项目可以指定**多个负责人**与**团队成员**,定制项目只有一个**交付负责人**(单人下拉)外加**团队成员**。人名一律从人力资源库下拉里选。**界面上负责人不分主次**:名单横向排开自动换行,每一位都带 × 可删(没有「主」标记、没有不给删的首行),「+ 添加负责人 / + 添加成员」跟在名单末尾。名单只在详情抽屉的「修改」档维护;只读处一律一排对等的小标签:重点项目的列表与详情把负责人摆成对等的一排,定制项目的列表与详情只显示一个交付负责人加团队成员标签。存储与统计口径不变:**重点项目 `owner` 字段仍是 `owners[0]`**(删掉第一位就由后一位顶上),看板、导出、人力负载与 KPI 按它归属;重点项目**所有负责人都算命中**,定制项目按交付负责人命中;团队成员不参与该筛选 |
|
||||
| **面板分区** | 抽屉用标准对话框式标题栏:**标题在左(下面一行副标题),基础信息的操作按钮成排在右,✕ 在最右**,按钮条嵌在标题栏里(不悬浮、不吸顶,滚动时跟着标题栏常驻)。详情档是「删除 · 归档/恢复 · 标记重点 · **修改**」,修改与新增档是「取消 · **保存/添加**」,主按钮永远在最右、危险动作在最左,按钮文字不再重复对象名(标题栏已经写了是哪个项目/条目)。附表的写入另放一处:**绿虚线 = 附表 · 更新记录**条仍留在它自己的附表标题下面,只有「+ 录一笔「某周期」执行记录 / 交付记录」,点它跳到「更新录入」并自动带上该项目与顶栏当前选中的周期。附表的写入统一走更新录入(粘贴原文 → AI 整理 → 确认写入),抽屉里不另做一套表单,避免两条路写出两份数据。基础信息的按钮在标题栏、附表的更新按钮在附表上方,两类按钮不在同一个位置混着放;编辑与新增档的报错信息显示在正文最上方;周期反馈上方的 按周/按月 + 本周/近 4 周/… 标成「查看范围(只读筛选)」,只翻看不改数据 |
|
||||
| **改名** | 改名就是改基本信息:在详情面板点「修改」,表单第一行即项目名称(项目管理与定开项目同一套逻辑)。名称非空校验 + 重名检测,失败信息显示在面板正文最上方,不弹提示跑路 |
|
||||
| **负责人与团队** | **多负责人只适用于重点项目**:重点项目可以指定**多个负责人**与**团队成员**,定开项目只有一个**交付负责人**(单人下拉)外加**团队成员**。人名一律从人力资源库下拉里选。**界面上负责人不分主次**:名单横向排开自动换行,每一位都带 × 可删(没有「主」标记、没有不给删的首行),「+ 添加负责人 / + 添加成员」跟在名单末尾。名单只在详情抽屉的「修改」档维护;只读处一律一排对等的小标签:重点项目的列表与详情把负责人摆成对等的一排,定开项目的列表与详情只显示一个交付负责人加团队成员标签。存储与统计口径不变:**重点项目 `owner` 字段仍是 `owners[0]`**(删掉第一位就由后一位顶上),看板、导出、人力负载与 KPI 按它归属,修改档的提示行写明了这点;重点项目**所有负责人都算命中**,定开项目按交付负责人命中;团队成员不参与该筛选 |
|
||||
| **归档** | 项目从看板与列表默认视图中隐藏,数据完整保留;勾选「含归档」可查看,随时可恢复 |
|
||||
| **删除** | 高危操作:弹窗列出将连带删除的子任务数与执行记录数,并且必须**逐字输入项目名称**,「永久删除」按钮才会点亮。**删除后不可恢复**,仅想隐藏请用归档 |
|
||||
|
||||
> 定制项目的「项目明细」表同理:列表只读,操作列只有 详情 / 修改 / 归档,改名 / 名单 / 删除都在抽屉里做。
|
||||
> 定开项目的「项目明细」表同理:列表只读,操作列只有 详情 / 修改 / 归档,改名 / 名单 / 删除都在抽屉里做。
|
||||
|
||||
#### 项目合并
|
||||
|
||||
把两个项目合并成一个(例如把「智空无人机平台」并入「智飞无人机平台」):
|
||||
|
||||
```bash
|
||||
python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智飞无人机平台" --dry-run
|
||||
python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智飞无人机平台"
|
||||
python scripts/merge_project.py --from "智空无人机平台" --to "智飞无人机平台" --dry-run
|
||||
python scripts/merge_project.py --from "智空无人机平台" --to "智飞无人机平台"
|
||||
```
|
||||
|
||||
- 子任务同名 → 归并到目标项目的同名子任务,执行记录一并转挂
|
||||
|
|
@ -288,20 +149,17 @@ python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智
|
|||
- 合并后按最新记录回算目标项目的进度与状态
|
||||
- 执行前建议备份:`cp data/board.db data/board.db.bak`
|
||||
|
||||
### 3. 定制项目
|
||||
### 3. 定开项目
|
||||
|
||||
三个页签,都跟着顶栏周期走:**项目总览**(默认)· **本周进展** · **年度任务**。
|
||||
统计条与年度任务只认 `GET /api/custom/finance` 一个数据源,口径见「财务统计口径」。
|
||||
|
||||
| 页签 / 模块 | 说明 |
|
||||
| 模块 | 说明 |
|
||||
|---|---|
|
||||
| **项目总览** | 标题栏下一排统计条:已下单项目/合同额、本季度下单、本年新增下单、本季度验收、本年验收(金额按「万」显示,脚注项目数)。下面是按更新时间倒序的**只读**总表:项目名称 / 项目ID / 下单时间 / 项目归属 / 办事处 / 行业 / 市场下单人天 / 订单金额 / 市场责任人 / 项目状态 / 进度 / 验收时间 / 推动验收计划 / 风险值 / 更新时间;下单时间、订单金额、更新时间三列表头可点着排序。筛选只有关键字 + 归属 + 区域 + 项目状态 + 风险值。台账里认不出的写法(下单时间识别不了、已验收没填验收年度)在标题栏挂一枚提示标签,不挡事 |
|
||||
| **本周进展** | 更新时间落在顶栏选中周期内的项目;统计条给「验收情况 / 新增项目 / 进行中项目」,其中新增与验收和工作看板右栏共用同一套口径(`customWeeklySections`),两处数字必然一致 |
|
||||
| **年度任务** | 四个季度的计收目标(万元)与完成情况对照。完成额按「验收年度 + 验收季度」归集、下单按下单时间所在季度归集,跨年不会串;默认只读,点「编辑」才能改,改数字实时重算完成率与合计,保存走 `PUT /api/custom/annual-targets?year=` |
|
||||
| **详情抽屉** | 分「详情 / 修改」两档:详情只读(基础信息 + 收入确认四联卡 + 开票 / 回款行内输入 + 交付记录 + 阶段流转时间线),修改才给表单(名称、手动确认比例、交付环节日期、区域、**验收年度 + 验收季度**成对填写、开票与回款金额)。交付负责人是单人下拉,从人力资源库里选;「添加交付记录」在交付记录区里,一个弹窗录本周期一条 |
|
||||
| **归档** | 归档后不再出现在总览与统计中,历史周期记录完整保留,随时恢复 |
|
||||
| **交付流水线**(默认页签) | 卡头给「在库 N 个 · 重点 N 个 · 本期更新 N 个」,漏斗本身按环节给项目数与金额(页签上不再叠一条全局 KPI 带,金额与项目数按环节累计);「入库 → 签单 → 交付 → 验收 → 计收」五段漏斗,每段给项目数与金额;口径为**商务阶段 + 已录环节日期**取先到哪一步算哪一步(环节日期还没补全时由商务阶段兜底)。下方「卡点项目」列出最后一个**有日期**的环节停留超过 `CUSTOM_STEP_AGING_DAYS`(默认 45)天且尚未计收的项目,可一键「处理」跳到详情抽屉补录 |
|
||||
| **阶段看板** | 按「商机 → 已签单 → 开发中 → 交付完成 → 已验收 → 已计收 → 暂停/异常」分列展示,卡片带金额、区域、开发进度、可确认收入;列头显示项目数与金额合计。卡片只是入口,点卡片开详情抽屉;卡上的 ★ 只读(重点标记在详情面板的基础信息区改),外层不做任何直接写入 |
|
||||
| **财务跟踪** | 页签内一排 KPI:合同总额 / 按进度可确认收入 / 已计收 / 待计收 / 已开票 / 已回款 / 待开票 / 待回款(各带比例脚注);再往下是阶段金额分布、周期活跃度、按负责人与区域汇总、待回款排行。财务口径的汇总只在这一页出现,环节与账期一屏对齐,方便财务逐月对账 |
|
||||
| **项目明细** | 表头一行给出当前列表的合同额 / 可确认 / 已计收 / 开票 / 回款合计;按入库时间倒序的**只读**总表:区域 / 负责人 / **入库 · 签单 · 交付 · 验收日期** / 阶段 / 合同额 / 进度 / 可确认 / 已计收 / **开票 / 回款**(金额列统一以「万」计)/ 备注;改数据点行尾「修改」 |
|
||||
| **详情抽屉** | 分「详情 / 修改」两档:详情只读,修改才给表单(含项目名称、手动确认比例、**交付环节五个日期**、区域下拉、**开票与回款金额**)+ 收入确认卡 + 周期执行记录 + 阶段流转时间线。负责人从人力资源库里选。基础信息的动作在标题栏按钮条上(修改/保存,正文里标明不会动下面的交付记录),开票与回款金额跟着标题栏的「保存」一起提交;附表的绿虚线条(「+ 录一笔」跳更新录入 · 定开项目并带上项目与周期)留在附表标题下 |
|
||||
|
||||
### 4. 每周工作(重点工作清单)
|
||||
### 4. 每周重点工作
|
||||
|
||||
不值得建项目档案的短期活儿:一条就是一个活儿,不用先建项目,录进来就能按周跟踪。
|
||||
|
||||
|
|
@ -311,19 +169,13 @@ python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智
|
|||
| 列表 | 工作内容 / 说明(截断预览)/ 预计完成时间(下面小字标「录入 X月第N周」)/ 状态(标了延期且没完成的挂红色「延期」徽章)/ 更新日期 / 操作 **详情 · 修改 · 归档 · 删除**——和两张项目列表同一套规矩:列表只读,行内不放输入框 |
|
||||
| 筛选 | **本周 / 延期 / 已完成 / 全部** 四个堆(chip 上实时显示各堆条数)+「含归档条目」;顶栏切周即换基准周,工具栏标明「本周/延期按录入周统计」;顶部全局搜索同时匹配工作内容与说明 |
|
||||
| 详情抽屉 | 同样分「详情 / 修改」两档,**基础信息的按钮全在抽屉标题栏右侧的按钮条上**:详情档是「删除 · 归档 · **修改**」,修改与新增档是「取消 · **添加/保存**」,报错信息显示在正文最上方。点「修改」才出表单,**录入周只读**(改预计完成时间不会把条目搬去别的周)。重点工作条目没有附表,所以抽屉里不出现绿的更新条 |
|
||||
| 删除 | 列表行与抽屉顶部都能删,走同一个确认弹窗,并提示「只是这周不再跟进?请改用归档」。条目不挂子任务与执行记录,**不要求逐字输入名称**——逐字输入项目名称只用在项目管理与定制项目的项目删除上 |
|
||||
| 删除 | 列表行与抽屉顶部都能删,走同一个确认弹窗,并提示「只是这周不再跟进?请改用归档」。条目不挂子任务与执行记录,**不要求逐字输入名称**——逐字输入项目名称只用在项目管理与定开项目的项目删除上 |
|
||||
| 导出 | 右上角「导出 Excel」→ `GET /api/export/focus`,带上当前筛选条件 |
|
||||
| 联动 | 工作看板左栏**第一组**「本周工作重点」与 KPI「本周重点工作」读的就是这张表;看板右栏点条目给只读详情,改内容走抽屉 |
|
||||
|
||||
分堆口径(基准周 = 顶栏选中的那一周,一律按**录入周**算,和预计完成时间无关):录入周**等于**基准周 → **本周**;录入周**早于**基准周且「是否延期」打开且未完成 → **延期**(上周及更早没做完的活儿结转进来);状态为「已完成」→ **已完成**(交叉视图,条目仍留在自己那一周)。
|
||||
「更早周次录入、没标延期又没完成」的条目不进当周视图,只在**全部**里查得到——所以每周收尾时,没做完的记得勾上「延期」,它才会结转进下周。库里不存「逾期」字段,延期是人工开关。
|
||||
|
||||
### 5. 权限管理
|
||||
|
||||
`角色 × 菜单` 授权矩阵、账号与角色分配、在线会话、操作审计四个区块,一个页面四个页签。
|
||||
权限模型、内置角色与防锁死规则见「权限(RBAC)」,这里不重复。
|
||||
只有拿到 `rbac` 可编辑的账号能看到这个菜单。
|
||||
|
||||
### 人力资源库
|
||||
|
||||
侧栏「人力资源」,是全系统**负责人姓名的唯一来源**(`staff` 表)。
|
||||
|
|
@ -331,12 +183,12 @@ python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智
|
|||
| 区块 | 说明 |
|
||||
|---|---|
|
||||
| 顶部 KPI | 在册人数与带项目人数、各归属小组人数、人员归属(汇智 / 云数 / 外服)分布,以及**花名册外的负责人**核对(历史数据里对不上花名册的人名,一个都不藏) |
|
||||
| 花名册 | 姓名 / 归属小组 / 人员归属 / 说明 + 该人的**在管项目数、定制项目数、定制合同额、名下待计收、最近更新**;小组与归属可行内改(下拉),说明行内编辑失焦即存 |
|
||||
| 花名册 | 姓名 / 归属小组 / 人员归属 / 说明 + 该人的**在管项目数、定开项目数、定开合同额、名下待计收、最近更新**;小组与归属可行内改(下拉),说明行内编辑失焦即存 |
|
||||
| 筛选与导出 | 在编 / 已归档 / 全部 + 按小组筛选;「导出 Excel」按当前筛选导出 |
|
||||
| 新增 | 弹窗录入:姓名必填且全库唯一,小组与归属下拉取自 `constants.STAFF_GROUPS` / `STAFF_AFFILIATIONS` |
|
||||
| 改名 | 走「编辑」改姓名时,**名下项目与定制项目的负责人、其他负责人、团队成员一并同步改掉**,历史数据不会断链 |
|
||||
| 改名 | 走「编辑」改姓名时,**名下项目与定开项目的负责人、其他负责人、团队成员一并同步改掉**,历史数据不会断链 |
|
||||
| 归档 / 恢复 | 归档后不再出现在「负责人」下拉里,但历史项目仍完整保留其负责人;随时可恢复。离职人员用归档,不要用删除 |
|
||||
| 删除 | 名下还挂着项目或定制项目时接口直接返回 400 并说明原因,防止把在管项目变成无主项目 |
|
||||
| 删除 | 名下还挂着项目或定开项目时接口直接返回 400 并说明原因,防止把在管项目变成无主项目 |
|
||||
|
||||
导入名单(表头按名称匹配:序号 / 姓名 / 归属小组 / 人员归属 / 说明):
|
||||
|
||||
|
|
@ -344,33 +196,31 @@ python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智
|
|||
python scripts/import_staff.py --dry-run # 只看解析结果
|
||||
python scripts/import_staff.py # 增量导入(同名跳过,不覆盖页面上的编辑)
|
||||
python scripts/import_staff.py --reset # 清空后重新导入
|
||||
python scripts/import_staff.py <xlsx> # 指定别的文件(不会随启动自动导入)
|
||||
python scripts/import_staff.py <xlsx> # 指定别的文件;首次运行 ./run.sh 会自动导入
|
||||
```
|
||||
|
||||
> 不传路径时默认读 `data/import/软件开发部人员名单.xlsx`,也可以用 `STAFF_XLSX` 环境变量指定。
|
||||
|
||||
**负责人下拉**(`ownerSelectHtml`)在项目新建/详情、定制项目新建/详情、工作看板等位置统一使用,选项来自花名册:
|
||||
**负责人下拉**(`ownerSelectHtml`)在项目新建/详情、定开项目新建/详情、工作看板等位置统一使用,选项来自花名册:
|
||||
已归档的人不再作为可选项出现,只有他本来就是这条记录的负责人时才带「(已归档)」标注出现一次;
|
||||
历史数据里花名册没有的人名同样补一个「(不在花名册)」选项,保证打开老项目不会把负责人改没。
|
||||
**多负责人与团队成员**复用同一个下拉(`peopleEditorHtml`,现在只有重点项目的抽屉用它):人名下拉**横向排开、自动换行**,选项同样只有花名册里的人,所以新增成员不需要另外维护一份名单;名单里的每一位都带 × 可删,界面上不区分主次。定制项目的负责人是普通的单个 `ownerSelectHtml` 下拉,只有团队成员用这套名单编辑器。
|
||||
**多负责人与团队成员**复用同一个下拉(`peopleEditorHtml`,现在只有重点项目的抽屉用它):人名下拉**横向排开、自动换行**,选项同样只有花名册里的人,所以新增成员不需要另外维护一份名单;名单里的每一位都带 × 可删,界面上不区分主次。定开项目的负责人是普通的单个 `ownerSelectHtml` 下拉,只有团队成员用这套名单编辑器。
|
||||
|
||||
### 入库时间
|
||||
|
||||
定制项目新增「入库时间」字段,当前口径为 **该项目最早记录所在周期的第一天(周一)**:
|
||||
定开项目新增「入库时间」字段,当前口径为 **该项目最早记录所在周期的第一天(周一)**:
|
||||
|
||||
- 优先取原始《项目明细表》台账中该项目所在的周(该列是稀疏填写的,导入时按周分组向下继承)
|
||||
- 台账没有的,取《周工作情况总结》「定制开发」块中该项目首次出现的周
|
||||
- 再没有,依次退回 custom_updates 最早记录周期 → 项目所属周期 → 记录创建日期
|
||||
|
||||
周期换算规则:第 1 周 = **第一个周四落在本月的那一周**(见上「周期口径」),第 N 周顺延 `7×(N-1)` 天,取该周周一。
|
||||
例如 `2026年8月第4周` → `2026-08-24`(8 月第 1 周是 08/03–08/09);`2026年9月第1周` → `2026-08-31`(周一在上个月,照样算 9 月第 1 周)。
|
||||
周期换算规则:以**该月第一个周一**所在周为第 1 周,第 N 周顺延 `7×(N-1)` 天。
|
||||
例如 `2026年8月第4周` → `2026-08-24`(2026-08-01 是周六,第一个周一是 08-03)。
|
||||
|
||||
字段可在明细表中直接改,也可在抽屉里改;重新计算用:
|
||||
|
||||
```bash
|
||||
python scripts/legacy/add_entry_date.py --dry-run # 预演
|
||||
python scripts/legacy/add_entry_date.py # 回填(跳过已有值)
|
||||
python scripts/legacy/add_entry_date.py --force # 全部重算
|
||||
python scripts/add_entry_date.py --dry-run # 预演
|
||||
python scripts/add_entry_date.py # 回填(跳过已有值)
|
||||
python scripts/add_entry_date.py --force # 全部重算
|
||||
```
|
||||
|
||||
### 区域(省级行政区)
|
||||
|
|
@ -380,68 +230,22 @@ python scripts/legacy/add_entry_date.py --force # 全部重算
|
|||
- 历史数据里若出现「内蒙古自治区」这类非规范写法,保存时会自动归一为「内蒙古」
|
||||
- 早期从项目名推断的区域(`infer_region`)与标准列表口径一致,无需迁移
|
||||
|
||||
## 权限(RBAC)
|
||||
|
||||
侧栏每个菜单都是一个权限点,**授权 = 角色 × 菜单 × 级别**;账号不直接挂菜单,只挂角色。
|
||||
|
||||
| 概念 | 取值 | 说明 |
|
||||
|---|---|---|
|
||||
| 菜单 | `board` 工作看板 · `projects` 自研产品 · `custom` 定制项目 · `focus` 每周工作 · `staff` 人力资源 · `intake` 更新录入 · `settings` 设置 · `rbac` 权限管理 | 见 `constants.MENUS`,顺序即权限页里的列顺序 |
|
||||
| 级别 | 空 = 看不到 / `ro` 只读 / `rw` 可编辑 | 没授权的菜单侧栏不出现,接口也进不去;`ro` 能看列表与详情,所有写接口一律 403 |
|
||||
|
||||
- **多角色取并集、同级取高**:一个账号可挂多个角色,同一菜单只要有一个角色给了 `rw` 就是 `rw`(`constants.merge_levels`)。
|
||||
- **双端校验**:前端 `can()` / `canW()` 只负责把按钮藏起来,真正的门在接口上——
|
||||
每个路由都挂了 `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`、`POST /api/custom/ai/parse`、`POST /api/custom/ai/commit`
|
||||
按 **custom / intake 两者中较高的级别**判定——只有「更新录入 rw」的账号也能录入定制项目;
|
||||
定制本体(详情 / 新建 / 修改 / 归档)仍严格走 custom。新增这类跨菜单读接口要同步改 `security.guard` 的 assist 白名单。
|
||||
- **内置角色**:`管理员`(全部 `rw`)、`部门成员`(业务菜单 `rw`,设置与权限只读/无)、`只读访客`(除权限外全部 `ro`),
|
||||
`is_builtin` 标记,不能删除。
|
||||
- **不会被锁死**:系统始终保证至少有一个「启用 + 权限管理可编辑」的账号;
|
||||
一个都没有时 `security.ensure_seed` 会把「管理员」角色补给最早的账号并在启动日志里提示。
|
||||
- **改权限即踢会话**:改角色授权 → 踢掉该角色下所有账号的会话;改/停账号 → 踢掉该账号的会话。
|
||||
旧 token 不会继续带着旧权限跑。
|
||||
- **会话**:登录发 32 位随机 token,存 `user_sessions`(有效期 `SESSION_DAYS`,默认 30 天),
|
||||
只通过 `HttpOnly` Cookie `unis_session` 下发(JS 读不到,前端不存 token);
|
||||
权限管理页可查看全部在线会话并单独吊销。
|
||||
- **操作审计**:写操作与登录 / 登出 / 越权都落 `audit_logs`(谁、什么时间、哪个菜单、什么动作、返回码、IP),
|
||||
权限管理页可按菜单、动作、天数筛选。
|
||||
- 首个管理员账号来自 `.env` 的 `ADMIN_USERNAME` / `ADMIN_PASSWORD`(默认 `admin` / `admin123`,登录后请立刻改密码)。
|
||||
|
||||
## 界面设计语言
|
||||
|
||||
前端是 Vite 构建的 React + TypeScript 应用(源码 `web/src/`,Ant Design 出控件、Tailwind v4 出工具类、项目 token 出一切视觉值)。设计口径固定如下,新增页面请沿用:
|
||||
前端是零构建的原生 JS(`web/index.html` + `web/styles.css` + `web/app.js` + `web/icons.js`),设计口径固定如下,新增页面请沿用:
|
||||
|
||||
- **Token 只有一个来源**:颜色 / 圆角 / 阴影 / 间距 / 控件高度 / 层级 / 动效时长全部在 `web/src/styles/tokens.css` 顶部的 `:root`(`--text*`、`--surface-*`、`--primary*`、`--success/--warning/--danger`、`--radius-*`、`--sp-*`、`--ctrl-h-*`、`--z-*`、`--dur-*`)。组件里不再出现第二套 hex;业务数据色(项目分类色、阶段色)由 `web/src/domain/ink.ts` 的 `INK` 常量注入 `style={{ "--c": ... }}`,JS 模板里不写裸色值。文本对比度按 WCAG AA(≥4.5:1)取值。
|
||||
- **tinted 底板只有一个算法**:`.pill` / `.tag-mini` / `.arch-badge` 只吃 `--c`,底色与文字色在 CSS 里用 `color-mix()` 派生;旧的「背景 hex + 文字 hex」成对写法已废,新增状态标签照 `--c` 办理。
|
||||
- **弹层与焦点一条路**:一律用 AntD @B@Modal@B@ / @B@Drawer@B@(自带 @B@role="dialog"@B@、焦点陷阱、Escape 关闭、关闭后焦点归还触发元素),不再手写弹层与焦点栈;抽屉里再开弹窗由 AntD 的层级接管。图标按钮必须有 @B@aria-label@B@(@B@title@B@ 不算名字)。
|
||||
- **新增 / 修改一律右侧侧滑**:表单类面板统一走 @B@components/FormDrawer.tsx@B@(头部 @B@.dlg-title@B@ + 可选副标题、正文 @B@.drawer-body@B@、底部固定「取消 + 保存/创建」右对齐、层内错误用行内 @B@Alert@B@、提交中按钮 loading 且不许 Esc 关闭);**删除等破坏性确认仍用 @B@modal.confirm@B@**(危险按钮 danger),不要为了统一把确认框也做成抽屉。窄屏 (<=640) 表单抽屉给全宽。
|
||||
- **录入字段跟着「更新录入」走**:同一个对象在各模块里的表单字段与「更新录入」入口一致(自研:执行内容(正文,原文照录)/ 一句话摘要 / 总进度 / 整体状态 / 风险 / 阻塞 / 下一步计划;定制:执行内容 / 项目状态 / 开发进度(%)/ 本期新增计收(万元)/ 本期新增下单(万元)/ 一句话摘要 / 风险 / 阻塞 / 下一步计划)。模块特有的轴(自研的「子任务」)可以多不能少;措辞改了要四处一起改。
|
||||
- **正文富文本一套约定**:「内容」这类正文支持加粗 / 下划线 / 斜体 / 语义色,用 `components/RichEditor.tsx`,内核是 **Tiptap 3(ProseMirror)**:回车分块、选区、中文输入法、撤销栈这几件事手写 contentEditable 反复出问题,交给成熟的编辑器内核。工具栏是我们自己排的(Tiptap 是 headless,样式跟着 NEX 走):**图标按钮** 加粗 / 斜体 / 下划线 + **颜色按钮(A + 当前色条 + ▾,弹出色板:只有色块不写中文,名称在 title / aria-label 里,第一个是「无色」= 摘色)** + 清除格式;图标进唯一图标层 `icons/paths.ts`(bold / italic / underline / eraser / chevron-down),不自建第二套图标。颜色是挂在自己写的 `data-c` 属性上的语义色 mark(**不用官方 Color,因为它存 hex,会脱离主题 token**),重复上色是替换语义;
|
||||
产出只写 `<b>/<i>/<u>`(加粗斜体特意扩展成短标签,`<strong>/<em>` 只收不发);**回车 = 一行一段 `<p>`**(Shift+回车 = 行内 `<br>`),空行存 `<p><br></p>`——不带 `<br>` 的空段落在展示端没有行盒,编辑看得见、看着看不见就又不一致了;
|
||||
三端换行口径统一:一个块级 = 一个换行(`utils/richtext.richToText` 用 DOM 走一遍,`app/export.py.plain()` 先把相邻 `</p><p>` 合成一个换行),别拿「开标签闭标签各断一次」那种写法,否则每行后面凭空多一个空行,展示一律 `components/RichText.tsx`(先消毒再注入);<b>项目里所有长文本录入都用这一个组件</b>(执行/交付记录正文、风险 / 阻塞、下一步计划、定制备注、重点工作说明与结果反馈、更新录入的原始内容与整理结果正文),单行字段(摘要、工作内容)保持普通输入框。<b>列表里的预览不要再按字数硬切</b>——那会把富文本压成纯文本,用户会以为格式没生效;改成 `<RichText className="clamp"/>` 两行截断,格式留着。存储就落在原来的 `content` 文本列里,只允许 `<b> <i> <u> <br> <span data-c="danger|warning|primary|success|muted">`;颜色存**语义名**不存 hex,渲染时映射回 `var(--*)` token,改主题会跟着变。要纯文本的地方(关键字匹配、截断、AI、Excel)走 `utils/richtext.ts` 的 `richToText` / 后端 `app/export.py` 的 `plain()`。「原始内容」粘贴框同样是富文本,但发给解析器 / AI 的那一份先转回纯文本——规则解析按行找「风险 / 下一步」,标记会打断它;入库的正文仍带标记。
|
||||
- **状态不只靠颜色**:选中 / 按下 / 当前项写 `aria-current` / `aria-selected` / `aria-pressed`,CSS 用属性选择器出强调条与勾选图标;可排序表头是 `<th aria-sort>` + `.th-sort` 按钮,页签组是 `role="tablist"` + `.tabpanel`。
|
||||
- **加载与忙态统一**:列表 / 卡片占位用 AntD `Skeleton`(`<TableSkeleton/>` / `<CardSkeleton/>`,不写「加载中…」文本),取数一律 `useAsync()`(自带竞态守卫 + `loading` / `error`);耗时动作 `loading` / `disabled` + `aria-busy`,导出走 `download(url, btn, message)`;结果只经 `message`(AntD App 上下文,`role="status"`),表单错误槽是 `<Alert role="alert">`。
|
||||
- **断点登记在 CSS 顶部注释**:1180(周看板转单栏)/ 1100(侧栏转抽屉)/ 900(顶栏换行、抽屉全宽)/ 780(表单与人员卡换行)/ 640(触控尺寸、弹窗转底部抽屉)。CSS 不能在 `@media` 里用 `var()`,改断点必须同步那条注释。动效一律 ≤280ms 且尊重 `prefers-reduced-motion`;`forced-colors` 下兜底焦点环。
|
||||
- **禁用「彩色描边」**:卡片、列表、步骤条、表格一律中性灰边框(`--border` / `--border-strong`)或无边框,不用圆角多色边框表达状态。
|
||||
- **重点色只出现在三处**:图标、关键数字/文本、小面积 tinted 底板(`.ic-badge`、`.tag-mini`、`.kpi.accent-*`)。状态色(`statusMeta`)与阶段色(`stageMeta`)是唯一配色来源,避免各页面自己调色。
|
||||
- **图标系统**:`web/src/icons/` 内置 52 个 24×24 线性 SVG(每个都被界面或状态/阶段/标题映射引用,死图标随手删),`stroke=currentColor`,颜色跟着文字走。对外 API:
|
||||
`<Icon name="wallet" />` 裸图标;`<IconBadge />` 图标 + tinted 底板(KPI 用);`<StatusIcon/>` / `<StageIcon/>` / `<PipeIcon/>` 按状态·阶段·交付环节取图标;
|
||||
`nameOfStatus()` / `nameOfStage()` / `nameOfPipe()` 出图标名;`iconForTitle()` / `iconForEmpty()` 按关键词挑图标。
|
||||
- **自动图标**:`iconForTitle()` 在渲染期按标题关键词给 `<PanelCard title>` / `<SectionTitle>` 补前导图标(旧版是 `MutationObserver` 全局扫 DOM,现在组件自己算,没有副作用);标题里**自带** `<Icon />` 时不再补第二个。
|
||||
- **图标系统**:`web/icons.js` 内置 50 个 24×24 线性 SVG,`stroke=currentColor`,颜色跟着文字走。对外 API:
|
||||
`svg(name)` 裸图标;`badge(name)` 图标 + tinted 底板(KPI 用);`status()` / `stage()` / `pipe()` 按状态·阶段·交付环节取图标;
|
||||
`nameOfStatus()` / `nameOfStage()` / `statusBadge()` 出文案与徽标;`hydrate()` 填 `[data-icon]`;`auto()` 自动补前导图标;`names()` 列全部图标名。
|
||||
- **自动图标**:`auto()` + `MutationObserver` 在每次渲染后按标题关键词给 `.card-head h4` / `.sec-title` / `.kcol-title` / `.wk-group-head` / `.notice` / `.empty` 加前导图标,并填充 `[data-icon]`;用 `data-ico` 属性防重复,标题里**自带** `<svg class="ic">`(如阶段看板按阶段取图标)时跳过自动补图,不会出现两个图标。新增区块只要标题里带对应关键词就自动带图标,不用手写。
|
||||
- **阶段看板列头不带色条**:列头用 `Ico.stage(code)` + `--c` 注入阶段色(`.kcol-title .ic { color: var(--c) }`),早期那种 `border-top:3px solid 阶段色` 的彩条已去掉。
|
||||
- **交付环节图标按 `code` 取**:后端 `CUSTOM_PIPELINE` 下发的字段是 **`code`**(不是 `key`),前端一律 `Ico.pipe(s.code)`;写成 `s.key` 会静默退化成通用圆点。
|
||||
- **表格防竖排**:标签(`.pill` / `.tag-mini`)与列头一律 `white-space:nowrap`,容易挤窄的列(区域、负责人)在 `columns` 上加 `className: "nowrap"`;宽表交给 AntD Table 的 `scroll={{ x }}` 横向滚动 + 操作列 `fixed: "right"`,不给它换行挤成一竖。
|
||||
- **表格防竖排**:`table.tbl th` / `.pill` / `.tag-mini` 统一 `white-space:nowrap`,容易挤窄的列(区域、负责人)在 `<td>` 上加 `class="nowrap"`;实在挤不下交给 `.tbl-wrap { overflow:auto }` 横向滚动。
|
||||
- **抽屉不被内容撑破**:`.form-row > div { min-width: 0 }`(grid 子项默认 `min-width:auto`,会被交付环节步骤条撑出整表横向滚动),步骤条本身 `flex:1 1 132px`(132px = 日期输入框含日历图标的最小可用宽度)。
|
||||
- **报错一律中文**:Pydantic 422 与未捕获 500 在 `app/main.py` 的 exception handler 统一换成中文 `detail`(「提交的数据有误:…」/「服务器内部错误…」),前端 `api()` 原样 toast,界面不中英夹杂。新增 `/export/*` 必须登记 `security.EXPORT_MENU` 权限归属,未登记一律 403(fail-closed,防「忘挂权限 = 登录即可下载」)。
|
||||
- **反馈矩阵(只有这三条通道)**:弹窗内报错 → `modalError()`(`#mErr` 行内提示);抽屉表单报错 → `formError("fdErr|cdErr|dwErr", msg)`(行内提示,传空串清除);其余一律 `toast()`;破坏性动作只走 `confirmDialog()`。异步写处理器先本地 try/catch 提示并**中断后续刷新/重开**,全局 `unhandledrejection` 兜底只兜漏网之鱼。
|
||||
- **弹窗主按钮文案**:新建=`创建`、编辑=`保存`、动作确认=`确认+动词`(确认下线 / 确认清空);提交即 `disabled` 防重复提交,失败恢复。危险动作的触发按钮用 `.btn.danger` / `.icon-btn.danger`,配套 `confirmDialog({danger:true})`。
|
||||
- **删除 vs 归档的确认分级**:删除 / 清空 / 强制下线 = 破坏性 → `confirmDialog({danger:true})` + 红色触发钮;归档 / 恢复 = 可逆 → **直接切换 + toast**(自研项目、每周工作、人员花名册均如此)。唯一例外:**定制项目归档要确认**(warn 级,不带 danger)——归档会把它从财务统计与下单/验收口径里摘除,影响数字,值得一次停留。
|
||||
- **关键字搜索全应用一个行为**:页内搜索框(`bindKeyword`)与顶栏全局搜索同为 **320ms 防抖实时查询**,共用 `state.keyword`,不再区分回车/实时两套。列表卡头「共 N 条」一律取**过滤后**条数,与分页器一致。
|
||||
- **归档过滤统一**:自研产品 / 重点工作 / 定制项目用「含归档」`switch` 开关(`state.showArchived` / `focusArchived` / `customArchived`=`false|all`),人员花名册用三态下拉(在用 / 已归档 / 全部,导出跟随同一状态)。
|
||||
|
||||
> 备注:历史遗留的 `.pcard`、`.board-grid`、`.svg-chart`、`.legend`、`.risk-item` 等零引用样式已随死代码清理删除(2026-10-29)。
|
||||
> 备注:`styles.css` 里的 `.pcard`、`.board-grid` 当前没有任何 JS 引用(历史遗留样式),此处只做记录,未删除。
|
||||
|
||||
## 数据导出
|
||||
|
||||
|
|
@ -449,45 +253,18 @@ python scripts/legacy/add_entry_date.py --force # 全部重算
|
|||
|
||||
| 位置 | 导出内容 | 接口 |
|
||||
|---|---|---|
|
||||
| 定制项目 | 定制项目明细(含区域、金额、进度、收入确认、入库时间、备注 + 合计行) | `GET /api/export/custom` |
|
||||
| 定制项目 | 定制项目周期记录(「项目总览」工具条「导出周期记录」,按顶栏所选周期 / 月份) | `GET /api/export/custom-updates` |
|
||||
| 项目管理 | 项目管理清单(**跟随页面全部筛选**:分类 / 关键字 / 负责人 / 只看未更新(+顶栏周期) / 归档) | `GET /api/export/projects` |
|
||||
| 工作看板 | 本周期(或本月)的执行记录明细(工具栏「导出 Excel」;跟随顶栏周期与搜索框关键字,不受负责人筛选影响) | `GET /api/export/updates` |
|
||||
| 每周工作 | 重点工作清单(工作内容 / 说明 / 预计完成时间 / 录入周 / 执行状态 / 是否延期 / 结果反馈 / 更新) | `GET /api/export/focus` |
|
||||
| 人力资源库 | 花名册(跟随小组 / 关键字 / 归档筛选;含在管 / 定制项目数、合同额、待计收) | `GET /api/export/staff` |
|
||||
| 定开项目 | 定开项目明细(含区域、金额、进度、收入确认、入库时间、备注 + 合计行) | `GET /api/export/custom` |
|
||||
| 定开项目 | 定开项目周期记录 | `GET /api/export/custom-updates` |
|
||||
| 项目管理 | 项目管理清单(分类、负责人、状态、标签、子任务数等) | `GET /api/export/projects` |
|
||||
| 工作看板 | 本周期(或本月)的执行记录明细 | `GET /api/export/updates` |
|
||||
| 每周重点工作 | 重点工作清单(工作内容 / 说明 / 预计完成时间 / 录入周 / 执行状态 / 是否延期 / 结果反馈 / 更新) | `GET /api/export/focus` |
|
||||
| 人力资源库 | 花名册(含在管 / 定开项目数、合同额、待计收) | `GET /api/export/staff` |
|
||||
|
||||
导出的 xlsx 带表头样式、冻结首行、自动筛选,金额列按千分位格式;文件名含导出日期。
|
||||
|
||||
## 财务统计口径
|
||||
|
||||
定制项目的金额统计全部收敛在 `app/finance.py`,页面、工作看板、导出都从它取数,**不存在第二套算法**。
|
||||
|
||||
| 口径 | 认定方式 |
|
||||
|---|---|
|
||||
| 已下单 | 只看项目归属:`origin ∈ {华智下单, 存量项目, 汇智直签}`;`提前交付` 不算下单 |
|
||||
| 下单归属季度 / 年度 | `sign_date` 的 `YYYY-MM` 前缀;认不出年份的计入 `kpi.sign_unknown`,页面上提示补录 |
|
||||
| 验收归属季度 / 年度 | **只认 `accept_year` + `accept_date`(Q1~Q4)**;`accept_date_real` 已停用,不再参与统计 |
|
||||
| 未分季 | 认得出年份、认不出季度的行(`sign_date` 残缺成「2024/」、或只有 `accept_year` 没有 `accept_date`):计入年度,年度任务表里单列「未分季」一行 |
|
||||
| 计收 | 累计看主档 `revenue_amount`;本周期新增看 `custom_updates.revenue_delta` 之和 |
|
||||
| 金额单位 | 项目金额一律 **元**;年度计收目标一律 **万元**(`wanVal()` 录入时换算,接口按字段名区分) |
|
||||
|
||||
- 统计范围跟顶栏周期走:`?period_id=` 看一周,`?year=&month=` 看一月,季度由月份自动归(`quarter_of_month`)。
|
||||
跨季度、跨年度只以 `context.year` / `context.quarter` 为准,不会因为库里存在别的年份就串到别的季度去。
|
||||
- **年度计收目标**(`GET|PUT /api/custom/annual-targets?year=`):**存过就以库里为准**,某季度清空即 0;
|
||||
完全没配过的年份才回落到 `constants.CUSTOM_ANNUAL_TARGETS_DEFAULT`。目标值写非数字返回 400。
|
||||
- 验收年度与季度成对校验:只给其中一个 → 400,避免出现「有 Q3 没年份」这种没法归类的行。
|
||||
- **年度任务表的不变式**:`四个季度 + 未分季 = 合计 = KPI 年度`(下单、验收两条口径都成立)。
|
||||
历史库里确实有「有年份没季度」的行,早期版本会让它们从季度表里静默消失,
|
||||
于是同一屏上「合计」比 KPI 年度少一笔;现在单列一行,既不丢数也不硬塞进某个季度。
|
||||
`annual.unscheduled` 给出笔数与金额,`kpi.sign_no_quarter` / `kpi.accept_no_quarter` 是计数。
|
||||
- **周期记录里的 `amount_delta` / `revenue_delta` 是增量,会同步落到项目主档**:
|
||||
新建记录 → 主档累加;修改记录 → 按新旧差额回补;删除记录 → 一并扣回。
|
||||
AI 写入时「parsed 给了 `amount` 绝对值就用绝对值,否则累加明细增量」,两条路只走一条,不会重复计。
|
||||
- 历史数据可疑时执行 `finance.backfill(db)`(幂等,可反复跑):按上面的口径重算验收年份与商务阶段。
|
||||
|
||||
## 收入确认口径
|
||||
|
||||
定制项目按**完工百分比法**确认收入:
|
||||
定开项目按**完工百分比法**确认收入:
|
||||
|
||||
| 阶段 | 确认比例 |
|
||||
|---|---|
|
||||
|
|
@ -503,7 +280,7 @@ python scripts/legacy/add_entry_date.py --force # 全部重算
|
|||
- **可确认收入** = 合同额 × 上表比例
|
||||
- **待计收** = 可确认收入 − 已计收
|
||||
- **待开票** = 合同额 − 已开票、**待回款** = 合同额 − 已回款(均不小于 0,随开票 / 回款金额自动更新)
|
||||
- 开票与回款金额在项目详情抽屉、定制项目详情抽屉、工作看板右栏都能直接填
|
||||
- 开票与回款金额在项目详情抽屉、定开项目详情抽屉、工作看板右栏都能直接填
|
||||
- 项目上可填「手动确认比例」覆盖阶段推算(用于预付、分批收款等特殊情形)
|
||||
- 比例定义见 `app/constants.py::CUSTOM_STAGES` 与 `custom_revenue_ratio()`,改一处即可全局生效
|
||||
|
||||
|
|
@ -511,35 +288,25 @@ python scripts/legacy/add_entry_date.py --force # 全部重算
|
|||
|
||||
```
|
||||
# 项目管理(长期重点项目)
|
||||
Period(周期: 一行=一个自然周, kind 恒为 week——月粒度由 year/month 列合成, sort_key 全排序)
|
||||
└── Project(分类, 负责人 owners[0], 其他负责人, 团队成员, 状态, 重点标记, 进度, 标签)
|
||||
Period(周期: 年/月/周, sort_key)
|
||||
└── Project(分类, 负责人 owners[0], 其他负责人, 团队成员, 状态, 优先级, 重点标记, 进度, 标签)
|
||||
├── Task(子任务)
|
||||
└── Update(执行情况: 正文, 摘要, 进度, 状态, 风险, 下一步, 来源, 原文)
|
||||
|
||||
# 定制项目(独立)
|
||||
# 定开项目(独立)
|
||||
CustomProject(名称, 客户, 区域, 合同额, 阶段, 开发进度, 手动确认比例,
|
||||
已计收金额, 交付负责人(单人), 团队成员, 入库/签单/交付/验收/计收日期, 开票/回款金额, 重点, 归档)
|
||||
# 定制项目不做多负责人:other_owners 列保留在库里但不再读写
|
||||
# 定开项目不做多负责人:other_owners 列保留在库里但不再读写
|
||||
└── CustomUpdate(周期, 阶段, 内容, 进度, 本期新增下单, 本期新增计收, 风险, 下一步)
|
||||
|
||||
# 每周工作(独立:条目不是项目,不挂子任务与执行记录)
|
||||
# 每周重点工作(独立:条目不是项目,不挂子任务与执行记录)
|
||||
WeeklyFocus(工作内容, 说明, 录入周→Period, 预计完成时间, 执行状态, 是否延期, 结果反馈, 归档)
|
||||
|
||||
Staff(姓名, 归属小组, 人员归属, 说明, 排序, 归档) # 花名册:所有「负责人 / 团队成员」下拉的唯一来源
|
||||
Category / Tag / Setting(AI 配置、年度计收目标 custom_annual_targets:{年份}) / ImportLog(AI 整理留痕)
|
||||
|
||||
# 权限(RBAC)
|
||||
Role(名称, 说明, is_builtin) ── RoleMenu(菜单, 级别 ro|rw) # 授权矩阵:角色 × 菜单
|
||||
User(姓名, 账号, 口令散列+盐, 是否启用, 最近登录) ── UserRole(用户, 角色) # 多角色,权限取并集取高
|
||||
UserSession(token, 用户, 过期时间, IP, UA) # 会话,可按角色/账号吊销
|
||||
AuditLog(用户, 动作 create|update|delete|login|logout|deny, 菜单, 方法, 路径, 状态码, IP, 详情)
|
||||
Category / Tag / Setting / ImportLog
|
||||
LedgerItem(客户项目台账) # 只剩模型与 Excel 导入解析,界面无入口、接口已下线
|
||||
```
|
||||
|
||||
**列级对齐(唯一的迁移通道,没有 alembic)**:启动时 `schema_patch.ensure_columns` 给老库补模型新增的可空列;
|
||||
模型删掉的死列由 `schema_patch.drop_stale_columns` 按 **`STALE_COLUMNS` 白名单**定点 DROP(SQLite ≥ 3.35)。
|
||||
删「带 Python default 的 NOT NULL 列」必须登记白名单——不删掉老库里的残留列,INSERT 会直接撞 NOT NULL 约束。
|
||||
新增死列清理一律走白名单,不做「模型没有就删」的全量对账。
|
||||
|
||||
原表映射关系:
|
||||
|
||||
- `周工作情况总结`:**时间** → Period;**工作内容** → Project;**内容说明** → Task;**完成情况** → Update
|
||||
|
|
@ -552,8 +319,8 @@ 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 任意填。
|
||||
|
|
@ -562,21 +329,6 @@ AuditLog(用户, 动作 create|update|delete|login|logout|deny, 菜单, 方法,
|
|||
- 阶段判定做了特殊处理:文本里同时出现「已计收」和「进度 60%」时判为**开发中**,计收金额由 `revenue_delta` 承载。
|
||||
- 解析结果写入前始终提供**可编辑预览**,确认后才落库,并留痕到 `import_logs`。
|
||||
|
||||
## 测试
|
||||
|
||||
```bash
|
||||
./.venv/bin/pip install -r requirements-dev.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
|
||||
./.venv/bin/python -m pytest # 103 个用例,几秒钟跑完
|
||||
```
|
||||
|
||||
- 测试跑在临时库里:`tests/conftest.py` 在 import 业务模块之前就把 `DATABASE_URL` 指向临时文件,**不会碰 `data/board.db`**。
|
||||
- 每个用例重建表结构并重新补种内置角色与管理员,用例之间互不污染;`AI_API_KEY` 置空,
|
||||
AI 相关用例走确定性的本地规则解析,不联网。
|
||||
- 覆盖范围:登录 / 口令 / 会话限流、RBAC 授权矩阵与越权与审计、周期与项目与执行记录、
|
||||
定制项目财务口径(跨季度、跨年回归)、年度目标、花名册 / 每周重点 / 工作看板、AI 整理与六类 Excel 导出。
|
||||
- 还有一道静态防线:`tests/test_api_contract.py::test_前端查询参数必须在后端有声明` 扫描 `web/src/api/endpoints.ts`,
|
||||
前端发出的每个查询键 / body 键都必须在后端 OpenAPI 里声明过(旧版抓到过「前端一直发、后端一直丢」的整类 bug)。
|
||||
|
||||
## 迁移到 MySQL
|
||||
|
||||
1. 安装驱动:`pip install pymysql cryptography`
|
||||
|
|
@ -584,7 +336,7 @@ AuditLog(用户, 动作 create|update|delete|login|logout|deny, 菜单, 方法,
|
|||
```
|
||||
DATABASE_URL=mysql+pymysql://user:password@127.0.0.1:3306/unis_board?charset=utf8mb4
|
||||
```
|
||||
3. 重启服务(表结构自动创建)。全新库如果要从旧 Excel 还原历史数据,再依次执行 `scripts/import_excel.py --reset` 与 `scripts/legacy/migrate_custom.py`。
|
||||
3. 重启服务(表结构自动创建),再依次执行 `import_excel.py --reset` 与 `migrate_custom.py`。
|
||||
|
||||
数据访问层全部使用 SQLAlchemy ORM,无原生 SQL、无 SQLite 专有语法,切换方言无需改业务代码。
|
||||
|
||||
|
|
@ -593,140 +345,66 @@ AuditLog(用户, 动作 create|update|delete|login|logout|deny, 菜单, 方法,
|
|||
```
|
||||
app/
|
||||
main.py FastAPI 入口(API 挂载在 /api,静态页面在 /)
|
||||
config.py 配置与 .env 加载(DATABASE_URL、AI 参数、SESSION_DAYS)
|
||||
config.py 配置与 .env 加载(DATABASE_URL、AI 参数)
|
||||
db.py engine / Session(按 URL 自动适配方言)
|
||||
models.py ORM 模型(项目 + 定制项目 + 每周工作 + 花名册 + RBAC)
|
||||
constants.py 状态/阶段常量、收入确认比例、区域与阶段识别、权限菜单目录
|
||||
security.py 口令散列、会话、权限解析与路由依赖(RBAC 的门)
|
||||
audit.py 操作审计写入
|
||||
finance.py 定制项目财务口径唯一入口(下单/验收归属、年度目标、回填)
|
||||
export.py xlsx 生成(表头样式、冻结、筛选、金额千分位)
|
||||
ai_parser.py LLM 解析 + 本地规则兜底(通用 / 定制两套)
|
||||
routers/ auth · rbac(角色/账号/会话/审计) · board(周期/元数据) · weekly(看板数据) ·
|
||||
projects · custom(定制项目 + 财务) · focus · staff · ai · export
|
||||
web/ 前端(nex.config.yaml 标准栈:React + TypeScript + Vite + Ant Design +
|
||||
Tailwind v4 + Zustand + React Router + Axios)
|
||||
src/
|
||||
main.tsx App.tsx router.tsx 入口 / 会话门 / 八个视图的懒加载路由
|
||||
api/ client.ts(Axios:401 广播、中文错误、导出走 blob+下载)
|
||||
endpoints.ts(一接口一函数,查询键集中在这一层,测试据此对表)
|
||||
store/ session.ts(登录态与 canR/canW)· meta.ts(字典/周期/台账缓存 + dataRev)
|
||||
ui.ts(界面状态,sessionStorage 键 unis.ui.v2,字段与旧版一致)
|
||||
components/ Shell(侧栏/顶栏/用户胶囊)· PageHead · PanelCard · KpiCard · DataState ·
|
||||
PagerBar · Trunc · PeriodPicker · LoginGate · ProfileModal · UserChip
|
||||
domain/ ink.ts(界面色只引用 token)· pills.tsx(状态标签:一个 --c 派生底色)
|
||||
icons/ 唯一图标层:SVG 路径表 + <Icon/> / <IconBadge/>(AntD 自带图标不参与业务用图)
|
||||
styles/ tokens.css(设计 token 唯一来源 + Tailwind @theme)· app.css(结构层)
|
||||
views/ board · projects · custom · focus · staff · intake · settings · rbac
|
||||
index.html · vite.config.ts · tsconfig.json · package.json · package-lock.json
|
||||
dist/ Vite 构建产物(不入库,由 FastAPI 挂在 / 与 /static 下)
|
||||
legacy/ 改造前的零构建版(app.js · styles.css · icons.js · index.html),没有 dist 时兜底
|
||||
tests/ pytest 接口测试(conftest 用临时库,绝不碰 data/board.db)
|
||||
scripts/
|
||||
run.sh 本地启动:Python / venv / 依赖 / .env / 建库自动兜底
|
||||
deploy.sh Docker 部署命令封装:up / update / restart / down / logs / status / backup / mirror
|
||||
init_db.py 建表 + 预置分类(启动时幂等)
|
||||
import_excel.py 历史 Excel(周工作情况总结 / 项目明细表)导入
|
||||
import_staff.py 人员名单导入
|
||||
import_custom_ledger.py 定开项目市场台账导入
|
||||
legacy/ 一次性历史修数脚本(shift_year · merge_project · migrate_custom ·
|
||||
add_entry_date · fix_period_split),不参与启动流程
|
||||
models.py ORM 模型(项目 + 定开项目 + 每周重点工作 + 花名册)
|
||||
constants.py 状态/阶段常量、收入确认比例、区域与阶段识别
|
||||
ai_parser.py LLM 解析 + 本地规则兜底(通用 / 定开两套)
|
||||
routers/ board(周期/元数据/统计) · weekly(工作看板数据) · projects(项目管理) ·
|
||||
custom(定开项目) · focus(每周重点工作) · staff(人力) · ai · export
|
||||
web/ index.html · styles.css · app.js(零依赖,无构建步骤)
|
||||
scripts/ init_db.py · import_excel.py · migrate_custom.py · import_staff.py · add_entry_date.py · merge_project.py · shift_year.py
|
||||
data/board.db SQLite 数据库
|
||||
Dockerfile 两阶段镜像:node:22 构建 web/dist → python:3.12 运行(启动时自动补表/预置分类)
|
||||
docker-compose.yml 部署编排(./data 持久化、HOST_PORT、健康检查)
|
||||
.dockerignore 排除 data/ 与 .env,不把数据和密钥打进镜像
|
||||
```
|
||||
|
||||
## API 速览
|
||||
|
||||
鉴权走 **HttpOnly Cookie `unis_session`**(由 `/api/auth/login` 下发,只认 Cookie,不认自定义头);
|
||||
除 `/api/auth/login` 与 `/health` 外,所有接口都要求已登录,否则 401。
|
||||
写操作(POST/PATCH/PUT/DELETE)额外要求对应菜单是 `rw`,越权返回 403 并留审计。
|
||||
请求体约定:**新建实体**用 Pydantic 模型(`XxxIn`,校验失败 422 中文提示);
|
||||
**部分更新**(定制项目、定制交付记录、人员、设置的 PATCH/PUT)收自由 JSON + 后端字段白名单
|
||||
(`payload: dict`:只更新带来的键、不认识的键忽略),加字段只改白名单一处,两种模式不要混用。
|
||||
|
||||
```
|
||||
# 登录与自助
|
||||
POST /api/auth/login {username,password} → 当前用户;会话 token 只写在 Set-Cookie 里
|
||||
POST /api/auth/logout 吊销当前会话
|
||||
GET /api/auth/me 当前账号 + 角色 + 菜单权限表(前端据此渲染侧栏)
|
||||
PUT /api/auth/me 改自己的姓名
|
||||
POST /api/auth/password 改自己的密码(改完踢掉其它会话)
|
||||
|
||||
# 权限管理
|
||||
GET /api/rbac/meta 菜单目录 + 级别字典 + 内置角色
|
||||
GET|POST /api/rbac/roles 角色清单(含授权矩阵)/ 新建角色
|
||||
PATCH|DELETE /api/rbac/roles/{id} 改名称、说明、menus({菜单: ro|rw});改授权会踢掉该角色的会话
|
||||
GET|POST /api/rbac/users 账号清单 / 新建账号(role_ids 分配角色)
|
||||
PATCH|DELETE /api/rbac/users/{id} 改资料、启停、重设密码;停用即吊销会话
|
||||
POST /api/rbac/users/{id}/revoke 只吊销某个账号的全部会话
|
||||
GET /api/rbac/sessions 在线会话(用户、IP、UA、到期、token 摘要)
|
||||
DELETE /api/rbac/sessions/{token} 吊销单个会话
|
||||
GET|DELETE /api/rbac/logs 操作审计(服务端分页)?username=&menu=&action=&days=&limit=&offset=;返回 {total, items}
|
||||
/ DELETE 按 days 清理
|
||||
|
||||
# 通用
|
||||
GET /api/meta 状态字典 / 菜单 / AI 配置状态
|
||||
GET /api/periods 周列表 + 按月聚合(today_id = 今天所在的周,顶栏默认落它;没有会自动补建)
|
||||
POST /api/periods 新增周期(传 label 如「9月第1周」,年份自动接续;重复提交返回已有的)
|
||||
DELETE /api/periods/{id} 删除空周期(有记录则拒绝)
|
||||
GET /api/weekly?period_id=|year&month&owner=&all_custom=
|
||||
工作看板:重点项目 + 定制项目本周动态 + KPI
|
||||
(行上带 is_new / updated_this_period / idle_weeks / worst_status;
|
||||
非重点且本周无记录的默认不列出,all_custom=true 才列出在途定制;
|
||||
没有任何周期时返回全键 0 值骨架,前端不用兜底)
|
||||
GET /api/projects (?archived=false|true|all&category_id=&is_key=&keyword=&owner=&period_id=|year&month)
|
||||
POST /api/projects PATCH|DELETE /api/projects/{id}
|
||||
(owners/members 传人名数组,整体替换:不传=不改,传 []=清空;owners[0] 回写 owner 列)
|
||||
GET|POST /api/categories PATCH|DELETE /api/categories/{id}
|
||||
GET /api/updates?project_id=&period_id=|year&month&limit=
|
||||
标签与子任务没有独立端点:标签随 POST|PATCH /api/projects 的 tags 数组
|
||||
自动创建 / 复用;子任务随 POST /api/updates 的 task_name 自动创建 / 复用
|
||||
周期执行记录(月粒度含该月各周;范围内没有周期就返回空,不回落到最新周)
|
||||
POST /api/updates 写入口校验:项目/周期必须存在、状态合法、正文与摘要不能都空
|
||||
PATCH|DELETE /api/updates/{id}
|
||||
GET /api/meta 状态字典 / 优先级 / AI 配置状态
|
||||
GET /api/periods 周列表 + 按月聚合(含各周期记录数;today_id = 今天所在的周,顶栏默认落它)
|
||||
POST /api/periods 新增周期(传 label 如「9月第1周」,年份自动接续)
|
||||
DELETE /api/periods/{id} 删除空周期(有记录则拒绝)
|
||||
GET /api/board?period_id=|year&month 周期汇总(页面主链路不走它,统计走 /api/stats)
|
||||
GET /api/stats?period_id=|year&month
|
||||
GET /api/weekly?period_id=|year&month&owner=&all_custom= 工作看板:重点项目 + 定开项目本周动态 + KPI
|
||||
(custom_new 本期新入库 / custom_updated 本期有交付记录;行上带 is_new)
|
||||
(左栏第一组「本周工作重点」前端另取 /api/focus 合并)
|
||||
GET /api/projects (?archived=false|true|all)
|
||||
POST /api/projects PATCH /api/projects/{id} DELETE /api/projects/{id}
|
||||
(owners/members 传人名数组,整体替换:不传=不改,传 []=清空;owners[0] 回写 owner 列供归属统计,界面不再区分主次)
|
||||
GET /api/categories POST /api/categories PATCH /api/categories/{id} DELETE /api/categories/{id}
|
||||
|
||||
# 定制项目
|
||||
GET /api/custom/meta 阶段字典 + 区域列表 + 交付环节(pipeline) + 卡点阈值(aging_days)
|
||||
GET /api/custom/projects?stage=®ion=&keyword=&archived=&owner=
|
||||
POST /api/custom/projects PATCH|DELETE /api/custom/projects/{id}
|
||||
(owner 是单个人名;members 传人名数组整体替换;不再接受 owners,多负责人只属于重点项目)
|
||||
POST /api/custom/updates PATCH|DELETE /api/custom/updates/{id}
|
||||
(amount_delta / revenue_delta 是增量,会自动累加/回补主档金额,见「财务统计口径」)
|
||||
GET /api/custom/finance?period_id=|year&month
|
||||
财务汇总:context(年/月/季度区间) + kpi(下单、季度与年度验收、计收…) + 年度任务表
|
||||
GET|PUT /api/custom/annual-targets?year= 年度计收目标(万元)。存过就以库里为准,非数字返回 400
|
||||
# 定开项目
|
||||
GET /api/custom/meta 阶段字典 + 区域列表 + 交付环节(pipeline) + 卡点阈值(aging_days)
|
||||
GET /api/custom/projects?stage=®ion=&keyword=
|
||||
POST /api/custom/projects PATCH /api/custom/projects/{id} DELETE /api/custom/projects/{id}
|
||||
(owner 是单个人名;members 传人名数组,整体替换:不传=不改,传 []=清空。不再接受 owners,多负责人只属于重点项目)
|
||||
GET /api/custom/board?period_id=|year&month 阶段看板
|
||||
GET /api/custom/stats?period_id=|year&month 收入统计
|
||||
POST /api/custom/updates
|
||||
POST /api/custom/ai/parse 粘贴文本 → 结构化预览
|
||||
POST /api/custom/ai/commit 确认写入
|
||||
|
||||
# AI 整理(两套体系各自独立;未配 Key 自动降级为本地规则解析)
|
||||
POST /api/ai/parse 粘贴原文 → 结构化预览。**只读**:写了新项目名也不会建项目
|
||||
POST /api/ai/commit 确认写入:按 tasks 建子任务与执行记录(同名子任务复用),回写主档,留痕 import_logs
|
||||
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=录入周(前端传顶栏当前周,不传按今天所在的周补)
|
||||
PATCH|DELETE /api/focus/{id} 改 due_date 不会搬走归属周
|
||||
# 每周重点工作
|
||||
GET /api/focus?archived=false|true|all&status=&keyword= 条目清单(period_id/period_label/sort_key 都是**录入周**,分堆由调用方判定)
|
||||
POST /api/focus PATCH /api/focus/{id} DELETE /api/focus/{id}
|
||||
单条增改删;工作内容非空。period_id=录入周(前端传顶栏当前周,
|
||||
不传后端按今天所在的周补;due_date 只是目标日期,不改归属周)
|
||||
或直接给 period_id(必须存在);两者都不给 → 400
|
||||
|
||||
# 人力资源库
|
||||
GET /api/staff?archived=false|true|all&group=&keyword=
|
||||
花名册 + 各自负载(在管/重点/定制数、定制合同额、待计收)+ 花名册外负责人 + 小组与归属字典
|
||||
POST /api/staff PATCH|DELETE /api/staff/{id}
|
||||
(姓名与花名册重名返回 400;名下有项目时禁止直接删除,提示先归档,?force=true 才强制删;
|
||||
改名会把项目与定制项目上的负责人一起同步,返回值 synced 说明同步了几条)
|
||||
GET /api/staff?archived=false|true|all&group=&keyword= 花名册 + 各自工作量 + 花名册外负责人 + 小组/归属字典
|
||||
POST /api/staff PATCH /api/staff/{id} DELETE /api/staff/{id}(名下有项目时拒绝,离职请归档)
|
||||
|
||||
# 其他
|
||||
GET|PUT /api/settings AI 配置等(GET 需 settings 只读,PUT 需可编辑)
|
||||
GET /api/settings PUT /api/settings
|
||||
|
||||
# 导出(均返回 xlsx,筛选口径与页面对应)
|
||||
GET /api/export/custom ?region=&origin=&status=&risk=&accept_plan=&keyword=&archived=false|true|all(末尾带合计行)
|
||||
GET /api/export/custom-updates ?period_id=|year&month&keyword=
|
||||
GET /api/export/projects ?category_id=&keyword=&owner=&idle_only=1&period_id=|year&month&archived=false|true|all(默认 false 与页面一致;owner 匹配主/其他负责人;idle_only 需带周期;搜归档记得 archived=all)
|
||||
GET /api/export/updates ?period_id=|year&month&project_id=&keyword=(匹配内容/摘要/子任务/项目名)
|
||||
GET /api/export/staff ?archived=false|true|all&group=&keyword=
|
||||
GET /api/export/focus ?archived=false|true|all&status=&keyword=
|
||||
导出与接口的差别:范围解析不出周期时导出给全量(让人把数据带走),
|
||||
接口则返回空(避免把「没数据」看成「全周期数据」)
|
||||
# 导出(均返回 xlsx)
|
||||
GET /api/export/custom ?region=&stage=&keyword=&archived=
|
||||
GET /api/export/custom-updates ?period_id=|year&month
|
||||
GET /api/export/projects ?category_id=&keyword=&archived=
|
||||
GET /api/export/staff ?archived=false|true|all
|
||||
GET /api/export/focus ?archived=false|true|all&status=&keyword=
|
||||
GET /api/export/updates ?period_id=|year&month&project_id=
|
||||
```
|
||||
|
|
|
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -61,7 +61,9 @@ def ai_enabled(db) -> bool:
|
|||
# --------------------------------------------------------------------------
|
||||
# 规则兜底解析
|
||||
# --------------------------------------------------------------------------
|
||||
_CN_NUM = {"一": 1, "二": 2, "三": 3, "四": 4, "五": 5, "六": 6, "七": 7, "八": 8, "九": 9, "十": 10}
|
||||
_SPLIT_RE = re.compile(r"(?:^|\n)\s*(?:\(?\d{1,2}[))、..::]|[一二三四五六七八九十]{1,2}[、..]|[-•*·]\s)")
|
||||
_PCT_RE = re.compile(r"(\d{1,3}(?:\.\d+)?)\s*%")
|
||||
|
||||
_STATUS_RULES = [
|
||||
(("阻塞", "卡住", "卡点", "停滞", "无法推进", "推不动"), "blocked"),
|
||||
|
|
@ -221,10 +223,10 @@ def llm_parse(raw: str, project_name: str, period_label: str, db) -> dict[str, A
|
|||
|
||||
|
||||
# ==========================================================================
|
||||
# 定制项目:阶段 / 金额 / 计收
|
||||
# 定开项目:阶段 / 金额 / 计收
|
||||
# ==========================================================================
|
||||
CUSTOM_SYSTEM_PROMPT = """你是定制项目的管理助理,负责把项目周报原文整理成结构化记录。
|
||||
定制项目关注的是商务阶段流转(商机→签单→开发→交付→验收→计收)与收入确认。
|
||||
CUSTOM_SYSTEM_PROMPT = """你是定开项目的管理助理,负责把项目周报原文整理成结构化记录。
|
||||
定开项目关注的是商务阶段流转(商机→签单→开发→交付→验收→计收)与收入确认。
|
||||
请严格输出 JSON(不要 Markdown 代码块、不要解释),结构如下:
|
||||
{
|
||||
"stage": "developing",
|
||||
|
|
@ -245,7 +247,7 @@ CUSTOM_SYSTEM_PROMPT = """你是定制项目的管理助理,负责把项目周
|
|||
5. 不要编造原文没有的金额和数字。
|
||||
"""
|
||||
|
||||
CUSTOM_USER_TEMPLATE = """定制项目:{project}
|
||||
CUSTOM_USER_TEMPLATE = """定开项目:{project}
|
||||
周期:{period}
|
||||
当前阶段:{stage}
|
||||
|
||||
|
|
@ -254,6 +256,7 @@ CUSTOM_USER_TEMPLATE = """定制项目:{project}
|
|||
---- 结束 ----
|
||||
"""
|
||||
|
||||
_AMT_RE = re.compile(r"(?:金额|合同额|合同金额|下单|订单|报价)?\s*[¥¥]?\s*(\d[\d,,]*(?:\.\d+)?)\s*(元|万|万元)?")
|
||||
_REVENUE_RE = re.compile(r"(?:计收|已计收|核销|回款)[^0-9]{0,8}([0-9][0-9,,]*(?:\.\d+)?)")
|
||||
|
||||
|
||||
|
|
|
|||
125
app/audit.py
125
app/audit.py
|
|
@ -1,125 +0,0 @@
|
|||
"""操作审计:谁在什么时候改了哪个菜单的数据,成功还是被拒。
|
||||
|
||||
写入口只有一个:`/api` 子应用上的 HTTP 中间件。它在每个请求结束后落一行:
|
||||
- 写操作(POST/PUT/PATCH/DELETE)+ 登录/退出/改密/下线:成功失败都记;
|
||||
- 403 一律改记 `action=deny`(**含 GET**——越权探测也要留痕);
|
||||
- 500:业务代码抛穿中间件时按 `status=500` 补记,不丢失败的写操作;
|
||||
- 其余 GET 不落库,避免日志被列表刷新刷爆。
|
||||
业务代码可以用 `audit.note(request, "……")` 补一句说明,日志的「说明」列直接可读。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import timedelta
|
||||
|
||||
from fastapi import Request
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from .db import SessionLocal
|
||||
from .models import AuditLog, now
|
||||
|
||||
# 方法 → 动作
|
||||
METHOD_ACTION = {"POST": "create", "PUT": "update", "PATCH": "update", "DELETE": "delete"}
|
||||
# 特殊动作:路径以这些结尾时按语义记,不套 method 默认值
|
||||
SPECIAL_ACTION = {
|
||||
"/api/auth/login": "login",
|
||||
"/api/auth/logout": "logout",
|
||||
"/api/auth/password": "password",
|
||||
}
|
||||
KEEP_DAYS = 180 # 日志保留天数,启动时清一次
|
||||
|
||||
|
||||
def client_ip(request: Request) -> str | None:
|
||||
fwd = request.headers.get("x-forwarded-for")
|
||||
if fwd:
|
||||
return fwd.split(",")[0].strip()[:64]
|
||||
return request.client.host[:64] if request.client else None
|
||||
|
||||
|
||||
def action_for(path: str, method: str) -> str | None:
|
||||
"""返回 None 表示这个请求不进审计(403 例外,中间件会改记 deny)。"""
|
||||
clean = path.rstrip("/")
|
||||
if clean in SPECIAL_ACTION:
|
||||
return SPECIAL_ACTION[clean]
|
||||
if clean.endswith("/revoke"): # 先于 METHOD_ACTION:否则被 POST→create 吃掉,revoke 永远 0 条
|
||||
return "revoke"
|
||||
if method in METHOD_ACTION:
|
||||
return METHOD_ACTION[method]
|
||||
return None
|
||||
|
||||
|
||||
def note(request: Request, text: str | None = None, *, username: str | None = None) -> None:
|
||||
"""业务代码给审计日志留一句人话说明;落库由中间件完成。
|
||||
|
||||
`username` 只在拿不到登录用户时用得上(比如密码输错,操作人记的是被尝试的账号)。
|
||||
"""
|
||||
try:
|
||||
if text:
|
||||
request.state.audit_detail = text[:255]
|
||||
if username:
|
||||
request.state.audit_username = username[:64]
|
||||
except Exception: # 审计说明是锦上添花,不能带崩业务
|
||||
pass
|
||||
|
||||
|
||||
def write(db: Session, *, user, request: Request, status: int, action: str,
|
||||
menu: str | None = None, detail: str | None = None,
|
||||
username: str | None = None) -> None:
|
||||
db.add(AuditLog(
|
||||
user_id=getattr(user, "id", None),
|
||||
username=username or getattr(user, "username", None),
|
||||
action=action,
|
||||
menu=menu,
|
||||
method=request.method,
|
||||
path=request.url.path[:255],
|
||||
status=status,
|
||||
ip=client_ip(request),
|
||||
detail=detail[:255] if detail else None,
|
||||
))
|
||||
db.commit()
|
||||
|
||||
|
||||
def prune(db: Session, keep_days: int = KEEP_DAYS) -> int:
|
||||
q = db.query(AuditLog).filter(AuditLog.created_at < now() - timedelta(days=keep_days))
|
||||
n = q.count()
|
||||
if n:
|
||||
q.delete(synchronize_session=False)
|
||||
db.commit()
|
||||
return n
|
||||
|
||||
|
||||
def audit_middleware_factory():
|
||||
"""给 /api 子应用用的中间件:写完响应后补一条审计。"""
|
||||
|
||||
async def audit(request: Request, call_next):
|
||||
from .security import resolve_rule # 避免循环导入
|
||||
|
||||
def record(action: str, status: int) -> None:
|
||||
rule = resolve_rule(request.url.path.rstrip("/"), request.method)
|
||||
state = getattr(request, "state", None)
|
||||
detail = getattr(state, "audit_detail", None)
|
||||
if status >= 400:
|
||||
detail = f"{detail};" if detail else ""
|
||||
detail += f"HTTP {status}"
|
||||
try:
|
||||
with SessionLocal() as db:
|
||||
write(db, user=getattr(state, "user", None), request=request,
|
||||
status=status, action=action, menu=rule[0] if rule else None,
|
||||
detail=detail, username=getattr(state, "audit_username", None))
|
||||
except Exception: # 审计绝不能把业务请求带崩
|
||||
pass
|
||||
|
||||
action = action_for(request.url.path, request.method)
|
||||
try:
|
||||
response = await call_next(request)
|
||||
except Exception:
|
||||
if action is not None: # 写操作抛穿:先补一条 500 再让上层处理
|
||||
record(action, 500)
|
||||
raise
|
||||
status = response.status_code
|
||||
if status == 403:
|
||||
action = "deny" # 越权统一记 deny,含被拒的 GET
|
||||
if action is not None:
|
||||
record(action, status)
|
||||
return response
|
||||
|
||||
return audit
|
||||
|
|
@ -15,44 +15,29 @@ STATUSES = [
|
|||
STATUS_MAP = {code: (name, color) for code, name, color in STATUSES}
|
||||
STATUS_CODES = [c for c, _, _ in STATUSES]
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# 权限菜单目录(前后端共用:键是权限标识,顺序即权限管理页里的展示顺序)
|
||||
# rw = 可编辑(含新增/修改/删除/导出写入口)
|
||||
# ro = 只读(能看列表与详情,所有写接口一律 403)
|
||||
# 没有这个菜单 = 侧栏看不到、接口也进不去
|
||||
# --------------------------------------------------------------------------
|
||||
MENUS = [
|
||||
("board", "工作看板"),
|
||||
("projects", "自研产品"),
|
||||
("custom", "定制项目"),
|
||||
("focus", "每周工作"),
|
||||
("staff", "人力资源"),
|
||||
("intake", "更新录入"),
|
||||
("settings", "设置"),
|
||||
("rbac", "权限管理"),
|
||||
NEGATIVE_STATUS = ("at_risk", "blocked", "paused")
|
||||
|
||||
# 项目优先级
|
||||
PRIORITIES = [
|
||||
("p0", "P0 最高", "#dc2626"),
|
||||
("p1", "P1 高", "#d97706"),
|
||||
("p2", "P2 中", "#2563eb"),
|
||||
("p3", "P3 低", "#6b7280"),
|
||||
]
|
||||
MENU_KEYS = [k for k, _ in MENUS]
|
||||
MENU_LABELS = dict(MENUS)
|
||||
LEVELS = ("ro", "rw")
|
||||
LEVEL_LABELS = {"rw": "可编辑", "ro": "只读", "": "无权限"}
|
||||
# 多角色并集时比大小用
|
||||
LEVEL_RANK = {"": 0, "ro": 1, "rw": 2}
|
||||
|
||||
|
||||
def merge_levels(*maps: dict) -> dict:
|
||||
"""把多张菜单权限表合成一张:同一菜单取更高级别。"""
|
||||
out: dict[str, str] = {}
|
||||
for m in maps:
|
||||
for menu, level in (m or {}).items():
|
||||
if menu not in MENU_LABELS:
|
||||
continue
|
||||
if LEVEL_RANK.get(level, 0) > LEVEL_RANK.get(out.get(menu, ""), 0):
|
||||
out[menu] = level
|
||||
return out
|
||||
PRIORITY_MAP = {code: (name, color) for code, name, color in PRIORITIES}
|
||||
|
||||
# 台账类别(来自《项目明细表》)
|
||||
LEDGER_CATEGORIES = [
|
||||
"新增项目",
|
||||
"重点项目",
|
||||
"验收项目",
|
||||
"交付项目",
|
||||
"提前交付",
|
||||
"异常项目",
|
||||
]
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# 定制项目(交付制,与平台产品类项目分开管理)
|
||||
# 定开项目(交付制,与平台产品类项目分开管理)
|
||||
# (code, 名称, 颜色, 收入确认基准比例)
|
||||
# 开发中阶段:base + 0.4 * progress/100
|
||||
# 其余阶段:直接使用 base
|
||||
|
|
@ -70,22 +55,17 @@ CUSTOM_STAGES = [
|
|||
]
|
||||
CUSTOM_STAGE_MAP = {c: (n, col, r) for c, n, col, r in CUSTOM_STAGES}
|
||||
CUSTOM_STAGE_CODES = [c for c, _, _, _ in CUSTOM_STAGES]
|
||||
# 阶段先后顺序(用于看板列排序与阶段流转判断)
|
||||
CUSTOM_STAGE_ORDER = {c: i for i, (c, _, _, _) in enumerate(CUSTOM_STAGES)}
|
||||
|
||||
|
||||
def custom_revenue_ratio(stage: str, progress: float | None, manual_ratio=None,
|
||||
project_status: str | None = None) -> float:
|
||||
"""按阶段 + 开发进度计算收入确认比例(0~1)。
|
||||
|
||||
手动比例 manual_ratio 优先;其次「退单」一律按 0 计(阶段虽落到 closed,
|
||||
但退单没有收入,不能让已关闭项目的基准比例把金额算进来)。
|
||||
"""
|
||||
def custom_revenue_ratio(stage: str, progress: float | None, manual_ratio=None) -> float:
|
||||
"""按阶段 + 开发进度计算收入确认比例(0~1)。"""
|
||||
if manual_ratio is not None:
|
||||
try:
|
||||
return max(0.0, min(1.0, float(manual_ratio)))
|
||||
except (TypeError, ValueError):
|
||||
pass
|
||||
if (project_status or "").strip() == CUSTOM_NO_REVENUE_STATUS and manual_ratio is None:
|
||||
return 0.0
|
||||
base = CUSTOM_STAGE_MAP.get(stage, ("", "#94a3b8", 0.0))[2]
|
||||
if stage == "developing":
|
||||
p = float(progress or 0)
|
||||
|
|
@ -94,7 +74,7 @@ def custom_revenue_ratio(stage: str, progress: float | None, manual_ratio=None,
|
|||
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# 定制项目:文本 → 阶段 / 金额 识别
|
||||
# 定开项目:文本 → 阶段 / 金额 识别
|
||||
# --------------------------------------------------------------------------
|
||||
CUSTOM_STAGE_RULES = [
|
||||
(("暂停", "终止", "未达成一致", "搁置"), "paused"),
|
||||
|
|
@ -361,7 +341,7 @@ DEFAULT_CATEGORY_COLORS = [
|
|||
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# 定制项目:全过程流水线(入库 → 签单 → 交付 → 验收 → 计收)
|
||||
# 定开项目:全过程流水线(入库 → 签单 → 交付 → 验收 → 计收)
|
||||
# key 环节代码(与 CUSTOM_STAGES 的阶段代码对齐,入库单独用 entry)
|
||||
# name 环节名
|
||||
# date_field 该环节的日期字段(CustomProject 上的属性名)
|
||||
|
|
@ -381,10 +361,22 @@ CUSTOM_ANNUAL_TARGETS_DEFAULT = {1: 35.0, 2: 225.0, 3: 160.0, 4: 260.0}
|
|||
# 「在途」阶段:还没走完 入库→签单→交付→验收 这条主线(已计收 / 暂停 / 已关闭不算在途)
|
||||
CUSTOM_INFLIGHT_STAGES = {"lead", "signed", "developing", "delivered", "accepted"}
|
||||
|
||||
# 环节顺序索引,用于判断项目当前卡在哪一环
|
||||
CUSTOM_STEP_ORDER = {key: i for i, (key, _, _, _, _) in enumerate(CUSTOM_PIPELINE)}
|
||||
|
||||
# 环节停滞天数超过该值视为「卡住」,需要在看板上提示
|
||||
CUSTOM_STEP_AGING_DAYS = 45
|
||||
|
||||
|
||||
def custom_current_step(dates: dict[str, str | None]) -> int:
|
||||
"""按已完成的环节日期,返回项目当前所处的环节下标(-1 表示连入库都没有)。"""
|
||||
step = -1
|
||||
for i, (_key, _name, field, _stage, _color) in enumerate(CUSTOM_PIPELINE):
|
||||
if (dates.get(field) or "").strip():
|
||||
step = i
|
||||
return step
|
||||
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# 人力资源库
|
||||
# --------------------------------------------------------------------------
|
||||
|
|
@ -413,84 +405,3 @@ def normalize_staff_affiliation(value: str | None) -> str | None:
|
|||
if a in v:
|
||||
return a
|
||||
return v
|
||||
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# 定制项目:项目状态(台账口径)→ 商务阶段(内部推导,不再单独维护)
|
||||
# 界面上只有「项目状态」可编辑,商务阶段(含收入确认比例)由它推导,
|
||||
# 避免出现两套状态互相打架。
|
||||
# --------------------------------------------------------------------------
|
||||
CUSTOM_STATUSES = ["待开发", "进行中", "交付完成", "已验收", "退单"]
|
||||
CUSTOM_STATUS_STAGE = {
|
||||
"待开发": "signed",
|
||||
"进行中": "developing",
|
||||
"交付完成": "delivered",
|
||||
"已验收": "accepted",
|
||||
"退单": "closed",
|
||||
}
|
||||
# 反向:AI 录入等只认阶段的入口,写回项目状态
|
||||
CUSTOM_STAGE_STATUS = {
|
||||
"signed": "待开发", "developing": "进行中", "delivered": "交付完成",
|
||||
"accepted": "已验收", "revenue": "已验收", "closed": "退单",
|
||||
"paused": "进行中", "lead": "待开发",
|
||||
}
|
||||
# 退单不确认收入(阶段落到 closed,但比例按 0 处理)
|
||||
CUSTOM_NO_REVENUE_STATUS = "退单"
|
||||
|
||||
# 项目归属:前三项算「已下单」,提前交付是下单前状态
|
||||
CUSTOM_ORIGINS = ["华智下单", "存量项目", "汇智直签", "提前交付"]
|
||||
CUSTOM_PLACED_ORIGINS = ("华智下单", "存量项目", "汇智直签")
|
||||
|
||||
# 行业 / 风险值:台账里的下拉取值,前端一律从 /custom/meta 取,不再各写一份
|
||||
CUSTOM_INDUSTRIES = ["安平", "政府", "企业", "教育", "交通", "医疗", "高速", "行业", "其他"]
|
||||
CUSTOM_RISKS = ["1.高风险", "2.低风险"]
|
||||
|
||||
|
||||
def derive_stage(project_status: str | None, fallback: str | None = None) -> str:
|
||||
"""按项目状态推导商务阶段;状态没填时保留原阶段。"""
|
||||
return CUSTOM_STATUS_STAGE.get((project_status or "").strip(), fallback or "signed")
|
||||
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# 年 / 季度:财务统计的时间归属只在这里判定一次(前端不再自己算季度)
|
||||
# --------------------------------------------------------------------------
|
||||
def quarter_of_month(month: int) -> int:
|
||||
"""月份 1~12 → 季度 1~4。"""
|
||||
return (int(month) - 1) // 3 + 1
|
||||
|
||||
|
||||
def parse_quarter(text) -> int | None:
|
||||
"""「Q3」/「q3」→ 3;其他写法一律不认(验收季度在界面上是下拉选项,脏文本不认才不会串统计)。"""
|
||||
s = str(text or "").strip().upper()
|
||||
if len(s) == 2 and s[0] == "Q" and s[1] in "1234":
|
||||
return int(s[1])
|
||||
return None
|
||||
|
||||
|
||||
def parse_year_month(text) -> tuple[int, int] | None:
|
||||
"""从「下单时间」这类可能带脏文本的字段里取 (年, 月);取不到月份时月份为 0。
|
||||
|
||||
认:2026-03-31 / 2026/3/31 / 2026-3 / 2026年3月 / 2026年 / 2026。
|
||||
「2024年3月前」这种能识别出 2024 年 3 月(前缀匹配),只用于年份归属。
|
||||
"""
|
||||
import re
|
||||
|
||||
s = str(text or "").strip()
|
||||
if not s:
|
||||
return None
|
||||
m = re.search(r"(20\d{2})\s*[-/年.]\s*(\d{1,2})", s)
|
||||
if m:
|
||||
year, month = int(m.group(1)), int(m.group(2))
|
||||
return (year, month) if 1 <= month <= 12 else (year, 0)
|
||||
m = re.search(r"(20\d{2})", s)
|
||||
return (int(m.group(1)), 0) if m else None
|
||||
|
||||
|
||||
def quarter_end(year: int, quarter: int) -> str:
|
||||
"""季度末日期(YYYY-MM-DD),用于按季度派生验收日期。"""
|
||||
import calendar
|
||||
import datetime
|
||||
|
||||
last_month = int(quarter) * 3
|
||||
day = calendar.monthrange(int(year), last_month)[1]
|
||||
return datetime.date(int(year), last_month, day).isoformat()
|
||||
|
|
|
|||
|
|
@ -4,8 +4,6 @@
|
|||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
|
||||
from datetime import datetime
|
||||
from io import BytesIO
|
||||
from typing import Any, Iterable, Sequence
|
||||
|
|
@ -23,33 +21,6 @@ BORDER = Border(left=THIN, right=THIN, top=THIN, bottom=THIN)
|
|||
NUM_FMT = "#,##0.00"
|
||||
|
||||
|
||||
# 正文支持简单富文本(加粗 / 下划线 / 斜体 / 语义色,前后端约定见 web/src/utils/richtext.ts)。
|
||||
# Excel 不认这套标记,出表前统一降级成纯文本:换行标记变成真换行,其余标签剥掉、实体还原。
|
||||
# 只在我们自己的标签出现时才动手,项目名里带个尖括号不会被误伤。
|
||||
RICH_TAG = re.compile(r"</?(?:b|i|u|br|p|div|span)\b[^>]{0,60}?>", re.I)
|
||||
_BREAK_TAG = re.compile(r"<br\s*/?>|</(?:p|div)>", re.I)
|
||||
_ADJACENT_BLOCK = re.compile(r"</(?:p|div)>\s*<(?:p|div)\b[^>]{0,60}?>", re.I)
|
||||
_ENTITIES = {"&": "&", "<": "<", ">": ">", """: '"', "'": "'", " ": " "}
|
||||
|
||||
|
||||
def plain(value: Any) -> Any:
|
||||
"""富文本 → 纯文本;不是字符串或不含标记时原样返回。
|
||||
|
||||
换行口径和前端 utils/richtext.richToText 保持一致:相邻段落之间只算一个换行
|
||||
(编辑器产出 <p>一行</p><p>一行</p>,开闭标签各断一次行会凭空多出空行),
|
||||
块开头也断行是为了兼容早年 Chrome 留下的「裸文本 + <div>」这种混排。
|
||||
"""
|
||||
if not isinstance(value, str) or not RICH_TAG.search(value):
|
||||
return value
|
||||
s = _ADJACENT_BLOCK.sub("\n", value)
|
||||
s = _BREAK_TAG.sub("\n", s)
|
||||
s = re.sub(r"<(?:p|div)\b[^>]{0,60}?>", "\n", s, flags=re.I)
|
||||
s = re.sub(r"<[^>]{0,80}?>", "", s)
|
||||
for k, v in _ENTITIES.items():
|
||||
s = s.replace(k, v)
|
||||
return re.sub(r"\n{3,}", "\n\n", s).strip()
|
||||
|
||||
|
||||
def _cell_width(value: Any) -> int:
|
||||
"""按中文字符占 2 个宽度估算显示宽度。"""
|
||||
s = "" if value is None else str(value)
|
||||
|
|
@ -93,7 +64,7 @@ def build_xlsx(
|
|||
|
||||
for r, row in enumerate(rows, head_row + 1):
|
||||
for c, v in enumerate(row, 1):
|
||||
cell = ws.cell(row=r, column=c, value=plain(v)) # 富文本降级成纯文本再入表
|
||||
cell = ws.cell(row=r, column=c, value=v)
|
||||
cell.border = BORDER
|
||||
cell.alignment = Alignment(vertical="top", wrap_text=False)
|
||||
if c in money_cols and isinstance(v, (int, float)):
|
||||
|
|
|
|||
264
app/finance.py
264
app/finance.py
|
|
@ -1,264 +0,0 @@
|
|||
"""定开项目财务口径:时间归属 + 季度 / 年度统计 + 年度计收目标。
|
||||
|
||||
历史数据有三个坑,统一在这里处理,前端只消费结果:
|
||||
· `accept_date` 只写季度(Q1~Q4)没有年份,跨年就混在一起(2025Q3 和 2026Q3
|
||||
都算「Q3」)→ 新增 `accept_year`,启动时按真实验收日期回填一次;
|
||||
· `accept_date_real` 是当年导入脚本按「季度末」补的占位日期,不能当统计依据 → 停用;
|
||||
· `sign_date` 存过自由文本(「2024年3月前」)→ 能识别出年份的才进年/季度口径。
|
||||
|
||||
统计周期以顶栏选中的周期为准:`period_id`(周)或 `year+month`(月),
|
||||
由后端换算成所属「年份 + 季度」,切到历史周期看到的就还是那一年的数。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
from datetime import date
|
||||
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from .constants import (
|
||||
CUSTOM_ANNUAL_TARGETS_DEFAULT,
|
||||
CUSTOM_PLACED_ORIGINS,
|
||||
derive_stage,
|
||||
parse_quarter,
|
||||
parse_year_month,
|
||||
quarter_end,
|
||||
quarter_of_month,
|
||||
)
|
||||
from .models import CustomProject, Period, Setting, now
|
||||
|
||||
__all__ = [
|
||||
"period_context", "accept_period", "sign_period", "accept_label", "is_placed",
|
||||
"summary", "read_annual_targets", "write_annual_targets", "backfill",
|
||||
]
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 统计上下文
|
||||
def period_context(db: Session, period_id: int | None = None,
|
||||
year: int | None = None, month: int | None = None) -> dict:
|
||||
"""把顶栏选中的周期换算成「年份 + 季度」,没选就取今天所在的年月。"""
|
||||
label = ""
|
||||
if period_id:
|
||||
per = db.get(Period, period_id)
|
||||
if per is not None:
|
||||
year, month = per.year, per.month
|
||||
label = per.full_label
|
||||
if not year or not month:
|
||||
today = date.today()
|
||||
year = int(year) if year else today.year
|
||||
month = int(month) if month else today.month
|
||||
month = min(12, max(1, int(month)))
|
||||
year = int(year)
|
||||
q = quarter_of_month(month)
|
||||
return {
|
||||
"period_id": period_id,
|
||||
"year": year,
|
||||
"month": month,
|
||||
"quarter": q,
|
||||
"label": label or f"{year}年{month}月",
|
||||
"quarter_label": f"{year}年Q{q}",
|
||||
"quarter_start": f"{year}-{(q - 1) * 3 + 1:02d}-01",
|
||||
"quarter_end": quarter_end(year, q),
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 时间归属
|
||||
def is_placed(cp: CustomProject) -> bool:
|
||||
"""已下单 = 项目归属属于「华智下单 / 存量项目 / 汇智直签」。"""
|
||||
return (cp.origin or "").strip() in CUSTOM_PLACED_ORIGINS
|
||||
|
||||
|
||||
def sign_period(cp: CustomProject) -> tuple[int | None, int | None]:
|
||||
"""下单时间 → (年份, 季度);文本认不出年份时返回 (None, None)。"""
|
||||
ym = parse_year_month(cp.sign_date)
|
||||
if not ym:
|
||||
return None, None
|
||||
year, month = ym
|
||||
return year, quarter_of_month(month) if month else None
|
||||
|
||||
|
||||
def accept_period(cp: CustomProject) -> tuple[int | None, int | None]:
|
||||
"""验收时间 → (年份, 季度)。年份只认 `accept_year`(缺年度就按「未定」不计入任何年份)。
|
||||
|
||||
刻意不看 `accept_date_real`:那是导入脚本按季度末补的占位日期,
|
||||
用它兜底会把「没填验收时间」的项目算进某一年,清掉年度也清不掉。
|
||||
老数据的一次性补齐在 `backfill()` 里做。
|
||||
"""
|
||||
return (cp.accept_year or None), parse_quarter(cp.accept_date)
|
||||
|
||||
|
||||
def accept_label(cp: CustomProject) -> str:
|
||||
"""界面上的验收时间:「2026Q3」;缺什么显示什么,全空返回空串。"""
|
||||
year, q = accept_period(cp)
|
||||
if year and q:
|
||||
return f"{year}Q{q}"
|
||||
if q:
|
||||
return f"Q{q}"
|
||||
return str(year) if year else ""
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 年度计收目标
|
||||
ANNUAL_TARGETS_PREFIX = "custom_annual_targets"
|
||||
|
||||
|
||||
def _targets_key(year: int) -> str:
|
||||
return f"{ANNUAL_TARGETS_PREFIX}:{year}"
|
||||
|
||||
|
||||
def read_annual_targets(db: Session, year: int) -> dict[str, float]:
|
||||
"""按年取四个季度的计收目标(万元);没配过的年份用默认值。"""
|
||||
row = db.get(Setting, _targets_key(year))
|
||||
# 没配过的年份用默认值;配过就以库里为准——在界面上清空某一季,读回来就得是 0
|
||||
saved = None
|
||||
if row and row.value:
|
||||
try:
|
||||
parsed = json.loads(row.value)
|
||||
saved = parsed if isinstance(parsed, dict) else None
|
||||
except (TypeError, ValueError):
|
||||
saved = None
|
||||
if saved is None:
|
||||
saved = {str(q): v for q, v in CUSTOM_ANNUAL_TARGETS_DEFAULT.items()}
|
||||
targets: dict[str, float] = {}
|
||||
for q in (1, 2, 3, 4):
|
||||
v = saved.get(str(q))
|
||||
try:
|
||||
targets[str(q)] = 0.0 if v in (None, "") else round(float(v), 2)
|
||||
except (TypeError, ValueError):
|
||||
targets[str(q)] = 0.0
|
||||
return targets
|
||||
|
||||
|
||||
def write_annual_targets(db: Session, year: int, targets: dict) -> dict[str, float]:
|
||||
clean: dict[str, float] = {}
|
||||
for q in (1, 2, 3, 4):
|
||||
v = (targets or {}).get(str(q))
|
||||
if v is None or v == "":
|
||||
clean[str(q)] = 0.0
|
||||
continue
|
||||
try:
|
||||
clean[str(q)] = round(float(v), 2)
|
||||
except (TypeError, ValueError):
|
||||
raise ValueError(f"Q{q} 目标值不是数字")
|
||||
value = json.dumps(clean, ensure_ascii=False)
|
||||
row = db.get(Setting, _targets_key(year))
|
||||
if row:
|
||||
row.value = value
|
||||
else:
|
||||
db.add(Setting(key=_targets_key(year), value=value))
|
||||
db.commit()
|
||||
return clean
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 统计
|
||||
def _sum(rows) -> float:
|
||||
return round(sum(float(r.amount or 0) for r in rows), 2)
|
||||
|
||||
|
||||
def summary(db: Session, ctx: dict) -> dict:
|
||||
"""定开财务汇总:KPI(当前季度 / 年度)+ 年度任务表(该年四个季度 + 未分季)。
|
||||
|
||||
金额单位一律「元」,展示层再折算万元;目标值是「万元」。
|
||||
「未分季」= 认得出年份、认不出季度(`sign_date` 只有「2024/」这类残缺值、
|
||||
或只有 `accept_year` 没有 `accept_date`)的项目:它们计入年度,
|
||||
但不属于任何一季度,所以单列一行,保证「四季度 + 未分季 = 合计 = KPI 年度」。
|
||||
"""
|
||||
year, q = ctx["year"], ctx["quarter"]
|
||||
rows = db.query(CustomProject).filter(CustomProject.archived.is_(False)).all()
|
||||
placed = [r for r in rows if is_placed(r)]
|
||||
|
||||
def signed(yy, qq):
|
||||
return [r for r in placed
|
||||
if (sy := sign_period(r))[0] == yy and (qq is None or sy[1] == qq)]
|
||||
|
||||
def accepted(yy, qq):
|
||||
return [r for r in rows
|
||||
if (ap := accept_period(r))[0] == yy and (qq is None or ap[1] == qq)]
|
||||
|
||||
def kpi(items):
|
||||
return {"count": len(items), "amount": _sum(items)}
|
||||
|
||||
sign_q, sign_y = signed(year, q), signed(year, None)
|
||||
acc_q, acc_y = accepted(year, q), accepted(year, None)
|
||||
# 数据质量:识别不出下单年份 / 缺验收年份的项目,页面上给计数,不静默漏算
|
||||
sign_unknown = [r for r in placed if sign_period(r)[0] is None]
|
||||
acc_no_year = [r for r in rows if accept_period(r)[1] and not accept_period(r)[0]]
|
||||
# 有年份、无季度:计入年度,不进任何一季度
|
||||
sign_no_q = [r for r in placed if (sy := sign_period(r))[0] == year and sy[1] is None]
|
||||
acc_no_q = [r for r in rows if (ap := accept_period(r))[0] == year and ap[1] is None]
|
||||
|
||||
targets = read_annual_targets(db, year)
|
||||
quarters = []
|
||||
for i in (1, 2, 3, 4):
|
||||
acc, sgn = accepted(year, i), signed(year, i)
|
||||
target = targets[str(i)]
|
||||
amount = _sum(acc)
|
||||
quarters.append({
|
||||
"q": i,
|
||||
"target": target, # 万元
|
||||
"acc_count": len(acc), "acc_amount": amount, # 元
|
||||
"sign_count": len(sgn), "sign_amount": _sum(sgn),
|
||||
"rate": round(amount / 10000 / target, 4) if target else None,
|
||||
"current": i == q,
|
||||
})
|
||||
return {
|
||||
"context": ctx,
|
||||
"kpi": {
|
||||
"placed": kpi(placed),
|
||||
"sign_quarter": kpi(sign_q),
|
||||
"sign_year": kpi(sign_y),
|
||||
"accept_quarter": kpi(acc_q),
|
||||
"accept_year": kpi(acc_y),
|
||||
"sign_unknown": len(sign_unknown),
|
||||
"accept_no_year": len(acc_no_year),
|
||||
"sign_no_quarter": len(sign_no_q),
|
||||
"accept_no_quarter": len(acc_no_q),
|
||||
},
|
||||
"annual": {
|
||||
"year": year,
|
||||
"targets": targets,
|
||||
"quarters": quarters,
|
||||
"unscheduled": {
|
||||
"acc_count": len(acc_no_q), "acc_amount": _sum(acc_no_q),
|
||||
"sign_count": len(sign_no_q), "sign_amount": _sum(sign_no_q),
|
||||
},
|
||||
"total": {
|
||||
"target": round(sum(t["target"] for t in quarters), 2),
|
||||
"acc_count": sum(t["acc_count"] for t in quarters) + len(acc_no_q),
|
||||
"acc_amount": round(sum(t["acc_amount"] for t in quarters) + _sum(acc_no_q), 2),
|
||||
"sign_count": sum(t["sign_count"] for t in quarters) + len(sign_no_q),
|
||||
"sign_amount": round(sum(t["sign_amount"] for t in quarters) + _sum(sign_no_q), 2),
|
||||
},
|
||||
},
|
||||
"generated_at": now().isoformat(timespec="seconds"),
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 老库回填
|
||||
def backfill(db: Session) -> list[str]:
|
||||
"""幂等回填:验收年份 + 由项目状态推导商务阶段。只在缺值 / 不一致时写。"""
|
||||
notes: list[str] = []
|
||||
rows = db.query(CustomProject).all()
|
||||
# 台账按年维护,缺年份的老行按库里出现过的最晚验收年份补(不随「今天」漂移)
|
||||
known = [ym[0] for r in rows
|
||||
if (ym := parse_year_month(r.accept_date_real)) and parse_quarter(r.accept_date)]
|
||||
fallback = max(known) if known else None
|
||||
years = stages = 0
|
||||
for r in rows:
|
||||
if r.accept_year is None and parse_quarter(r.accept_date):
|
||||
ym = parse_year_month(r.accept_date_real)
|
||||
r.accept_year = ym[0] if ym else fallback
|
||||
if r.accept_year:
|
||||
years += 1
|
||||
status = (r.project_status or "").strip()
|
||||
if status:
|
||||
want = derive_stage(status, r.stage)
|
||||
if r.stage != want:
|
||||
r.stage = want
|
||||
stages += 1
|
||||
if years or stages:
|
||||
db.commit()
|
||||
if years:
|
||||
notes.append(f"已补齐定制项目验收年份 {years} 条")
|
||||
if stages:
|
||||
notes.append(f"已按项目状态推导商务阶段 {stages} 条")
|
||||
return notes
|
||||
|
|
@ -3,39 +3,29 @@ from __future__ import annotations
|
|||
import uuid
|
||||
|
||||
from fastapi import Depends, FastAPI
|
||||
from fastapi.exceptions import RequestValidationError
|
||||
from fastapi.middleware.cors import CORSMiddleware
|
||||
from fastapi.responses import FileResponse, JSONResponse
|
||||
from fastapi.responses import FileResponse
|
||||
from fastapi.staticfiles import StaticFiles
|
||||
|
||||
from . import audit, config, finance, security
|
||||
from . import config, security
|
||||
from .db import Base, SessionLocal, engine
|
||||
from .routers import ai, auth, board, custom, export, focus, projects, rbac, staff, weekly
|
||||
from .schema_patch import drop_stale_columns, ensure_columns
|
||||
from .schema_patch import ensure_columns
|
||||
|
||||
Base.metadata.create_all(bind=engine)
|
||||
_patch = ensure_columns(engine, Base.metadata)
|
||||
if _patch:
|
||||
print(f"[ok] 已补齐数据库字段:{', '.join(_patch)}")
|
||||
_dropped = drop_stale_columns(engine)
|
||||
if _dropped:
|
||||
print(f"[ok] 已清理历史死列:{', '.join(_dropped)}")
|
||||
|
||||
# 内置角色与管理员(一次性旧库迁移 migrate_legacy_rbac 已于 2026-11 下线:
|
||||
# 它只服务 2026-10-01 之前的库;那种库请先升级到含迁移的版本再上当前版本)
|
||||
# 内置角色 + 管理员账号(只在缺失时补,不会覆盖已改过的密码/权限)
|
||||
with SessionLocal() as _db:
|
||||
for _note in security.ensure_seed(_db):
|
||||
print(f"[ok] {_note}")
|
||||
security.purge_expired_sessions(_db)
|
||||
audit.prune(_db)
|
||||
# 定开财务口径回填(验收年份 / 由项目状态推导阶段),幂等
|
||||
for _note in finance.backfill(_db):
|
||||
print(f"[ok] {_note}")
|
||||
|
||||
# 每次进程启动换一个值;热加载重启后前端据此自动刷新
|
||||
BOOT_ID = uuid.uuid4().hex
|
||||
|
||||
app = FastAPI(title="DMS管理平台", version="1.0.0")
|
||||
app = FastAPI(title="部门关键任务追踪看板", version="1.0.0")
|
||||
|
||||
app.add_middleware(
|
||||
CORSMiddleware,
|
||||
|
|
@ -45,26 +35,7 @@ app.add_middleware(
|
|||
)
|
||||
|
||||
# 所有 /api 接口先过 RBAC 总闸(登录 + 菜单权限),登录接口自身除外
|
||||
api = FastAPI(title="DMS管理平台 API", dependencies=[Depends(security.guard)])
|
||||
|
||||
|
||||
@api.exception_handler(RequestValidationError)
|
||||
async def validation_error_cn(request, exc):
|
||||
"""Pydantic/查询参数校验失败默认返回英文 detail,前端会原样 toast 出「Field required」。
|
||||
统一换成中文,界面不再中英夹杂。"""
|
||||
bits = []
|
||||
for e in exc.errors():
|
||||
field = str(e.get("loc", ("?",))[-1])
|
||||
kind = "不能为空" if str(e.get("type", "")).endswith("missing") else "格式不正确"
|
||||
bits.append(f"「{field}」{kind}")
|
||||
return JSONResponse(status_code=422, content={"detail": "提交的数据有误:" + ";".join(bits)})
|
||||
|
||||
|
||||
@api.exception_handler(Exception)
|
||||
async def server_error_cn(request, exc):
|
||||
"""未捕获异常的默认响应是纯文本 'Internal Server Error',同样会被前端 toast 出来。"""
|
||||
return JSONResponse(status_code=500, content={"detail": "服务器内部错误,请稍后重试"})
|
||||
api.middleware("http")(audit.audit_middleware_factory())
|
||||
api = FastAPI(title="部门关键任务追踪看板 API", dependencies=[Depends(security.guard)])
|
||||
api.include_router(board.router, prefix="", tags=["board"])
|
||||
api.include_router(projects.router, prefix="", tags=["projects"])
|
||||
api.include_router(ai.router, prefix="", tags=["ai"])
|
||||
|
|
@ -77,21 +48,16 @@ api.include_router(auth.router, prefix="", tags=["auth"])
|
|||
api.include_router(rbac.router, prefix="", tags=["rbac"])
|
||||
app.mount("/api", api)
|
||||
|
||||
# 前端是 Vite 构建产物(web/src → web/dist,栈见 nex.config.yaml:React + TS + AntD + Tailwind v4)。
|
||||
# 没构建时退回 web/legacy(改造前的零构建版),本地与容器里都不会白屏。
|
||||
# 构建资源以 /static/ 为 base(见 web/vite.config.ts),所以静态目录整个挂到 /static。
|
||||
WEB_DIR = config.BASE_DIR / "web"
|
||||
DIST_DIR = WEB_DIR / "dist"
|
||||
STATIC_DIR = DIST_DIR if (DIST_DIR / "index.html").is_file() else WEB_DIR / "legacy"
|
||||
app.mount("/static", StaticFiles(directory=str(STATIC_DIR)), name="static")
|
||||
app.mount("/static", StaticFiles(directory=str(WEB_DIR)), name="static")
|
||||
|
||||
|
||||
# index.html 不能启发式缓存(它指向的产物文件名带哈希,只有 index.html 会变),
|
||||
# no-cache 不做新鲜度缓存、只带 ETag 回源校验(未变更时返回 304)。
|
||||
# 前端零构建、文件名不带版本号,浏览器会启发式缓存 index.html / app.js / styles.css,
|
||||
# 改完界面看不到新版。no-cache 不做新鲜度缓存、只带 ETag 回源校验(未变更时返回 304)。
|
||||
@app.middleware("http")
|
||||
async def no_cache_frontend(request, call_next):
|
||||
response = await call_next(request)
|
||||
if request.url.path == "/" or request.url.path.startswith("/static/"): # 产物文件名带哈希,index.html 才是不缓存的关键
|
||||
if request.url.path == "/" or request.url.path.startswith("/static/"):
|
||||
response.headers["Cache-Control"] = "no-cache"
|
||||
return response
|
||||
|
||||
|
|
@ -108,13 +74,4 @@ def health():
|
|||
|
||||
@app.get("/")
|
||||
def index():
|
||||
return FileResponse(str(STATIC_DIR / "index.html"))
|
||||
|
||||
|
||||
@app.get("/{path:path}")
|
||||
def spa(path: str):
|
||||
"""单页应用深链:/custom、/settings/… 这类路径没有实体文件,一律交回 index.html 由前端路由。
|
||||
带扩展名的请求(.js/.css/.svg…)已经由各 mount 接走,落到这里就是 404,不要假装修上了。"""
|
||||
if "." in path.rsplit("/", 1)[-1]:
|
||||
return JSONResponse({"detail": "没有这个资源"}, status_code=404)
|
||||
return FileResponse(str(STATIC_DIR / "index.html"))
|
||||
return FileResponse(str(WEB_DIR / "index.html"))
|
||||
|
|
|
|||
|
|
@ -1,11 +1,12 @@
|
|||
"""数据模型。
|
||||
|
||||
层级:Period(周期) -> Project(主要项目/工作项) -> Task(子任务) -> Update(执行情况)
|
||||
辅助:Category(分类) / Tag(标记) / Setting(配置)
|
||||
辅助:Category(分类) / Tag(标记) / LedgerItem(客户项目台账) / Setting(配置)
|
||||
权限:Role(角色,一份菜单权限) <- User(用户) ; UserSession(登录会话)
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
from datetime import datetime
|
||||
|
||||
from sqlalchemy import (
|
||||
|
|
@ -21,7 +22,6 @@ from sqlalchemy import (
|
|||
)
|
||||
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
||||
|
||||
from .constants import LEVEL_RANK, merge_levels
|
||||
from .db import Base
|
||||
|
||||
|
||||
|
|
@ -99,7 +99,7 @@ class TimestampMixin:
|
|||
|
||||
|
||||
class Category(Base, TimestampMixin):
|
||||
"""项目分类(如 平台产品 / AI / 定制项目 / 内部运营)。"""
|
||||
"""项目分类(如 平台产品 / AI / 定开项目 / 内部运营)。"""
|
||||
|
||||
__tablename__ = "categories"
|
||||
|
||||
|
|
@ -149,10 +149,12 @@ class Project(Base, TimestampMixin):
|
|||
other_owners: Mapped[str | None] = mapped_column(String(512), nullable=True) # 其他负责人
|
||||
members: Mapped[str | None] = mapped_column(String(512), nullable=True) # 团队成员
|
||||
status: Mapped[str] = mapped_column(String(32), default="in_progress", nullable=False)
|
||||
# priority / description 两列 2026-11-04 下线:无任何界面读写,导出恒为「P2 中」
|
||||
priority: Mapped[str] = mapped_column(String(8), default="p2", nullable=False)
|
||||
is_key: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False) # 重点标记
|
||||
progress: Mapped[float] = mapped_column(Float, default=0.0, nullable=False) # 最新进度 %
|
||||
description: Mapped[str | None] = mapped_column(Text, nullable=True)
|
||||
archived: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
|
||||
sort_order: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
|
||||
|
||||
category: Mapped[Category | None] = relationship(back_populates="projects")
|
||||
tags: Mapped[list[Tag]] = relationship(secondary=project_tags, lazy="selectin")
|
||||
|
|
@ -173,9 +175,12 @@ class Project(Base, TimestampMixin):
|
|||
"owners": all_owners(self.owner, self.other_owners),
|
||||
"members": split_people(self.members),
|
||||
"status": self.status,
|
||||
"priority": self.priority,
|
||||
"is_key": self.is_key,
|
||||
"progress": round(self.progress or 0, 1),
|
||||
"description": self.description,
|
||||
"archived": self.archived,
|
||||
"sort_order": self.sort_order,
|
||||
"tags": [t.to_dict() for t in self.tags],
|
||||
"updated_at": self.updated_at.isoformat(timespec="seconds") if self.updated_at else None,
|
||||
}
|
||||
|
|
@ -192,20 +197,17 @@ class Period(Base):
|
|||
|
||||
id: Mapped[int] = mapped_column(Integer, primary_key=True)
|
||||
label: Mapped[str] = mapped_column(String(64), nullable=False) # 8月第4周
|
||||
kind: Mapped[str] = mapped_column(String(16), default="week", nullable=False) # 恒为 week:月粒度由 year/month 合成,此列只是留门(无任何读取方)
|
||||
kind: Mapped[str] = mapped_column(String(16), default="week", nullable=False) # week|month
|
||||
year: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
month: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
week: Mapped[int] = mapped_column(Integer, default=0, nullable=False) # 月视图为 0
|
||||
start_date: Mapped[str | None] = mapped_column(String(16), nullable=True)
|
||||
end_date: Mapped[str | None] = mapped_column(String(16), nullable=True)
|
||||
# 排序键:year*10000 + month*100 + week
|
||||
sort_key: Mapped[int] = mapped_column(Integer, nullable=False, index=True)
|
||||
|
||||
updates: Mapped[list["Update"]] = relationship(back_populates="period")
|
||||
|
||||
@property
|
||||
def full_label(self) -> str:
|
||||
"""「2026年10月第2周」:label 只有「10月第2周」,跨年展示一律用这个。"""
|
||||
return f"{self.year}年{self.month}月" + (f"第{self.week}周" if self.week else "")
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
"id": self.id,
|
||||
|
|
@ -214,8 +216,10 @@ class Period(Base):
|
|||
"year": self.year,
|
||||
"month": self.month,
|
||||
"week": self.week,
|
||||
"start_date": self.start_date,
|
||||
"end_date": self.end_date,
|
||||
"sort_key": self.sort_key,
|
||||
"full_label": self.full_label,
|
||||
"full_label": f"{self.year}年{self.month}月" + (f"第{self.week}周" if self.week else ""),
|
||||
}
|
||||
|
||||
|
||||
|
|
@ -229,6 +233,7 @@ class Task(Base, TimestampMixin):
|
|||
Integer, ForeignKey("projects.id", ondelete="CASCADE"), nullable=False, index=True
|
||||
)
|
||||
name: Mapped[str] = mapped_column(String(255), nullable=False)
|
||||
sort_order: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
|
||||
|
||||
project: Mapped[Project] = relationship(back_populates="tasks")
|
||||
updates: Mapped[list["Update"]] = relationship(back_populates="task")
|
||||
|
|
@ -238,6 +243,7 @@ class Task(Base, TimestampMixin):
|
|||
"id": self.id,
|
||||
"project_id": self.project_id,
|
||||
"name": self.name,
|
||||
"sort_order": self.sort_order,
|
||||
}
|
||||
|
||||
|
||||
|
|
@ -340,8 +346,37 @@ class WeeklyFocus(Base, TimestampMixin):
|
|||
}
|
||||
|
||||
|
||||
class LedgerItem(Base, TimestampMixin):
|
||||
"""客户项目台账(来自《项目明细表》:区域 / 金额 / 类别 / 状态说明)。"""
|
||||
|
||||
__tablename__ = "ledger_items"
|
||||
|
||||
id: Mapped[int] = mapped_column(Integer, primary_key=True)
|
||||
name: Mapped[str] = mapped_column(String(255), nullable=False)
|
||||
region: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
amount: Mapped[float | None] = mapped_column(Float, nullable=True)
|
||||
category: Mapped[str | None] = mapped_column(String(32), nullable=True)
|
||||
status_note: Mapped[str | None] = mapped_column(Text, nullable=True)
|
||||
period_label: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
period_id: Mapped[int | None] = mapped_column(
|
||||
Integer, ForeignKey("periods.id", ondelete="SET NULL"), nullable=True
|
||||
)
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
"id": self.id,
|
||||
"name": self.name,
|
||||
"region": self.region,
|
||||
"amount": self.amount,
|
||||
"category": self.category,
|
||||
"status_note": self.status_note,
|
||||
"period_label": self.period_label,
|
||||
"period_id": self.period_id,
|
||||
}
|
||||
|
||||
|
||||
class CustomProject(Base, TimestampMixin):
|
||||
"""定制项目(与通用研发项目完全分离)。
|
||||
"""定开项目(与通用研发项目完全分离)。
|
||||
|
||||
关注:商务阶段流转(签单 → 开发 → 交付 → 验收 → 计收)与按进度确认收入。
|
||||
"""
|
||||
|
|
@ -353,6 +388,7 @@ class CustomProject(Base, TimestampMixin):
|
|||
customer: Mapped[str | None] = mapped_column(String(128), nullable=True) # 客户 / 办事处
|
||||
region: Mapped[str | None] = mapped_column(String(64), nullable=True) # 区域(省/办)
|
||||
amount: Mapped[float | None] = mapped_column(Float, nullable=True) # 合同/订单金额
|
||||
currency: Mapped[str] = mapped_column(String(8), default="CNY", nullable=False)
|
||||
|
||||
stage: Mapped[str] = mapped_column(String(32), default="signed", nullable=False, index=True)
|
||||
progress: Mapped[float] = mapped_column(Float, default=0.0, nullable=False) # 开发进度 %
|
||||
|
|
@ -360,7 +396,7 @@ class CustomProject(Base, TimestampMixin):
|
|||
revenue_amount: Mapped[float | None] = mapped_column(Float, nullable=True) # 已计收金额
|
||||
|
||||
owner: Mapped[str | None] = mapped_column(String(64), nullable=True) # 交付负责人(单人)
|
||||
other_owners: Mapped[str | None] = mapped_column(String(512), nullable=True) # 已停用:定制项目不做多负责人
|
||||
other_owners: Mapped[str | None] = mapped_column(String(512), nullable=True) # 已停用:定开项目不做多负责人
|
||||
members: Mapped[str | None] = mapped_column(String(512), nullable=True) # 团队成员
|
||||
entry_date: Mapped[str | None] = mapped_column(String(16), nullable=True) # 入库时间(YYYY-MM-DD)
|
||||
sign_date: Mapped[str | None] = mapped_column(String(16), nullable=True) # 签单/下单时间
|
||||
|
|
@ -400,11 +436,9 @@ class CustomProject(Base, TimestampMixin):
|
|||
update_date: Mapped[str | None] = mapped_column(
|
||||
String(16), nullable=True, index=True
|
||||
) # 更新时间 YYYY-MM-DD:该行数据最后一次变动的日期,用于按周查看变化
|
||||
# 验收年份:accept_date 只有季度(Q1~Q4),跨统计年度时必须靠它区分 2025Q3 与 2026Q3
|
||||
accept_year: Mapped[int | None] = mapped_column(Integer, nullable=True, index=True)
|
||||
accept_date_real: Mapped[str | None] = mapped_column(
|
||||
String(16), nullable=True, index=True
|
||||
) # 已停用:早期导入脚本按季度末补的占位日期。验收时间统一看 accept_year + accept_date
|
||||
) # 验收日期 YYYY-MM-DD(真实日期):与 accept_date(季度文本)区分,用于「本月/本年验收」统计
|
||||
|
||||
updates: Mapped[list["CustomUpdate"]] = relationship(
|
||||
back_populates="project", cascade="all, delete-orphan"
|
||||
|
|
@ -412,11 +446,8 @@ class CustomProject(Base, TimestampMixin):
|
|||
|
||||
def to_dict(self, with_revenue: bool = True):
|
||||
from .constants import custom_revenue_ratio
|
||||
from .finance import accept_label
|
||||
|
||||
ratio = custom_revenue_ratio(
|
||||
self.stage, self.progress, self.manual_ratio, self.project_status
|
||||
)
|
||||
ratio = custom_revenue_ratio(self.stage, self.progress, self.manual_ratio)
|
||||
data = {
|
||||
"id": self.id,
|
||||
"name": self.name,
|
||||
|
|
@ -453,8 +484,6 @@ class CustomProject(Base, TimestampMixin):
|
|||
"risk_level": self.risk_level,
|
||||
"update_date": self.update_date,
|
||||
"accept_date_real": self.accept_date_real,
|
||||
"accept_year": self.accept_year,
|
||||
"accept_label": accept_label(self),
|
||||
"update_count": len(self.updates),
|
||||
"updated_at": self.updated_at.isoformat(timespec="seconds") if self.updated_at else None,
|
||||
}
|
||||
|
|
@ -474,7 +503,7 @@ class CustomProject(Base, TimestampMixin):
|
|||
|
||||
|
||||
class CustomUpdate(Base, TimestampMixin):
|
||||
"""定制项目的阶段流转 / 周期执行记录(独立表)。"""
|
||||
"""定开项目的阶段流转 / 周期执行记录(独立表)。"""
|
||||
|
||||
__tablename__ = "custom_updates"
|
||||
|
||||
|
|
@ -528,7 +557,7 @@ class CustomUpdate(Base, TimestampMixin):
|
|||
class Staff(Base, TimestampMixin):
|
||||
"""人力资源库成员。
|
||||
|
||||
项目管理 / 定制项目的负责人一律从这里选取;归档后不再出现在下拉里,
|
||||
项目管理 / 定开项目的负责人一律从这里选取;归档后不再出现在下拉里,
|
||||
历史记录中的人名保持不变。
|
||||
"""
|
||||
|
||||
|
|
@ -578,28 +607,42 @@ class ImportLog(Base):
|
|||
model: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(DateTime, default=now, nullable=False)
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
"id": self.id,
|
||||
"project_id": self.project_id,
|
||||
"period_id": self.period_id,
|
||||
"mode": self.mode,
|
||||
"model": self.model,
|
||||
"raw_input": (self.raw_input or "")[:400],
|
||||
"created_at": self.created_at.isoformat(timespec="seconds") if self.created_at else None,
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------- 权限
|
||||
# 三层模型:用户 ←(多对多)→ 角色 ←(一对多)→ 菜单授权
|
||||
# user_roles :一个用户可以挂多个角色,权限取并集(同一菜单取更高级别)
|
||||
# role_menus :角色的菜单授权矩阵,一行 = 一个菜单一个级别(rw / ro)
|
||||
# audit_logs :写操作与登录行为的审计流水
|
||||
class Role(Base, TimestampMixin):
|
||||
"""角色 = 一组菜单授权(rw 可编辑 / ro 只读 / 没有这一行就是看不到)。"""
|
||||
"""角色 = 一组功能菜单权限。
|
||||
|
||||
menus 存 JSON 文本:{"board":"rw","projects":"ro"},
|
||||
键是菜单标识(见 security.MENUS),值 rw=可编辑 / ro=只读;没有这个键就是看不到该菜单。
|
||||
"""
|
||||
|
||||
__tablename__ = "roles"
|
||||
|
||||
id: Mapped[int] = mapped_column(Integer, primary_key=True)
|
||||
name: Mapped[str] = mapped_column(String(64), unique=True, nullable=False)
|
||||
description: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
||||
menus: Mapped[str | None] = mapped_column(Text, nullable=True)
|
||||
is_builtin: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
|
||||
|
||||
grants: Mapped[list["RoleMenu"]] = relationship(
|
||||
back_populates="role", cascade="all, delete-orphan", lazy="selectin"
|
||||
)
|
||||
|
||||
def menu_map(self) -> dict:
|
||||
return {g.menu: g.level for g in self.grants if g.level}
|
||||
if not self.menus:
|
||||
return {}
|
||||
try:
|
||||
data = json.loads(self.menus)
|
||||
except ValueError:
|
||||
return {}
|
||||
return data if isinstance(data, dict) else {}
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
|
|
@ -612,27 +655,8 @@ class Role(Base, TimestampMixin):
|
|||
}
|
||||
|
||||
|
||||
class RoleMenu(Base):
|
||||
"""角色对某个菜单的授权级别。级别只有 rw / ro,表里没有这一行就是无权限。"""
|
||||
|
||||
__tablename__ = "role_menus"
|
||||
|
||||
role_id: Mapped[int] = mapped_column(
|
||||
Integer, ForeignKey("roles.id", ondelete="CASCADE"), primary_key=True
|
||||
)
|
||||
menu: Mapped[str] = mapped_column(String(32), primary_key=True)
|
||||
level: Mapped[str] = mapped_column(String(8), nullable=False)
|
||||
created_at: Mapped[datetime] = mapped_column(DateTime, default=now, nullable=False)
|
||||
|
||||
role: Mapped["Role"] = relationship(back_populates="grants")
|
||||
|
||||
|
||||
class User(Base, TimestampMixin):
|
||||
"""登录用户。密码只存 pbkdf2 派生值 + 盐,不存明文。
|
||||
|
||||
角色是多对多:`user.roles`。`menus` 是所有角色授权的并集,
|
||||
同一个菜单被多个角色命中时取更高级别(rw > ro)。
|
||||
"""
|
||||
"""登录用户。密码只存 pbkdf2 派生值 + 盐,不存明文。"""
|
||||
|
||||
__tablename__ = "users"
|
||||
|
||||
|
|
@ -641,28 +665,23 @@ class User(Base, TimestampMixin):
|
|||
username: Mapped[str] = mapped_column(String(64), unique=True, nullable=False)
|
||||
password_hash: Mapped[str] = mapped_column(String(128), nullable=False)
|
||||
password_salt: Mapped[str] = mapped_column(String(64), nullable=False)
|
||||
role_id: Mapped[int | None] = mapped_column(Integer, ForeignKey("roles.id", ondelete="SET NULL"), nullable=True)
|
||||
active: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
|
||||
last_login_at: Mapped[datetime | None] = mapped_column(DateTime, nullable=True)
|
||||
|
||||
roles: Mapped[list["Role"]] = relationship(
|
||||
"Role", secondary="user_roles", lazy="selectin", order_by="Role.id"
|
||||
)
|
||||
role: Mapped[Role | None] = relationship("Role", lazy="joined")
|
||||
|
||||
@property
|
||||
def menus(self) -> dict:
|
||||
return merge_levels(*[r.menu_map() for r in self.roles])
|
||||
|
||||
@property
|
||||
def role_names(self) -> list[str]:
|
||||
return [r.name for r in self.roles]
|
||||
return self.role.menu_map() if self.role else {}
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
"id": self.id,
|
||||
"name": self.name,
|
||||
"username": self.username,
|
||||
"role_ids": [r.id for r in self.roles],
|
||||
"role_names": self.role_names,
|
||||
"role_id": self.role_id,
|
||||
"role_name": self.role.name if self.role else None,
|
||||
"menus": self.menus,
|
||||
"active": self.active,
|
||||
"last_login_at": self.last_login_at.isoformat(timespec="seconds") if self.last_login_at else None,
|
||||
|
|
@ -670,22 +689,8 @@ class User(Base, TimestampMixin):
|
|||
}
|
||||
|
||||
|
||||
class UserRole(Base):
|
||||
"""用户与角色的关联(多角色)。"""
|
||||
|
||||
__tablename__ = "user_roles"
|
||||
|
||||
user_id: Mapped[int] = mapped_column(
|
||||
Integer, ForeignKey("users.id", ondelete="CASCADE"), primary_key=True
|
||||
)
|
||||
role_id: Mapped[int] = mapped_column(
|
||||
Integer, ForeignKey("roles.id", ondelete="CASCADE"), primary_key=True
|
||||
)
|
||||
created_at: Mapped[datetime] = mapped_column(DateTime, default=now, nullable=False)
|
||||
|
||||
|
||||
class UserSession(Base):
|
||||
"""登录会话。退出登录 / 禁用用户 / 改密时删掉对应 token 即可立即失效。"""
|
||||
"""登录会话。退出登录 / 禁用用户时删掉对应 token 即可立即失效。"""
|
||||
|
||||
__tablename__ = "user_sessions"
|
||||
|
||||
|
|
@ -693,46 +698,3 @@ class UserSession(Base):
|
|||
user_id: Mapped[int] = mapped_column(Integer, ForeignKey("users.id", ondelete="CASCADE"), nullable=False)
|
||||
created_at: Mapped[datetime] = mapped_column(DateTime, default=now, nullable=False)
|
||||
expires_at: Mapped[datetime] = mapped_column(DateTime, nullable=False)
|
||||
ip: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
user_agent: Mapped[str | None] = mapped_column(String(128), nullable=True)
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
"token_hint": self.token[:6] + "…",
|
||||
"created_at": self.created_at.isoformat(timespec="seconds") if self.created_at else None,
|
||||
"expires_at": self.expires_at.isoformat(timespec="seconds") if self.expires_at else None,
|
||||
"ip": self.ip,
|
||||
"user_agent": self.user_agent,
|
||||
}
|
||||
|
||||
|
||||
class AuditLog(Base):
|
||||
"""操作审计:所有写操作 + 登录/退出,成功失败都留痕。"""
|
||||
|
||||
__tablename__ = "audit_logs"
|
||||
|
||||
id: Mapped[int] = mapped_column(Integer, primary_key=True)
|
||||
user_id: Mapped[int | None] = mapped_column(Integer, nullable=True, index=True)
|
||||
username: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
||||
action: Mapped[str] = mapped_column(String(16), nullable=False, index=True) # create/update/delete/login/logout/deny
|
||||
menu: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
|
||||
method: Mapped[str] = mapped_column(String(8), nullable=False)
|
||||
path: Mapped[str] = mapped_column(String(255), nullable=False)
|
||||
status: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
ip: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
detail: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(DateTime, default=now, nullable=False, index=True)
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
"id": self.id,
|
||||
"user_id": self.user_id,
|
||||
"username": self.username,
|
||||
"action": self.action,
|
||||
"menu": self.menu,
|
||||
"method": self.method,
|
||||
"path": self.path,
|
||||
"status": self.status,
|
||||
"detail": self.detail,
|
||||
"created_at": self.created_at.isoformat(timespec="seconds") if self.created_at else None,
|
||||
}
|
||||
|
|
|
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -5,7 +5,7 @@ import json
|
|||
from fastapi import APIRouter, Depends, HTTPException
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from .. import ai_parser, constants
|
||||
from .. import ai_parser
|
||||
from ..db import get_db
|
||||
from ..models import ImportLog, Period, Project, Task, Update
|
||||
from ..schemas import AICommitIn, AIParseIn
|
||||
|
|
@ -13,9 +13,7 @@ from ..schemas import AICommitIn, AIParseIn
|
|||
router = APIRouter()
|
||||
|
||||
|
||||
def _resolve_project(db: Session, project_id: int | None, project_name: str | None,
|
||||
*, create: bool = False) -> Project | None:
|
||||
"""按 id 或名称取项目。只有确认写入时才允许按名称新建,预览整理不碰库。"""
|
||||
def _resolve_project(db: Session, project_id: int | None, project_name: str | None) -> Project | None:
|
||||
if project_id:
|
||||
p = db.get(Project, project_id)
|
||||
if not p:
|
||||
|
|
@ -23,7 +21,7 @@ def _resolve_project(db: Session, project_id: int | None, project_name: str | No
|
|||
return p
|
||||
if project_name:
|
||||
p = db.query(Project).filter(Project.name == project_name).one_or_none()
|
||||
if not p and create:
|
||||
if not p:
|
||||
p = Project(name=project_name)
|
||||
db.add(p)
|
||||
db.flush()
|
||||
|
|
@ -33,11 +31,8 @@ def _resolve_project(db: Session, project_id: int | None, project_name: str | No
|
|||
|
||||
@router.post("/ai/parse")
|
||||
def ai_parse(payload: AIParseIn, db: Session = Depends(get_db)):
|
||||
"""整理预览:只读。写了新项目名也不会建项目,确认写入时才建。"""
|
||||
project = _resolve_project(db, payload.project_id, payload.project_name)
|
||||
period = db.get(Period, payload.period_id) if payload.period_id else None
|
||||
if payload.period_id and not period:
|
||||
raise HTTPException(404, "周期不存在")
|
||||
|
||||
parsed, mode, error = ai_parser.parse(
|
||||
payload.raw_text,
|
||||
|
|
@ -60,7 +55,7 @@ def ai_parse(payload: AIParseIn, db: Session = Depends(get_db)):
|
|||
|
||||
@router.post("/ai/commit")
|
||||
def ai_commit(payload: AICommitIn, db: Session = Depends(get_db)):
|
||||
project = _resolve_project(db, payload.project_id, payload.project_name, create=True)
|
||||
project = _resolve_project(db, payload.project_id, payload.project_name)
|
||||
if not project:
|
||||
raise HTTPException(400, "缺少项目信息")
|
||||
period = db.get(Period, payload.period_id)
|
||||
|
|
@ -98,7 +93,7 @@ def ai_commit(payload: AICommitIn, db: Session = Depends(get_db)):
|
|||
.one_or_none()
|
||||
)
|
||||
if not task:
|
||||
task = Task(project_id=project.id, name=name)
|
||||
task = Task(project_id=project.id, name=name, sort_order=idx)
|
||||
db.add(task)
|
||||
db.flush()
|
||||
risk = (t.get("risk") or "").strip() or (risks[0] if idx == 0 and risks else None)
|
||||
|
|
@ -120,13 +115,8 @@ def ai_commit(payload: AICommitIn, db: Session = Depends(get_db)):
|
|||
created.append(u)
|
||||
|
||||
if parsed.get("progress") is not None:
|
||||
try:
|
||||
project.progress = float(parsed["progress"]) or 0
|
||||
except (TypeError, ValueError):
|
||||
raise HTTPException(400, "进度必须是数字")
|
||||
project.progress = float(parsed["progress"]) or 0
|
||||
if parsed.get("status"):
|
||||
if parsed["status"] not in constants.STATUS_CODES:
|
||||
raise HTTPException(400, "状态不认识:" + str(parsed["status"]))
|
||||
project.status = parsed["status"]
|
||||
|
||||
db.add(
|
||||
|
|
@ -146,3 +136,9 @@ def ai_commit(payload: AICommitIn, db: Session = Depends(get_db)):
|
|||
"project": project.to_dict(),
|
||||
"created": [u.to_dict() for u in created],
|
||||
}
|
||||
|
||||
|
||||
@router.get("/ai/logs")
|
||||
def ai_logs(limit: int = 20, db: Session = Depends(get_db)):
|
||||
rows = db.query(ImportLog).order_by(ImportLog.id.desc()).limit(limit).all()
|
||||
return [r.to_dict() for r in rows]
|
||||
|
|
|
|||
|
|
@ -1,68 +1,25 @@
|
|||
"""登录 / 退出 / 当前用户 / 自己的设置(昵称、密码)。
|
||||
|
||||
登录失败按「账号 + IP」限流:连错 5 次锁 5 分钟,成功一次即清零。
|
||||
进程内计数,重启即复位——防的是脚本撞库,不追求分布式精确。
|
||||
"""
|
||||
"""登录 / 退出 / 当前用户 / 用户自己的设置(昵称、密码)。"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from collections import defaultdict, deque
|
||||
|
||||
from fastapi import APIRouter, Depends, HTTPException, Request, Response
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from .. import audit, config, security
|
||||
from .. import config, security
|
||||
from ..db import get_db
|
||||
from ..models import User
|
||||
from ..schemas import LoginIn, PasswordIn, ProfileIn
|
||||
|
||||
router = APIRouter()
|
||||
|
||||
MAX_FAILS = 5
|
||||
LOCK_SECONDS = 300
|
||||
_failures: dict[str, deque] = defaultdict(deque)
|
||||
|
||||
|
||||
def _throttle_key(request: Request, username: str) -> str:
|
||||
return f"{audit.client_ip(request) or '?'}|{username}"
|
||||
|
||||
|
||||
def _check_lock(key: str) -> None:
|
||||
now = time.time()
|
||||
hits = _failures[key]
|
||||
while hits and now - hits[0] > LOCK_SECONDS:
|
||||
hits.popleft()
|
||||
if len(hits) >= MAX_FAILS:
|
||||
wait = int(LOCK_SECONDS - (now - hits[0])) + 1
|
||||
raise HTTPException(status_code=429, detail=f"密码连续输错 {MAX_FAILS} 次,请 {wait} 秒后再试")
|
||||
|
||||
|
||||
def _mark_fail(key: str) -> None:
|
||||
_failures[key].append(time.time())
|
||||
|
||||
|
||||
def _clear_fail(key: str) -> None:
|
||||
_failures.pop(key, None)
|
||||
|
||||
|
||||
@router.post("/auth/login")
|
||||
def login(body: LoginIn, request: Request, response: Response, db: Session = Depends(get_db)):
|
||||
username = (body.username or "").strip()
|
||||
key = _throttle_key(request, username)
|
||||
_check_lock(key)
|
||||
user = db.query(User).filter(User.username == username).one_or_none()
|
||||
def login(body: LoginIn, response: Response, db: Session = Depends(get_db)):
|
||||
user = db.query(User).filter(User.username == (body.username or "").strip()).one_or_none()
|
||||
if user is None or not security.verify_password(body.password or "", user.password_hash, user.password_salt):
|
||||
_mark_fail(key)
|
||||
audit.note(request, f"登录失败:{username}", username=username or None)
|
||||
raise HTTPException(status_code=401, detail="用户名或密码不正确")
|
||||
if not user.active:
|
||||
audit.note(request, f"账号已停用:{username}", username=username or None)
|
||||
raise HTTPException(status_code=403, detail="该账号已被停用,请联系管理员")
|
||||
_clear_fail(key)
|
||||
token = security.start_session(
|
||||
db, user, ip=audit.client_ip(request), user_agent=request.headers.get("user-agent")
|
||||
)
|
||||
request.state.user = user
|
||||
token = security.start_session(db, user)
|
||||
response.set_cookie(
|
||||
security.SESSION_COOKIE, token,
|
||||
max_age=config.SESSION_DAYS * 86400,
|
||||
|
|
@ -75,7 +32,6 @@ def login(body: LoginIn, request: Request, response: Response, db: Session = Dep
|
|||
def logout(request: Request, response: Response, db: Session = Depends(get_db)):
|
||||
token = request.cookies.get(security.SESSION_COOKIE)
|
||||
if token:
|
||||
request.state.user = security.user_from_token(db, token)
|
||||
db.query(security.UserSession).filter(security.UserSession.token == token).delete()
|
||||
db.commit()
|
||||
response.delete_cookie(security.SESSION_COOKIE, path="/")
|
||||
|
|
@ -105,11 +61,12 @@ def change_password(body: PasswordIn, request: Request, response: Response,
|
|||
new = (body.new_password or "").strip()
|
||||
if len(new) < 6:
|
||||
raise HTTPException(status_code=400, detail="新密码至少 6 位")
|
||||
if new == (body.old_password or ""):
|
||||
raise HTTPException(status_code=400, detail="新密码不能与原密码相同")
|
||||
user.password_hash, user.password_salt = security.hash_password(new)
|
||||
audit.note(request, "修改自己的密码")
|
||||
# 改密后其余设备全部下线,只保留当前这次登录
|
||||
keep = request.cookies.get(security.SESSION_COOKIE)
|
||||
security.revoke_all(db, user.id, keep_token=keep)
|
||||
query = db.query(security.UserSession).filter(security.UserSession.user_id == user.id)
|
||||
if keep:
|
||||
query = query.filter(security.UserSession.token != keep)
|
||||
query.delete(synchronize_session=False)
|
||||
db.commit()
|
||||
return {"ok": True}
|
||||
|
|
|
|||
|
|
@ -1,9 +1,10 @@
|
|||
from __future__ import annotations
|
||||
|
||||
from collections import defaultdict
|
||||
from datetime import date
|
||||
from typing import Iterable
|
||||
|
||||
from fastapi import APIRouter, Depends, HTTPException
|
||||
from fastapi import APIRouter, Depends, HTTPException, Query
|
||||
from pydantic import BaseModel
|
||||
from sqlalchemy import func
|
||||
from sqlalchemy.orm import Session
|
||||
|
|
@ -11,7 +12,7 @@ from sqlalchemy.orm import Session
|
|||
from .. import constants
|
||||
from ..constants import parse_period_label
|
||||
from ..db import get_db
|
||||
from ..models import Period, Update
|
||||
from ..models import Period, Project, Task, Update
|
||||
|
||||
router = APIRouter()
|
||||
|
||||
|
|
@ -21,6 +22,8 @@ class PeriodCreate(BaseModel):
|
|||
year: int | None = None
|
||||
month: int | None = None
|
||||
week: int | None = None
|
||||
start_date: str | None = None
|
||||
end_date: str | None = None
|
||||
|
||||
# 状态严重程度排序(越靠前越需要关注)
|
||||
_SEVERITY = ["blocked", "at_risk", "paused", "not_started", "in_progress", "done"]
|
||||
|
|
@ -155,6 +158,8 @@ def create_period(payload: PeriodCreate, db: Session = Depends(get_db)):
|
|||
year=year,
|
||||
month=month,
|
||||
week=week,
|
||||
start_date=payload.start_date,
|
||||
end_date=payload.end_date,
|
||||
sort_key=sort_key,
|
||||
)
|
||||
db.add(p)
|
||||
|
|
@ -165,7 +170,7 @@ def create_period(payload: PeriodCreate, db: Session = Depends(get_db)):
|
|||
|
||||
@router.delete("/periods/{pid}")
|
||||
def delete_period(pid: int, db: Session = Depends(get_db)):
|
||||
"""删除周期。仅允许删除没有任何执行记录(通用 / 定制)的空周期。"""
|
||||
"""删除周期。仅允许删除没有任何执行记录(通用 / 定开)的空周期。"""
|
||||
from ..models import CustomUpdate
|
||||
|
||||
p = db.get(Period, pid)
|
||||
|
|
@ -189,6 +194,9 @@ def meta(db: Session = Depends(get_db)):
|
|||
"statuses": [
|
||||
{"code": c, "name": n, "color": col} for c, n, col in constants.STATUSES
|
||||
],
|
||||
"priorities": [
|
||||
{"code": c, "name": n, "color": col} for c, n, col in constants.PRIORITIES
|
||||
],
|
||||
"ai": {
|
||||
"enabled": ai_enabled(db),
|
||||
"model": s.get("ai_model"),
|
||||
|
|
@ -196,3 +204,289 @@ def meta(db: Session = Depends(get_db)):
|
|||
"has_key": bool((s.get("ai_api_key") or "").strip()),
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 看板
|
||||
@router.get("/board")
|
||||
def board(
|
||||
period_id: int | None = None,
|
||||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
category_id: int | None = None,
|
||||
key_only: bool = False,
|
||||
keyword: str | None = None,
|
||||
idle: str = Query("key", pattern="^(none|key|all)$"),
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
period_ids = resolve_period_ids(db, period_id, year, month)
|
||||
if not period_ids:
|
||||
return {"period_ids": [], "periods": [], "rows": [], "stats": None}
|
||||
|
||||
periods = (
|
||||
db.query(Period).filter(Period.id.in_(period_ids)).order_by(Period.sort_key).all()
|
||||
)
|
||||
|
||||
q = db.query(Project).filter(Project.archived.is_(False))
|
||||
if category_id:
|
||||
q = q.filter(Project.category_id == category_id)
|
||||
if key_only:
|
||||
q = q.filter(Project.is_key.is_(True))
|
||||
if keyword:
|
||||
q = q.filter(Project.name.contains(keyword))
|
||||
projects = q.order_by(Project.is_key.desc(), Project.sort_order, Project.id).all()
|
||||
|
||||
ups = (
|
||||
db.query(Update)
|
||||
.filter(Update.period_id.in_(period_ids))
|
||||
.order_by(Update.id)
|
||||
.all()
|
||||
)
|
||||
by_project: dict[int, list[Update]] = defaultdict(list)
|
||||
for u in ups:
|
||||
by_project[u.project_id].append(u)
|
||||
|
||||
tasks = (
|
||||
db.query(Task)
|
||||
.filter(Task.project_id.in_([p.id for p in projects]))
|
||||
.order_by(Task.sort_order, Task.id)
|
||||
.all()
|
||||
)
|
||||
tasks_by_project: dict[int, list[Task]] = defaultdict(list)
|
||||
for t in tasks:
|
||||
tasks_by_project[t.project_id].append(t)
|
||||
|
||||
rows = []
|
||||
for p in projects:
|
||||
items = by_project.get(p.id, [])
|
||||
if not items:
|
||||
if idle == "none" or (idle == "key" and not p.is_key):
|
||||
continue
|
||||
|
||||
task_cards = []
|
||||
used_task_ids = set()
|
||||
for t in tasks_by_project.get(p.id, []):
|
||||
t_ups = [u for u in items if u.task_id == t.id]
|
||||
for u in t_ups:
|
||||
used_task_ids.add(u.id)
|
||||
task_cards.append(
|
||||
{
|
||||
"task": t.to_dict(),
|
||||
"updates": [u.to_dict() for u in t_ups],
|
||||
}
|
||||
)
|
||||
other_ups = [u for u in items if u.id not in used_task_ids]
|
||||
|
||||
progresses = [u.progress for u in items if u.progress is not None]
|
||||
if progresses:
|
||||
progress, progress_known = round(max(progresses), 1), True
|
||||
else:
|
||||
progress, progress_known = round(p.progress or 0, 1), bool(items)
|
||||
status = worst_status([u.status for u in items]) if items else p.status
|
||||
|
||||
rows.append(
|
||||
{
|
||||
"project": p.to_dict(),
|
||||
"progress": progress,
|
||||
"progress_known": progress_known,
|
||||
"status": status,
|
||||
"update_count": len(items),
|
||||
"summary": next((u.summary for u in items if u.summary), None)
|
||||
or (items[-1].content or "")[:80]
|
||||
if items
|
||||
else None,
|
||||
"has_update": bool(items),
|
||||
"risks": [u.risk for u in items if u.risk],
|
||||
"task_cards": task_cards,
|
||||
"other_updates": [u.to_dict() for u in other_ups],
|
||||
"updates": [u.to_dict() for u in items],
|
||||
}
|
||||
)
|
||||
|
||||
rows.sort(
|
||||
key=lambda r: (
|
||||
not r["project"]["is_key"],
|
||||
r["status"] != "blocked",
|
||||
r["status"] != "at_risk",
|
||||
not r["has_update"],
|
||||
-(r["progress"] or 0),
|
||||
)
|
||||
)
|
||||
|
||||
return {
|
||||
"period_ids": period_ids,
|
||||
"periods": [p.to_dict() for p in periods],
|
||||
"rows": rows,
|
||||
"stats": _quick_stats(db, period_ids, rows),
|
||||
}
|
||||
|
||||
|
||||
def _quick_stats(db: Session, period_ids: list[int], rows: list[dict]) -> dict:
|
||||
updates = db.query(Update).filter(Update.period_id.in_(period_ids)).all()
|
||||
by_status: dict[str, int] = defaultdict(int)
|
||||
for u in updates:
|
||||
by_status[u.status] += 1
|
||||
active = [r for r in rows if r["has_update"]]
|
||||
progresses = [r["progress"] for r in active if r["progress"]]
|
||||
return {
|
||||
"project_total": len(rows),
|
||||
"project_active": len(active),
|
||||
"project_idle": len(rows) - len(active),
|
||||
"key_total": sum(1 for r in rows if r["project"]["is_key"]),
|
||||
"key_updated": sum(1 for r in active if r["project"]["is_key"]),
|
||||
"update_count": len(updates),
|
||||
"avg_progress": round(sum(progresses) / len(progresses), 1) if progresses else 0,
|
||||
"status_counts": {k: by_status.get(k, 0) for k, _, _ in constants.STATUSES},
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 统计面板
|
||||
@router.get("/stats")
|
||||
def stats(
|
||||
period_id: int | None = None,
|
||||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
period_ids = resolve_period_ids(db, period_id, year, month)
|
||||
periods = (
|
||||
db.query(Period).filter(Period.id.in_(period_ids)).order_by(Period.sort_key).all()
|
||||
if period_ids
|
||||
else []
|
||||
)
|
||||
scope_label = (
|
||||
"、".join(p.label for p in periods[:3]) + ("…" if len(periods) > 3 else "")
|
||||
if periods
|
||||
else (f"{year}年{month}月" if year and month else "—")
|
||||
)
|
||||
|
||||
updates = (
|
||||
db.query(Update).filter(Update.period_id.in_(period_ids)).all() if period_ids else []
|
||||
)
|
||||
projects = db.query(Project).filter(Project.archived.is_(False)).all()
|
||||
|
||||
# 全量:每个周期的更新量 / 覆盖项目数 / 平均进度(趋势图)
|
||||
trend_rows = (
|
||||
db.query(
|
||||
Period.id,
|
||||
Period.label,
|
||||
Period.sort_key,
|
||||
Period.year,
|
||||
Period.month,
|
||||
Period.week,
|
||||
func.count(Update.id),
|
||||
)
|
||||
.outerjoin(Update, Update.period_id == Period.id)
|
||||
.group_by(Period.id)
|
||||
.order_by(Period.sort_key)
|
||||
.all()
|
||||
)
|
||||
trend = [
|
||||
{
|
||||
"period_id": r[0],
|
||||
"label": r[1],
|
||||
"sort_key": r[2],
|
||||
"year": r[3],
|
||||
"month": r[4],
|
||||
"week": r[5],
|
||||
"update_count": r[6],
|
||||
}
|
||||
for r in trend_rows
|
||||
]
|
||||
|
||||
# 分类分布
|
||||
cat_counter: dict[int, int] = defaultdict(int)
|
||||
for p in projects:
|
||||
cat_counter[p.category_id or 0] += 1
|
||||
cat_names = {}
|
||||
for p in projects:
|
||||
if p.category_id:
|
||||
cat_names[p.category_id] = (p.category.name, p.category.color)
|
||||
category_dist = []
|
||||
for cid, cnt in sorted(cat_counter.items(), key=lambda x: -x[1]):
|
||||
name, color = cat_names.get(cid, ("未分类", "#94a3b8"))
|
||||
category_dist.append({"id": cid, "name": name, "color": color, "count": cnt})
|
||||
|
||||
# 状态分布(本周期)
|
||||
status_dist = []
|
||||
for code, name, color in constants.STATUSES:
|
||||
status_dist.append(
|
||||
{
|
||||
"code": code,
|
||||
"name": name,
|
||||
"color": color,
|
||||
"count": sum(1 for u in updates if u.status == code),
|
||||
}
|
||||
)
|
||||
|
||||
# 风险清单
|
||||
risks = [
|
||||
u.to_dict(with_project=True)
|
||||
for u in updates
|
||||
if u.status in constants.NEGATIVE_STATUS or (u.risk or "").strip()
|
||||
]
|
||||
|
||||
# 重点工作未更新
|
||||
updated_ids = {u.project_id for u in updates}
|
||||
idle_key = [
|
||||
p.to_dict() for p in projects if p.is_key and p.id not in updated_ids
|
||||
]
|
||||
|
||||
# 进度排行
|
||||
prog_rows = []
|
||||
for p in projects:
|
||||
p_ups = [u for u in updates if u.project_id == p.id]
|
||||
prs = [u.progress for u in p_ups if u.progress is not None]
|
||||
prog = max(prs) if prs else p.progress
|
||||
prog_rows.append(
|
||||
{
|
||||
"id": p.id,
|
||||
"name": p.name,
|
||||
"progress": round(prog or 0, 1),
|
||||
"is_key": p.is_key,
|
||||
"status": worst_status([u.status for u in p_ups]) if p_ups else p.status,
|
||||
"color": (p.category.color if p.category else "#2563eb"),
|
||||
"estimated": not prs,
|
||||
}
|
||||
)
|
||||
prog_rows.sort(key=lambda x: (-x["progress"], x["name"]))
|
||||
top_progress = [r for r in prog_rows if r["id"] in updated_ids][:10] or prog_rows[:10]
|
||||
low_progress = [
|
||||
r
|
||||
for r in prog_rows
|
||||
if r["progress"] < 30 and r["status"] not in ("done",) and r["id"] in updated_ids
|
||||
][:8]
|
||||
|
||||
recent = (
|
||||
db.query(Update)
|
||||
.filter(Update.period_id.in_(period_ids))
|
||||
.order_by(Update.id.desc())
|
||||
.limit(10)
|
||||
.all()
|
||||
if period_ids
|
||||
else []
|
||||
)
|
||||
|
||||
covered_prog = [p["progress"] for p in prog_rows if p["id"] in updated_ids]
|
||||
return {
|
||||
"scope_label": scope_label,
|
||||
"period_ids": period_ids,
|
||||
"kpi": {
|
||||
"project_total": len(projects),
|
||||
"key_total": sum(1 for p in projects if p.is_key),
|
||||
"update_count": len(updates),
|
||||
"covered_projects": len(updated_ids),
|
||||
"risk_count": len(risks),
|
||||
# 平均进度只统计本周期有更新的项目,避免历史一次性事项拉低数值
|
||||
"avg_progress": round(sum(covered_prog) / len(covered_prog), 1)
|
||||
if covered_prog
|
||||
else 0,
|
||||
},
|
||||
"trend": trend[-14:],
|
||||
"category_dist": category_dist,
|
||||
"status_dist": status_dist,
|
||||
"risks": risks,
|
||||
"idle_key": idle_key,
|
||||
"top_progress": top_progress,
|
||||
"low_progress": low_progress,
|
||||
"recent_updates": [u.to_dict(with_project=True) for u in recent],
|
||||
}
|
||||
|
|
|
|||
|
|
@ -1,38 +1,31 @@
|
|||
"""定制项目 API(独立于通用项目体系)。
|
||||
"""定开项目 API(独立于通用项目体系)。
|
||||
|
||||
三条口径要记住:
|
||||
· **项目状态**(待开发/进行中/交付完成/已验收/退单)是界面上唯一可编辑的状态,
|
||||
商务阶段 `stage`(含收入确认比例)由它推导,不再单独维护;
|
||||
· 财务统计(下单 / 验收按年按季度)统一走 `app/finance.py`,本文件不自己算季度;
|
||||
· 周期记录里的 `amount_delta`(本期新增下单)与 `revenue_delta`(本期新增计收)
|
||||
都是增量:写入时累加进项目台账,改了就按差额回补,删了就扣回。
|
||||
关注:商务阶段流转 与 按进度确认收入。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
from datetime import date, datetime
|
||||
from collections import defaultdict
|
||||
from datetime import date, datetime, timedelta
|
||||
|
||||
from fastapi import APIRouter, Depends, HTTPException, Query
|
||||
from pydantic import BaseModel
|
||||
from sqlalchemy import func
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from .. import ai_parser, finance
|
||||
from .. import ai_parser
|
||||
from ..constants import (
|
||||
CUSTOM_INDUSTRIES,
|
||||
CUSTOM_ORIGINS,
|
||||
CUSTOM_ANNUAL_TARGETS_DEFAULT,
|
||||
CUSTOM_PIPELINE,
|
||||
CUSTOM_STAGE_STATUS,
|
||||
CUSTOM_STATUSES,
|
||||
CUSTOM_STEP_AGING_DAYS,
|
||||
CUSTOM_PLACED_ORIGINS,
|
||||
CUSTOM_RISKS,
|
||||
CUSTOM_STAGES,
|
||||
derive_stage,
|
||||
CUSTOM_STAGE_MAP,
|
||||
CUSTOM_STAGE_ORDER,
|
||||
CUSTOM_STEP_AGING_DAYS,
|
||||
custom_revenue_ratio,
|
||||
normalize_region,
|
||||
parse_quarter,
|
||||
)
|
||||
from ..db import get_db
|
||||
from ..models import CustomProject, CustomUpdate, ImportLog, Period, set_people
|
||||
from ..models import CustomProject, CustomUpdate, ImportLog, Period, Setting, set_people
|
||||
from .board import resolve_period_ids
|
||||
|
||||
router = APIRouter()
|
||||
|
|
@ -47,7 +40,7 @@ class CustomProjectIn(BaseModel):
|
|||
progress: float = 0
|
||||
manual_ratio: float | None = None
|
||||
revenue_amount: float | None = None
|
||||
owner: str | None = None # 交付负责人(定制项目为单人,多负责人只用于重点项目)
|
||||
owner: str | None = None # 交付负责人(定开项目为单人,多负责人只用于重点项目)
|
||||
members: list[str] | None = None # 团队成员
|
||||
entry_date: str | None = None
|
||||
sign_date: str | None = None
|
||||
|
|
@ -68,7 +61,7 @@ class CustomProjectIn(BaseModel):
|
|||
project_status: str | None = None
|
||||
accept_plan: str | None = None
|
||||
risk_level: str | None = None
|
||||
accept_year: int | None = None # 验收年度(accept_date 只有季度,跨年靠它区分)
|
||||
accept_date_real: str | None = None # 验收日期(真实日期,区别于 accept_date 季度文本)
|
||||
|
||||
|
||||
class CustomParseIn(BaseModel):
|
||||
|
|
@ -89,37 +82,24 @@ class CustomCommitIn(BaseModel):
|
|||
model: str | None = None
|
||||
|
||||
|
||||
def _sync_stage(cp: CustomProject, stage_hint: str | None = None) -> None:
|
||||
"""把项目状态翻译成商务阶段(唯一的写入口,别处不要再直接改 stage)。
|
||||
|
||||
只给了阶段、没给状态的入口(AI 录入 / 老接口)先反推出状态,保证台账上只有一个状态字段。
|
||||
"""
|
||||
status = (cp.project_status or "").strip()
|
||||
if not status and stage_hint:
|
||||
status = CUSTOM_STAGE_STATUS.get(stage_hint, "")
|
||||
cp.project_status = status or None
|
||||
if status and status not in CUSTOM_STATUSES:
|
||||
raise HTTPException(400, f"项目状态「{status}」不在取值范围内")
|
||||
cp.stage = derive_stage(status, cp.stage)
|
||||
def _ratio(cp: CustomProject) -> float:
|
||||
return custom_revenue_ratio(cp.stage, cp.progress, cp.manual_ratio)
|
||||
|
||||
|
||||
def _sync_accept(cp: CustomProject, payload: dict) -> None:
|
||||
"""验收时间 = 年度 + 季度 一对,要填就两个都填,清空就一起清空。
|
||||
# 环节日期字段 → 该环节对应的阶段
|
||||
_STEP_DATE_STAGE = {field: stage for _k, _n, field, stage, _c in CUSTOM_PIPELINE}
|
||||
|
||||
只留季度没年度正是「跨季度统计串年」的根源,所以宁可报错也不猜年份。
|
||||
"""
|
||||
if "accept_date" not in payload and "accept_year" not in payload:
|
||||
|
||||
def _advance_stage(cp: CustomProject, payload: dict):
|
||||
"""补录了某个环节的日期,就把商务阶段推进到那一环(只进不退,暂停/关闭不动)。"""
|
||||
if cp.stage in ("paused", "closed"):
|
||||
return
|
||||
quarter = parse_quarter(cp.accept_date)
|
||||
if not quarter:
|
||||
if cp.accept_year:
|
||||
raise HTTPException(400, "验收时间要填完整:选了年度就别留季度为空")
|
||||
cp.accept_date = None
|
||||
cp.accept_year = None
|
||||
return
|
||||
cp.accept_date = f"Q{quarter}"
|
||||
if not cp.accept_year:
|
||||
raise HTTPException(400, "验收时间要填完整:请先选验收年度")
|
||||
target = cp.stage
|
||||
for field, stage in _STEP_DATE_STAGE.items():
|
||||
if field in payload and str(payload.get(field) or "").strip():
|
||||
if CUSTOM_STAGE_ORDER.get(stage, 0) > CUSTOM_STAGE_ORDER.get(target, 0):
|
||||
target = stage
|
||||
cp.stage = target
|
||||
|
||||
|
||||
def _entry_key(cp: CustomProject) -> str:
|
||||
|
|
@ -129,6 +109,11 @@ def _entry_key(cp: CustomProject) -> str:
|
|||
return cp.created_at.strftime("%Y-%m-%d") if cp.created_at else ""
|
||||
|
||||
|
||||
def _sort_by_entry(projects):
|
||||
"""按入库时间倒序(新的在前),两者都取不到的排在最后。"""
|
||||
return sorted(projects, key=lambda c: (_entry_key(c), c.id), reverse=True)
|
||||
|
||||
|
||||
def _sort_by_update(projects):
|
||||
"""按「更新时间」倒序(最近变动的在前);无更新时间的回落到入库时间。"""
|
||||
def key(c):
|
||||
|
|
@ -137,24 +122,11 @@ def _sort_by_update(projects):
|
|||
return sorted(projects, key=key, reverse=True)
|
||||
|
||||
|
||||
def _num(v, label: str) -> float:
|
||||
"""把接口传来的数值安全转 float;脏值给 400 中文,不裸抛 float('abc') 变 500。"""
|
||||
try:
|
||||
return float(v)
|
||||
except (TypeError, ValueError):
|
||||
raise HTTPException(400, f"{label}必须是数字")
|
||||
|
||||
|
||||
def _add_delta(cp: CustomProject, field: str, delta) -> None:
|
||||
"""本期新增量累加进项目台账(下单金额 / 计收金额同一套口径)。"""
|
||||
if delta:
|
||||
setattr(cp, field, max(0.0, float(getattr(cp, field) or 0.0) + _num(delta, "金额")))
|
||||
|
||||
|
||||
def _rebase_delta(cp: CustomProject, field: str, prev, new) -> None:
|
||||
"""把「本期新增量」改成另一个值:主档按差额回补,保证台账始终等于各期之和。"""
|
||||
if prev or new:
|
||||
setattr(cp, field, max(0.0, float(getattr(cp, field) or 0.0) - float(prev or 0) + float(new or 0)))
|
||||
def _week_range(today: date | None = None) -> tuple[date, date]:
|
||||
"""当前自然周(周一~周日)。"""
|
||||
t = today or date.today()
|
||||
start = t - timedelta(days=t.weekday())
|
||||
return start, start + timedelta(days=6)
|
||||
|
||||
|
||||
def _unique_name(db: Session, name: str, exclude_id: int | None = None):
|
||||
|
|
@ -163,31 +135,70 @@ def _unique_name(db: Session, name: str, exclude_id: int | None = None):
|
|||
if exclude_id is not None:
|
||||
q = q.filter(CustomProject.id != exclude_id)
|
||||
if q.first():
|
||||
raise HTTPException(400, f"已存在同名定制项目「{name}」,请换个名称")
|
||||
raise HTTPException(400, f"已存在同名定开项目「{name}」,请换个名称")
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 元信息
|
||||
# ---------------------------------------------------------------- 年度计收目标
|
||||
# 目标值按「年」存在 settings 里(一年一套),读写口径都在 finance 里。
|
||||
# 目标值按「年 + 季度」存在 settings 里(一页一套),没配过就用《年度任务.xlsx》的默认值。
|
||||
ANNUAL_TARGETS_PREFIX = "custom_annual_targets"
|
||||
|
||||
|
||||
def _annual_targets_key(year: int) -> str:
|
||||
return f"{ANNUAL_TARGETS_PREFIX}:{year}"
|
||||
|
||||
|
||||
def read_annual_targets(db: Session, year: int) -> dict[str, float]:
|
||||
row = db.get(Setting, _annual_targets_key(year))
|
||||
targets = dict(CUSTOM_ANNUAL_TARGETS_DEFAULT)
|
||||
if row and row.value:
|
||||
try:
|
||||
saved = json.loads(row.value)
|
||||
except (TypeError, ValueError):
|
||||
saved = {}
|
||||
for q in (1, 2, 3, 4):
|
||||
v = saved.get(str(q))
|
||||
if v is not None and v != "":
|
||||
try:
|
||||
targets[q] = float(v)
|
||||
except (TypeError, ValueError):
|
||||
pass
|
||||
return {str(q): targets[q] for q in (1, 2, 3, 4)}
|
||||
|
||||
|
||||
class AnnualTargetsIn(BaseModel):
|
||||
year: int
|
||||
targets: dict # 值交给 finance 校验:非数字要报「Q几 目标值不是数字」,不是 422
|
||||
targets: dict[str, float | None]
|
||||
|
||||
|
||||
@router.get("/custom/annual-targets")
|
||||
def get_annual_targets(year: int | None = None, db: Session = Depends(get_db)):
|
||||
y = year or date.today().year
|
||||
return {"year": y, "targets": finance.read_annual_targets(db, y)}
|
||||
return {"year": y, "targets": read_annual_targets(db, y)}
|
||||
|
||||
|
||||
@router.put("/custom/annual-targets")
|
||||
def put_annual_targets(payload: AnnualTargetsIn, db: Session = Depends(get_db)):
|
||||
try:
|
||||
targets = finance.write_annual_targets(db, payload.year, payload.targets)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(400, str(exc))
|
||||
return {"year": payload.year, "targets": targets}
|
||||
y = payload.year
|
||||
targets = dict(CUSTOM_ANNUAL_TARGETS_DEFAULT)
|
||||
for q in (1, 2, 3, 4):
|
||||
v = payload.targets.get(str(q))
|
||||
if v is None or v == "":
|
||||
targets[q] = 0.0
|
||||
continue
|
||||
try:
|
||||
targets[q] = float(v)
|
||||
except (TypeError, ValueError):
|
||||
raise HTTPException(400, f"Q{q} 目标值不是数字")
|
||||
value = json.dumps({str(q): targets[q] for q in (1, 2, 3, 4)}, ensure_ascii=False)
|
||||
key = _annual_targets_key(y)
|
||||
row = db.get(Setting, key)
|
||||
if row:
|
||||
row.value = value
|
||||
else:
|
||||
db.add(Setting(key=key, value=value))
|
||||
db.commit()
|
||||
return {"year": y, "targets": {str(q): targets[q] for q in (1, 2, 3, 4)}}
|
||||
|
||||
|
||||
@router.get("/custom/meta")
|
||||
|
|
@ -218,13 +229,8 @@ def custom_meta(db: Session = Depends(get_db)):
|
|||
for k, n, f, st, col in CUSTOM_PIPELINE
|
||||
],
|
||||
"aging_days": CUSTOM_STEP_AGING_DAYS,
|
||||
# 下拉选项的唯一来源:前端不再各写一份,避免前后端取值不一致
|
||||
"statuses": CUSTOM_STATUSES,
|
||||
"origins": CUSTOM_ORIGINS,
|
||||
# 「已下单」的归属取值:财务口径与前端「已下单」筛选共用同一份
|
||||
"placed_origins": list(CUSTOM_PLACED_ORIGINS),
|
||||
"industries": CUSTOM_INDUSTRIES,
|
||||
"risks": CUSTOM_RISKS,
|
||||
# 年度计收目标(万元):默认取《年度任务.xlsx》,页面改过则以库里的值为准
|
||||
"annual_targets": {"year": date.today().year, "targets": read_annual_targets(db, date.today().year)},
|
||||
}
|
||||
|
||||
|
||||
|
|
@ -235,6 +241,7 @@ def list_custom_projects(
|
|||
region: str | None = None,
|
||||
keyword: str | None = None,
|
||||
archived: str = Query("false", pattern="^(true|false|all)$"),
|
||||
key_only: bool = False,
|
||||
owner: str | None = None,
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
|
|
@ -249,6 +256,8 @@ def list_custom_projects(
|
|||
q = q.filter(CustomProject.region == region)
|
||||
if keyword:
|
||||
q = q.filter(CustomProject.name.contains(keyword))
|
||||
if key_only:
|
||||
q = q.filter(CustomProject.is_key.is_(True))
|
||||
if owner:
|
||||
q = q.filter(CustomProject.owner == owner)
|
||||
|
||||
|
|
@ -272,8 +281,6 @@ def create_custom_project(payload: CustomProjectIn, db: Session = Depends(get_db
|
|||
_unique_name(db, name)
|
||||
cp = CustomProject(**data, source="manual")
|
||||
set_people(cp, None, payload.members)
|
||||
_sync_stage(cp, stage_hint=payload.stage)
|
||||
_sync_accept(cp, {"accept_date": cp.accept_date, "accept_year": cp.accept_year})
|
||||
db.add(cp)
|
||||
db.commit()
|
||||
db.refresh(cp)
|
||||
|
|
@ -284,7 +291,7 @@ def create_custom_project(payload: CustomProjectIn, db: Session = Depends(get_db
|
|||
def get_custom_project(cid: int, db: Session = Depends(get_db)):
|
||||
cp = db.get(CustomProject, cid)
|
||||
if not cp:
|
||||
raise HTTPException(404, "定制项目不存在")
|
||||
raise HTTPException(404, "定开项目不存在")
|
||||
ups = (
|
||||
db.query(CustomUpdate, Period)
|
||||
.join(Period, Period.id == CustomUpdate.period_id)
|
||||
|
|
@ -313,16 +320,15 @@ def get_custom_project(cid: int, db: Session = Depends(get_db)):
|
|||
def patch_custom_project(cid: int, payload: dict, db: Session = Depends(get_db)):
|
||||
cp = db.get(CustomProject, cid)
|
||||
if not cp:
|
||||
raise HTTPException(404, "定制项目不存在")
|
||||
# 商务阶段 stage 不在白名单里:它由 project_status 推导,接口层面改不了
|
||||
raise HTTPException(404, "定开项目不存在")
|
||||
allowed = (
|
||||
"name", "customer", "region", "amount", "progress", "manual_ratio",
|
||||
"name", "customer", "region", "amount", "stage", "progress", "manual_ratio",
|
||||
"revenue_amount", "invoice_amount", "received_amount", "owner",
|
||||
"entry_date", "sign_date", "deliver_date", "accept_date", "accept_year",
|
||||
"revenue_date", "remark", "is_key", "archived", "period_id",
|
||||
"entry_date", "sign_date", "deliver_date", "accept_date", "revenue_date",
|
||||
"remark", "is_key", "archived", "period_id",
|
||||
# 市场/销售侧台账字段
|
||||
"origin", "project_code", "office", "industry", "man_days",
|
||||
"market_owner", "project_status", "accept_plan", "risk_level",
|
||||
"market_owner", "project_status", "accept_plan", "risk_level", "accept_date_real",
|
||||
)
|
||||
payload = payload or {}
|
||||
if "name" in payload:
|
||||
|
|
@ -334,20 +340,6 @@ def patch_custom_project(cid: int, payload: dict, db: Session = Depends(get_db))
|
|||
payload["name"] = new_name
|
||||
if "region" in payload:
|
||||
payload["region"] = normalize_region(payload.get("region"))
|
||||
# 脏数值 / 脏布尔先转成模型能吃的形状,报 400 中文,别让 flush 阶段炸 500
|
||||
for k, lbl in (("amount", "订单金额"), ("progress", "进度"), ("manual_ratio", "人工占比"),
|
||||
("revenue_amount", "计收金额"), ("invoice_amount", "开票金额"), ("received_amount", "回款金额")):
|
||||
if payload.get(k) not in (None, ""):
|
||||
payload[k] = _num(payload[k], lbl)
|
||||
for k in ("is_key", "archived"):
|
||||
if k in payload and not isinstance(payload[k], bool):
|
||||
s = str(payload[k]).strip().lower()
|
||||
if s in ("true", "1", "yes", "是"):
|
||||
payload[k] = True
|
||||
elif s in ("false", "0", "no", "否", ""):
|
||||
payload[k] = False
|
||||
else:
|
||||
raise HTTPException(400, "是/否字段只认真假值")
|
||||
changed = False
|
||||
for k, v in payload.items():
|
||||
if k in allowed:
|
||||
|
|
@ -356,8 +348,7 @@ def patch_custom_project(cid: int, payload: dict, db: Session = Depends(get_db))
|
|||
setattr(cp, k, v)
|
||||
# 团队成员:名单型字段,整体替换(不传即不改);负责人只有单人,走上面的 owner
|
||||
set_people(cp, None, payload.get("members"))
|
||||
_sync_stage(cp)
|
||||
_sync_accept(cp, payload)
|
||||
_advance_stage(cp, payload)
|
||||
# 「更新时间」= 本次提交时间:台账字段有变化时刷新,便于按周查看最新改动
|
||||
if changed:
|
||||
cp.update_date = datetime.now().strftime("%Y-%m-%d %H:%M")
|
||||
|
|
@ -370,7 +361,7 @@ def patch_custom_project(cid: int, payload: dict, db: Session = Depends(get_db))
|
|||
def delete_custom_project(cid: int, db: Session = Depends(get_db)):
|
||||
cp = db.get(CustomProject, cid)
|
||||
if not cp:
|
||||
raise HTTPException(404, "定制项目不存在")
|
||||
raise HTTPException(404, "定开项目不存在")
|
||||
name = cp.name
|
||||
n_upd = len(cp.updates)
|
||||
db.delete(cp)
|
||||
|
|
@ -378,45 +369,250 @@ def delete_custom_project(cid: int, db: Session = Depends(get_db)):
|
|||
return {"ok": True, "name": name, "deleted_updates": n_upd}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 财务统计
|
||||
@router.get("/custom/finance")
|
||||
def custom_finance(
|
||||
# ---------------------------------------------------------------- 按周删除
|
||||
def _week_filtered(db: Session):
|
||||
"""本周(周一~周日)有「更新时间」的定开项目。"""
|
||||
start, end = _week_range()
|
||||
rows = (
|
||||
db.query(CustomProject)
|
||||
.filter(
|
||||
CustomProject.update_date.isnot(None),
|
||||
CustomProject.update_date >= start.isoformat(),
|
||||
CustomProject.update_date <= end.isoformat(),
|
||||
)
|
||||
.all()
|
||||
)
|
||||
return start, end, rows
|
||||
|
||||
|
||||
@router.get("/custom/weekly-preview")
|
||||
def weekly_preview(db: Session = Depends(get_db)):
|
||||
"""本周有更新的项目清单(供「删除本周更新」二次确认)。"""
|
||||
start, end, rows = _week_filtered(db)
|
||||
return {
|
||||
"start": start.isoformat(),
|
||||
"end": end.isoformat(),
|
||||
"count": len(rows),
|
||||
"amount": round(sum(r.amount or 0 for r in rows), 2),
|
||||
"names": [r.name for r in rows[:60]],
|
||||
}
|
||||
|
||||
|
||||
@router.post("/custom/purge-week")
|
||||
def purge_week(db: Session = Depends(get_db)):
|
||||
"""删除本周(周一~周日)更新的定开项目,连带其记录。破坏性操作,前端须二次确认。"""
|
||||
start, end, rows = _week_filtered(db)
|
||||
names = [r.name for r in rows]
|
||||
for r in rows:
|
||||
db.delete(r) # custom_updates 走 relationship cascade="all, delete-orphan"
|
||||
db.commit()
|
||||
return {
|
||||
"deleted": len(names),
|
||||
"start": start.isoformat(),
|
||||
"end": end.isoformat(),
|
||||
"names": names,
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 阶段看板
|
||||
@router.get("/custom/board")
|
||||
def custom_board(
|
||||
period_id: int | None = None,
|
||||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
region: str | None = None,
|
||||
keyword: str | None = None,
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
"""定开财务汇总:KPI + 年度任务表。
|
||||
period_ids = resolve_period_ids(db, period_id, year, month)
|
||||
periods = (
|
||||
db.query(Period).filter(Period.id.in_(period_ids)).order_by(Period.sort_key).all()
|
||||
if period_ids
|
||||
else []
|
||||
)
|
||||
|
||||
统计周期跟着顶栏走(period_id = 周,year+month = 月,都不传 = 今天),
|
||||
年份 / 季度由后端判定,前端只负责摆数字,切到历史周期也只看那一年。
|
||||
"""
|
||||
ctx = finance.period_context(db, period_id=period_id, year=year, month=month)
|
||||
return finance.summary(db, ctx)
|
||||
q = db.query(CustomProject).filter(CustomProject.archived.is_(False))
|
||||
if region:
|
||||
q = q.filter(CustomProject.region == region)
|
||||
if keyword:
|
||||
q = q.filter(CustomProject.name.contains(keyword))
|
||||
projects = _sort_by_entry(q.all())
|
||||
|
||||
# 本期有记录的项目
|
||||
ups = (
|
||||
db.query(CustomUpdate)
|
||||
.filter(CustomUpdate.period_id.in_(period_ids))
|
||||
.all()
|
||||
if period_ids
|
||||
else []
|
||||
)
|
||||
by_project: dict[int, list[CustomUpdate]] = defaultdict(list)
|
||||
for u in ups:
|
||||
by_project[u.custom_project_id].append(u)
|
||||
updated_ids = set(by_project.keys())
|
||||
|
||||
columns = []
|
||||
for code, name, color, _base in CUSTOM_STAGES:
|
||||
bucket = _sort_by_entry([c for c in projects if c.stage == code])
|
||||
columns.append(
|
||||
{
|
||||
"code": code,
|
||||
"name": name,
|
||||
"color": color,
|
||||
"count": len(bucket),
|
||||
"amount": round(sum(c.amount or 0 for c in bucket), 2),
|
||||
"projects": [c.to_dict() for c in bucket],
|
||||
"updated_count": sum(1 for c in bucket if c.id in updated_ids),
|
||||
}
|
||||
)
|
||||
|
||||
return {
|
||||
"period_ids": period_ids,
|
||||
"periods": [p.to_dict() for p in periods],
|
||||
"columns": columns,
|
||||
"updated_ids": sorted(updated_ids),
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 收入统计
|
||||
@router.get("/custom/stats")
|
||||
def custom_stats(
|
||||
period_id: int | None = None,
|
||||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
region: str | None = None,
|
||||
keyword: str | None = None,
|
||||
archived: str = Query("false", pattern="^(true|false|all)$"),
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
period_ids = resolve_period_ids(db, period_id, year, month)
|
||||
periods = (
|
||||
db.query(Period).filter(Period.id.in_(period_ids)).order_by(Period.sort_key).all()
|
||||
if period_ids
|
||||
else []
|
||||
)
|
||||
scope_label = (
|
||||
"、".join(p.label for p in periods[:3]) + ("…" if len(periods) > 3 else "")
|
||||
if periods
|
||||
else (f"{year}年{month}月" if year and month else "—")
|
||||
)
|
||||
|
||||
pq = db.query(CustomProject)
|
||||
if archived == "false":
|
||||
pq = pq.filter(CustomProject.archived.is_(False))
|
||||
elif archived == "true":
|
||||
pq = pq.filter(CustomProject.archived.is_(True))
|
||||
if region:
|
||||
pq = pq.filter(CustomProject.region == region)
|
||||
if keyword:
|
||||
pq = pq.filter(CustomProject.name.contains(keyword))
|
||||
projects = pq.all()
|
||||
|
||||
amount_total = sum(c.amount or 0 for c in projects)
|
||||
revenue_total = sum(c.revenue_amount or 0 for c in projects)
|
||||
confirmed_total = sum((c.amount or 0) * _ratio(c) for c in projects)
|
||||
invoice_total = sum(c.invoice_amount or 0 for c in projects)
|
||||
received_total = sum(c.received_amount or 0 for c in projects)
|
||||
|
||||
# 按阶段
|
||||
stage_agg: dict[str, dict] = {
|
||||
c: {"code": c, "name": n, "color": col, "count": 0, "amount": 0.0, "confirmed": 0.0}
|
||||
for c, n, col, _ in CUSTOM_STAGES
|
||||
}
|
||||
for c in projects:
|
||||
agg = stage_agg.setdefault(
|
||||
c.stage,
|
||||
{"code": c.stage, "name": c.stage, "color": "#94a3b8", "count": 0, "amount": 0.0, "confirmed": 0.0},
|
||||
)
|
||||
agg["count"] += 1
|
||||
agg["amount"] += c.amount or 0
|
||||
agg["confirmed"] += (c.amount or 0) * _ratio(c)
|
||||
|
||||
# 按区域
|
||||
region_agg: dict[str, dict] = defaultdict(lambda: {"count": 0, "amount": 0.0, "confirmed": 0.0, "revenue": 0.0})
|
||||
for c in projects:
|
||||
r = region_agg[c.region or "未标注"]
|
||||
r["count"] += 1
|
||||
r["amount"] += c.amount or 0
|
||||
r["confirmed"] += (c.amount or 0) * _ratio(c)
|
||||
r["revenue"] += c.revenue_amount or 0
|
||||
|
||||
by_region = [
|
||||
{"name": k, **{kk: round(vv, 2) for kk, vv in v.items() if kk != "count"}, "count": v["count"]}
|
||||
for k, v in sorted(region_agg.items(), key=lambda x: -x[1]["amount"])
|
||||
]
|
||||
|
||||
# 各周期:更新项目数 / 新增计收
|
||||
trend_rows = (
|
||||
db.query(
|
||||
Period.id, Period.label, Period.sort_key, Period.year, Period.month, Period.week,
|
||||
func.count(CustomUpdate.id),
|
||||
)
|
||||
.outerjoin(CustomUpdate, CustomUpdate.period_id == Period.id)
|
||||
.group_by(Period.id)
|
||||
.order_by(Period.sort_key)
|
||||
.all()
|
||||
)
|
||||
trend = [
|
||||
{
|
||||
"period_id": r[0], "label": r[1], "sort_key": r[2], "year": r[3],
|
||||
"month": r[4], "week": r[5], "update_count": r[6],
|
||||
}
|
||||
for r in trend_rows
|
||||
]
|
||||
|
||||
ups_in_scope = (
|
||||
db.query(CustomUpdate).filter(CustomUpdate.period_id.in_(period_ids)).all() if period_ids else []
|
||||
)
|
||||
period_revenue = sum(u.revenue_delta or 0 for u in ups_in_scope)
|
||||
period_amount = sum(u.amount_delta or 0 for u in ups_in_scope)
|
||||
|
||||
top = sorted(projects, key=lambda c: -(c.amount or 0))[:12]
|
||||
recently_stage_changed = sorted(
|
||||
[c for c in projects if c.period_id in period_ids],
|
||||
key=lambda c: CUSTOM_STAGE_ORDER.get(c.stage, 99),
|
||||
)[:10]
|
||||
|
||||
return {
|
||||
"scope_label": scope_label,
|
||||
"period_ids": period_ids,
|
||||
"kpi": {
|
||||
"project_count": len(projects),
|
||||
"key_count": sum(1 for c in projects if c.is_key),
|
||||
"amount_total": round(amount_total, 2),
|
||||
"revenue_total": round(revenue_total, 2),
|
||||
"confirmed_total": round(confirmed_total, 2),
|
||||
"pending_total": round(max(0.0, confirmed_total - revenue_total), 2),
|
||||
"progress_rate": round(confirmed_total / amount_total * 100, 1) if amount_total else 0,
|
||||
"revenue_rate": round(revenue_total / amount_total * 100, 1) if amount_total else 0,
|
||||
"invoice_total": round(invoice_total, 2),
|
||||
"received_total": round(received_total, 2),
|
||||
"pending_invoice": round(max(0.0, amount_total - invoice_total), 2),
|
||||
"pending_received": round(max(0.0, amount_total - received_total), 2),
|
||||
"received_rate": round(received_total / amount_total * 100, 1) if amount_total else 0,
|
||||
"period_revenue": round(period_revenue, 2),
|
||||
"period_amount": round(period_amount, 2),
|
||||
"period_updated": len({u.custom_project_id for u in ups_in_scope}),
|
||||
},
|
||||
"by_stage": [stage_agg[c] for c, _, _, _ in CUSTOM_STAGES if stage_agg[c]["count"]],
|
||||
"by_region": by_region,
|
||||
"trend": trend[-14:],
|
||||
"top_projects": [c.to_dict() for c in top],
|
||||
"recent_changes": [c.to_dict() for c in recently_stage_changed],
|
||||
"recent_updates": [u.to_dict() for u in sorted(ups_in_scope, key=lambda x: -x.id)[:10]],
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 执行记录
|
||||
@router.post("/custom/updates")
|
||||
def create_custom_update(payload: dict, db: Session = Depends(get_db)):
|
||||
payload = payload or {}
|
||||
cid, pid = payload.get("custom_project_id"), payload.get("period_id")
|
||||
cp = db.get(CustomProject, cid) if cid else None
|
||||
cp = db.get(CustomProject, payload.get("custom_project_id"))
|
||||
if not cp:
|
||||
raise HTTPException(404, "定制项目不存在")
|
||||
if not pid or not db.get(Period, pid):
|
||||
raise HTTPException(400, "请选择记录所属周期")
|
||||
# 先把项目状态 / 进度按本次记录更新,再取推导出的阶段存进记录,历史轨迹才对得上
|
||||
if not any((payload.get(k) or "").strip() for k in ("content", "summary", "raw_text")):
|
||||
raise HTTPException(400, "记录内容不能为空")
|
||||
if payload.get("project_status") is not None:
|
||||
cp.project_status = (payload["project_status"] or "").strip() or None
|
||||
if payload.get("progress") is not None:
|
||||
cp.progress = _num(payload["progress"], "进度")
|
||||
_sync_stage(cp, stage_hint=payload.get("stage"))
|
||||
raise HTTPException(404, "定开项目不存在")
|
||||
u = CustomUpdate(
|
||||
custom_project_id=payload["custom_project_id"],
|
||||
period_id=payload["period_id"],
|
||||
stage=cp.stage,
|
||||
stage=payload.get("stage") or cp.stage,
|
||||
content=payload.get("content"),
|
||||
summary=payload.get("summary"),
|
||||
progress=payload.get("progress"),
|
||||
|
|
@ -430,8 +626,12 @@ def create_custom_update(payload: dict, db: Session = Depends(get_db)):
|
|||
model=payload.get("model"),
|
||||
)
|
||||
db.add(u)
|
||||
_add_delta(cp, "amount", payload.get("amount_delta"))
|
||||
_add_delta(cp, "revenue_amount", payload.get("revenue_delta"))
|
||||
if payload.get("progress") is not None:
|
||||
cp.progress = float(payload["progress"])
|
||||
if payload.get("stage"):
|
||||
cp.stage = payload["stage"]
|
||||
if payload.get("revenue_delta"):
|
||||
cp.revenue_amount = (cp.revenue_amount or 0) + float(payload["revenue_delta"])
|
||||
cp.period_id = payload["period_id"]
|
||||
db.commit()
|
||||
db.refresh(u)
|
||||
|
|
@ -440,41 +640,33 @@ def create_custom_update(payload: dict, db: Session = Depends(get_db)):
|
|||
|
||||
@router.patch("/custom/updates/{uid}")
|
||||
def patch_custom_update(uid: int, payload: dict, db: Session = Depends(get_db)):
|
||||
"""修改单条定制周期记录。
|
||||
"""修改单条定开周期记录。
|
||||
|
||||
金额/计收是「本期新增量」,改了要按差额回补项目累计值;进度与项目状态覆盖项目档案
|
||||
(商务阶段跟着项目状态走,不单独改)。
|
||||
金额/计收是「本期新增量」,改了要按差额回补项目累计值;进度与阶段直接覆盖项目档案。
|
||||
"""
|
||||
u = db.get(CustomUpdate, uid)
|
||||
if not u:
|
||||
raise HTTPException(404, "记录不存在")
|
||||
cp = db.get(CustomProject, u.custom_project_id)
|
||||
prev_revenue, prev_amount = u.revenue_delta or 0.0, u.amount_delta or 0.0
|
||||
for k in ("content", "summary", "risk", "next_step", "owner"):
|
||||
prev_revenue = u.revenue_delta or 0.0
|
||||
for k in ("content", "summary", "risk", "next_step", "owner", "stage"):
|
||||
if k in payload:
|
||||
setattr(u, k, payload[k] or None)
|
||||
for k, lbl in (("progress", "进度"), ("amount_delta", "金额"), ("revenue_delta", "计收金额")):
|
||||
for k in ("progress", "amount_delta", "revenue_delta"):
|
||||
if k in payload:
|
||||
v = payload[k]
|
||||
setattr(u, k, None if v in (None, "") else _num(v, lbl))
|
||||
setattr(u, k, None if v in (None, "") else float(v))
|
||||
if "period_id" in payload:
|
||||
if not payload["period_id"]:
|
||||
raise HTTPException(400, "周期不能为空")
|
||||
if not db.get(Period, int(payload["period_id"])):
|
||||
raise HTTPException(404, "周期不存在,请重新选择周期")
|
||||
u.period_id = int(payload["period_id"])
|
||||
if payload.get("progress") is not None and cp:
|
||||
cp.progress = _num(payload["progress"], "进度")
|
||||
if cp and ("project_status" in payload or payload.get("stage")):
|
||||
if "project_status" in payload:
|
||||
cp.project_status = (payload["project_status"] or "").strip() or None
|
||||
_sync_stage(cp, stage_hint=payload.get("stage"))
|
||||
u.stage = cp.stage # 记录里的阶段与档案保持一致
|
||||
# 「本期新增」都是增量:改了就按差额回补主档,保持台账与各期记录对得上
|
||||
cp.progress = float(payload["progress"])
|
||||
if payload.get("stage") and cp:
|
||||
cp.stage = payload["stage"]
|
||||
# 「本期新增计收」是增量:改了就按差额回补项目累计计收,保持台账对得上
|
||||
if cp and "revenue_delta" in payload:
|
||||
_rebase_delta(cp, "revenue_amount", prev_revenue, u.revenue_delta)
|
||||
if cp and "amount_delta" in payload:
|
||||
_rebase_delta(cp, "amount", prev_amount, u.amount_delta)
|
||||
cp.revenue_amount = max(0.0, (cp.revenue_amount or 0.0) - prev_revenue + (u.revenue_delta or 0.0))
|
||||
db.commit()
|
||||
db.refresh(u)
|
||||
return u.to_dict()
|
||||
|
|
@ -485,11 +677,10 @@ def delete_custom_update(uid: int, db: Session = Depends(get_db)):
|
|||
u = db.get(CustomUpdate, uid)
|
||||
if not u:
|
||||
raise HTTPException(404, "记录不存在")
|
||||
# 「本期新增」是加进项目累计值的增量,删记录要一并扣回,否则台账对不上
|
||||
# 「本期新增计收」是加进项目累计值的增量,删记录要一并扣回,否则台账对不上
|
||||
cp = db.get(CustomProject, u.custom_project_id)
|
||||
if cp:
|
||||
_rebase_delta(cp, "revenue_amount", u.revenue_delta, 0)
|
||||
_rebase_delta(cp, "amount", u.amount_delta, 0)
|
||||
if cp and u.revenue_delta:
|
||||
cp.revenue_amount = max(0.0, (cp.revenue_amount or 0.0) - float(u.revenue_delta))
|
||||
db.delete(u)
|
||||
db.commit()
|
||||
return {"ok": True}
|
||||
|
|
@ -500,7 +691,7 @@ def delete_custom_update(uid: int, db: Session = Depends(get_db)):
|
|||
def custom_ai_parse(payload: CustomParseIn, db: Session = Depends(get_db)):
|
||||
cp = db.get(CustomProject, payload.custom_project_id) if payload.custom_project_id else None
|
||||
if payload.custom_project_id and not cp:
|
||||
raise HTTPException(404, "定制项目不存在")
|
||||
raise HTTPException(404, "定开项目不存在")
|
||||
period = db.get(Period, payload.period_id) if payload.period_id else None
|
||||
|
||||
parsed, mode, error = ai_parser.parse_custom(
|
||||
|
|
@ -573,20 +764,17 @@ def custom_ai_commit(payload: CustomCommitIn, db: Session = Depends(get_db)):
|
|||
db.add(u)
|
||||
created.append(u)
|
||||
|
||||
# 回写项目主档:AI 识别出的是阶段,落到台账上写的是项目状态
|
||||
_sync_stage(cp, stage_hint=p.get("stage"))
|
||||
# 回写项目主档
|
||||
if p.get("stage"):
|
||||
cp.stage = p["stage"]
|
||||
if p.get("progress") is not None:
|
||||
cp.progress = float(p["progress"])
|
||||
add_amount = sum(float(it.get("amount_delta") or 0) for it in items)
|
||||
add_revenue = sum(float(it.get("revenue_delta") or 0) for it in items)
|
||||
if p.get("amount") is not None:
|
||||
cp.amount = float(p["amount"])
|
||||
elif add_amount:
|
||||
cp.amount = max(0.0, float(cp.amount or 0.0) + add_amount)
|
||||
if p.get("revenue_amount") is not None:
|
||||
cp.revenue_amount = float(p["revenue_amount"])
|
||||
elif add_revenue:
|
||||
cp.revenue_amount = max(0.0, float(cp.revenue_amount or 0.0) + add_revenue)
|
||||
elif p.get("revenue_delta"):
|
||||
cp.revenue_amount = (cp.revenue_amount or 0) + float(p["revenue_delta"])
|
||||
if p.get("summary"):
|
||||
cp.remark = p["summary"]
|
||||
cp.period_id = period.id
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
"""数据导出(Excel / xlsx)。
|
||||
|
||||
提供六类导出,均可带上页面当前的筛选条件:
|
||||
- /export/custom 定制项目明细
|
||||
- /export/custom-updates 定制项目周期记录
|
||||
提供四类导出,均可带上页面当前的筛选条件:
|
||||
- /export/custom 定开项目明细
|
||||
- /export/custom-updates 定开项目周期记录
|
||||
- /export/projects 常规项目管理
|
||||
- /export/updates 常规项目周期执行记录
|
||||
- /export/staff 人力资源库(含项目负载)
|
||||
|
|
@ -14,21 +14,21 @@ from fastapi import APIRouter, Depends, Query
|
|||
from fastapi.responses import Response
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from .. import finance
|
||||
from ..constants import CUSTOM_STAGE_MAP, STATUS_MAP
|
||||
from ..db import get_db
|
||||
from ..export import build_xlsx, plain, xlsx_response
|
||||
from ..export import build_xlsx, xlsx_response
|
||||
from ..models import (
|
||||
CustomProject,
|
||||
CustomUpdate,
|
||||
Period,
|
||||
Project,
|
||||
Staff,
|
||||
Task,
|
||||
Update,
|
||||
WeeklyFocus,
|
||||
all_owners,
|
||||
)
|
||||
from .custom import _sort_by_update
|
||||
from .board import worst_status
|
||||
from .custom import _sort_by_entry, _sort_by_update
|
||||
|
||||
router = APIRouter()
|
||||
|
||||
|
|
@ -42,13 +42,12 @@ def _resp(content: bytes, filename: str) -> Response:
|
|||
return Response(content=body, headers=headers)
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 定制项目
|
||||
# ---------------------------------------------------------------- 定开项目
|
||||
@router.get("/export/custom")
|
||||
def export_custom(
|
||||
region: str | None = None,
|
||||
origin: str | None = None,
|
||||
status: str | None = None,
|
||||
risk: str | None = None,
|
||||
accept_plan: str | None = None,
|
||||
keyword: str | None = None,
|
||||
archived: str = Query("false", pattern="^(true|false|all)$"),
|
||||
|
|
@ -65,15 +64,13 @@ def export_custom(
|
|||
q = q.filter(CustomProject.origin == origin)
|
||||
if status:
|
||||
q = q.filter(CustomProject.project_status == status)
|
||||
if risk:
|
||||
q = q.filter(CustomProject.risk_level == risk)
|
||||
if accept_plan:
|
||||
q = q.filter(CustomProject.accept_plan == accept_plan)
|
||||
if keyword:
|
||||
q = q.filter(CustomProject.name.contains(keyword))
|
||||
projects = _sort_by_update(q.all())
|
||||
|
||||
# 列与「定制项目明细」表格一致
|
||||
# 列与「定开项目明细」表格一致
|
||||
headers = [
|
||||
"项目归属", "项目名称", "项目ID", "下单时间", "办事处", "行业",
|
||||
"市场下单人天", "订单金额(元)", "市场责任人", "项目状态",
|
||||
|
|
@ -93,7 +90,7 @@ def export_custom(
|
|||
c.amount if c.amount is not None else "",
|
||||
c.market_owner or "",
|
||||
c.project_status or "",
|
||||
finance.accept_label(c),
|
||||
c.accept_date or "",
|
||||
c.accept_plan or "",
|
||||
c.risk_level or "",
|
||||
(c.remark or "").replace("\n", " "),
|
||||
|
|
@ -113,14 +110,14 @@ def export_custom(
|
|||
)
|
||||
|
||||
content = build_xlsx(
|
||||
"定制项目明细",
|
||||
"定开项目明细",
|
||||
headers,
|
||||
rows,
|
||||
widths=[10, 46, 18, 12, 10, 8, 13, 14, 14, 11, 11, 14, 10, 40, 18],
|
||||
title="定制项目明细",
|
||||
title="定开项目明细",
|
||||
money_cols=(8,), # 订单金额(元)
|
||||
)
|
||||
return _resp(content, "定制项目明细")
|
||||
return _resp(content, "定开项目明细")
|
||||
|
||||
|
||||
@router.get("/export/custom-updates")
|
||||
|
|
@ -128,7 +125,6 @@ def export_custom_updates(
|
|||
period_id: int | None = None,
|
||||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
keyword: str | None = None,
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
from .board import resolve_period_ids
|
||||
|
|
@ -138,11 +134,6 @@ def export_custom_updates(
|
|||
if period_ids:
|
||||
q = q.filter(CustomUpdate.period_id.in_(period_ids))
|
||||
ups = q.order_by(CustomUpdate.period_id, CustomUpdate.custom_project_id).all()
|
||||
if keyword:
|
||||
kw = keyword.strip()
|
||||
ups = [u for u in ups if kw in plain(u.content or "") or kw in plain(u.summary or "")
|
||||
or kw in (u.project.name if u.project else "")
|
||||
or kw in (u.project.customer if u.project else "")]
|
||||
|
||||
headers = [
|
||||
"周期", "项目名称", "区域", "阶段", "执行情况", "进度(%)",
|
||||
|
|
@ -157,7 +148,7 @@ def export_custom_updates(
|
|||
cp.name if cp else "",
|
||||
(cp.region or "") if cp else "",
|
||||
_stage_name(u.stage),
|
||||
plain(u.content or "").replace("\n", " ")[:500],
|
||||
(u.content or "").replace("\n", " ")[:500],
|
||||
u.progress,
|
||||
u.amount_delta,
|
||||
u.revenue_delta,
|
||||
|
|
@ -167,14 +158,14 @@ def export_custom_updates(
|
|||
)
|
||||
|
||||
content = build_xlsx(
|
||||
"定制项目记录",
|
||||
"定开项目记录",
|
||||
headers,
|
||||
rows,
|
||||
widths=[18, 42, 10, 14, 70, 10, 16, 16, 30, 30],
|
||||
title="定制项目周期记录",
|
||||
title="定开项目周期记录",
|
||||
money_cols=(7, 8),
|
||||
)
|
||||
return _resp(content, "定制项目周期记录")
|
||||
return _resp(content, "定开项目周期记录")
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 常规项目
|
||||
|
|
@ -182,13 +173,7 @@ def export_custom_updates(
|
|||
def export_projects(
|
||||
category_id: int | None = None,
|
||||
keyword: str | None = None,
|
||||
owner: str | None = None,
|
||||
idle_only: bool = False,
|
||||
period_id: int | None = None,
|
||||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
# 与其余导出统一:不传时默认只导在用项目
|
||||
archived: str = Query("false", pattern="^(true|false|all)$"),
|
||||
archived: str = Query("all", pattern="^(true|false|all)$"),
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
q = db.query(Project)
|
||||
|
|
@ -201,32 +186,27 @@ def export_projects(
|
|||
if keyword:
|
||||
q = q.filter(Project.name.contains(keyword))
|
||||
projects = q.order_by(Project.is_key.desc(), Project.name).all()
|
||||
if owner:
|
||||
projects = [p for p in projects if owner in all_owners(p.owner, p.other_owners)]
|
||||
if idle_only:
|
||||
# 「只看未更新」与页面同口径:指定周期内没有执行记录的项目(周期缺省 = 不过滤,宁全勿漏)
|
||||
from .board import resolve_period_ids
|
||||
scope = resolve_period_ids(db, period_id, year, month)
|
||||
if scope:
|
||||
busy = {r[0] for r in db.query(Update.project_id).filter(Update.period_id.in_(scope)).distinct()}
|
||||
projects = [p for p in projects if p.id not in busy]
|
||||
|
||||
periods = {p.id: p for p in db.query(Period).all()}
|
||||
headers = [
|
||||
"项目名称", "分类", "负责人", "状态", "重点",
|
||||
"项目名称", "分类", "负责人", "状态", "优先级", "重点",
|
||||
"进度(%)", "标签", "子任务数", "执行记录数", "最近更新周期", "归档",
|
||||
]
|
||||
status_names = {
|
||||
"not_started": "未开始", "in_progress": "进行中", "done": "已完成",
|
||||
"at_risk": "风险", "blocked": "阻塞", "paused": "暂停/终止",
|
||||
}
|
||||
rows = []
|
||||
for p in projects:
|
||||
# 最近周期按 sort_key 而不是自增 id:补录的历史周 id 大但时间早(与 weekly/board 同口径)
|
||||
ups = sorted(p.updates, key=lambda u: periods[u.period_id].sort_key if u.period_id in periods else -1, reverse=True)
|
||||
ups = sorted(p.updates, key=lambda u: u.period_id or 0, reverse=True)
|
||||
last = periods.get(ups[0].period_id) if ups else None
|
||||
rows.append(
|
||||
[
|
||||
p.name,
|
||||
p.category.name if p.category else "未分类",
|
||||
p.owner or "",
|
||||
STATUS_MAP.get(p.status, (p.status,))[0],
|
||||
status_names.get(p.status, p.status),
|
||||
(p.priority or "").upper(),
|
||||
"是" if p.is_key else "",
|
||||
round(p.progress or 0, 1),
|
||||
"、".join(t.name for t in p.tags),
|
||||
|
|
@ -241,7 +221,7 @@ def export_projects(
|
|||
"项目管理",
|
||||
headers,
|
||||
rows,
|
||||
widths=[46, 12, 12, 10, 7, 10, 24, 11, 12, 18, 7],
|
||||
widths=[46, 12, 12, 10, 9, 7, 10, 24, 11, 12, 18, 7],
|
||||
title="项目管理清单",
|
||||
)
|
||||
return _resp(content, "项目管理清单")
|
||||
|
|
@ -253,7 +233,6 @@ def export_updates(
|
|||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
project_id: int | None = None,
|
||||
keyword: str | None = None,
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
from .board import resolve_period_ids
|
||||
|
|
@ -265,11 +244,11 @@ def export_updates(
|
|||
if project_id:
|
||||
q = q.filter(Update.project_id == project_id)
|
||||
ups = q.order_by(Update.period_id, Update.project_id, Update.id).all()
|
||||
if keyword:
|
||||
# 看板工具栏的搜索框会带着它来导出:内容 / 摘要 / 子任务 / 项目名任一命中
|
||||
kw = keyword.strip()
|
||||
ups = [u for u in ups if kw in plain(u.content or "") or kw in plain(u.summary or "")
|
||||
or kw in (u.task.name if u.task else "") or kw in (u.project.name if u.project else "")]
|
||||
|
||||
status_names = {
|
||||
"not_started": "未开始", "in_progress": "进行中", "done": "已完成",
|
||||
"at_risk": "风险", "blocked": "阻塞", "paused": "暂停/终止",
|
||||
}
|
||||
headers = [
|
||||
"周期", "项目", "子任务", "执行情况", "进度(%)", "状态", "风险", "下一步", "来源",
|
||||
]
|
||||
|
|
@ -280,9 +259,9 @@ def export_updates(
|
|||
u.period.to_dict()["full_label"] if u.period else "",
|
||||
u.project.name if u.project else "",
|
||||
u.task.name if u.task else "",
|
||||
plain(u.content or "").replace("\n", " ")[:500],
|
||||
(u.content or "").replace("\n", " ")[:500],
|
||||
u.progress,
|
||||
STATUS_MAP.get(u.status, (u.status,))[0],
|
||||
status_names.get(u.status, u.status),
|
||||
(u.risk or "").replace("\n", " ")[:200],
|
||||
(u.next_step or "").replace("\n", " ")[:200],
|
||||
{"import": "导入", "ai": "AI整理", "manual": "手工"}.get(u.source, u.source),
|
||||
|
|
@ -303,8 +282,6 @@ def export_updates(
|
|||
@router.get("/export/staff")
|
||||
def export_staff(
|
||||
archived: str = Query("false", pattern="^(true|false|all)$"),
|
||||
group: str | None = None,
|
||||
keyword: str | None = None,
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
from .staff import _workload
|
||||
|
|
@ -314,16 +291,12 @@ def export_staff(
|
|||
q = q.filter(Staff.archived.is_(False))
|
||||
elif archived == "true":
|
||||
q = q.filter(Staff.archived.is_(True))
|
||||
if group:
|
||||
q = q.filter(Staff.group == group)
|
||||
members = q.order_by(Staff.sort_order, Staff.id).all()
|
||||
if keyword:
|
||||
members = [m for m in members if keyword.strip() in (m.name or "")]
|
||||
load = _workload(db)
|
||||
|
||||
headers = [
|
||||
"序号", "姓名", "归属小组", "人员归属", "在管项目", "重点项目",
|
||||
"定制项目", "定制合同额(元)", "定制待计收(元)", "最近更新", "说明", "归档",
|
||||
"定开项目", "定开合同额(元)", "定开待计收(元)", "最近更新", "说明", "归档",
|
||||
]
|
||||
rows = []
|
||||
for i, m in enumerate(members, 1):
|
||||
|
|
@ -371,15 +344,13 @@ def export_focus(
|
|||
q = q.filter(WeeklyFocus.archived.is_(True))
|
||||
if status:
|
||||
q = q.filter(WeeklyFocus.status == status)
|
||||
if keyword:
|
||||
q = q.filter(WeeklyFocus.content.contains(keyword) | WeeklyFocus.detail.contains(keyword))
|
||||
periods = {p.id: p for p in db.query(Period).all()}
|
||||
items = sorted(
|
||||
q.all(),
|
||||
key=lambda f: (-(periods[f.period_id].sort_key if f.period_id in periods else 0), -f.id),
|
||||
)
|
||||
if keyword:
|
||||
# 说明可能存的是富文本 HTML,子串匹配要在纯文本上做(重点工作量小,排序后再筛即可)
|
||||
kw = keyword.strip()
|
||||
items = [f for f in items if kw in (f.content or "") or kw in plain(f.detail or "")]
|
||||
|
||||
headers = ["序号", "工作内容", "说明", "预计完成时间", "录入周", "执行状态", "是否延期", "结果反馈", "更新"]
|
||||
rows = []
|
||||
|
|
@ -389,12 +360,12 @@ def export_focus(
|
|||
[
|
||||
i,
|
||||
f.content,
|
||||
plain(f.detail or "").replace("\n", " "), # 说明支持简单富文本,出表降级成纯文本
|
||||
(f.detail or "").replace("\n", " "),
|
||||
f.due_date or "",
|
||||
period.to_dict()["full_label"] if period else "",
|
||||
STATUS_MAP.get(f.status, (f.status,))[0],
|
||||
"是" if f.delayed else "",
|
||||
plain(f.result or "").replace("\n", " "),
|
||||
(f.result or "").replace("\n", " "),
|
||||
f.updated_at.strftime("%Y-%m-%d %H:%M") if f.updated_at else "",
|
||||
]
|
||||
)
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
和项目管理(Project + Update)分开:不用先建项目档案,一条就是一个活儿。
|
||||
字段按需求——工作内容 / 说明 / 预计完成时间(日历日期)/ 执行状态 / 结果反馈 / 是否延期。
|
||||
period_id 是「录入周」——新建时顶栏选中的那一周,和项目管理/定制项目的周期归属同一个意思;
|
||||
period_id 是「录入周」——新建时顶栏选中的那一周,和项目管理/定开项目的周期归属同一个意思;
|
||||
预计完成时间只存 due_date,不再按日期反查周期。本周录一条两周后要干的事,本周照样看得见。
|
||||
「是否延期」是人工开关(delayed):更早周次录入、标了延期又没做完的,结转进当周视图。
|
||||
录入整理在「每周重点工作」页,汇总在「工作看板」。
|
||||
|
|
@ -146,4 +146,4 @@ def delete_focus(fid: int, db: Session = Depends(get_db)):
|
|||
content = item.content
|
||||
db.delete(item)
|
||||
db.commit()
|
||||
return {"ok": True, "id": fid, "content": content} # 与其它删除接口保持一致
|
||||
return {"id": fid, "content": content}
|
||||
|
|
|
|||
|
|
@ -18,14 +18,13 @@ from ..models import (
|
|||
people_like,
|
||||
set_people,
|
||||
)
|
||||
from .. import constants
|
||||
from ..schemas import (
|
||||
CategoryIn,
|
||||
ProjectIn,
|
||||
ProjectPatch,
|
||||
TagIn,
|
||||
UpdateIn,
|
||||
UpdatePatch,
|
||||
CategoryPatch,
|
||||
)
|
||||
from .board import resolve_period_ids, worst_status
|
||||
|
||||
|
|
@ -97,7 +96,7 @@ def list_projects(
|
|||
if owner:
|
||||
# 负责人筛选连其他负责人一起命中(主负责人在 owner 列,其余在 other_owners 列)
|
||||
q = q.filter(or_(Project.owner == owner, Project.other_owners.like(people_like(owner))))
|
||||
projects = q.order_by(Project.is_key.desc(), Project.id).all()
|
||||
projects = q.order_by(Project.is_key.desc(), Project.sort_order, Project.id).all()
|
||||
|
||||
# 最近一次更新
|
||||
ups = (
|
||||
|
|
@ -265,18 +264,12 @@ def create_category(payload: CategoryIn, db: Session = Depends(get_db)):
|
|||
|
||||
|
||||
@router.patch("/categories/{cid}")
|
||||
def patch_category(cid: int, payload: CategoryPatch, db: Session = Depends(get_db)):
|
||||
def patch_category(cid: int, payload: CategoryIn, db: Session = Depends(get_db)):
|
||||
c = db.get(Category, cid)
|
||||
if not c:
|
||||
raise HTTPException(404, "分类不存在")
|
||||
data = payload.model_dump(exclude_unset=True)
|
||||
if "name" in data:
|
||||
name = (data["name"] or "").strip()
|
||||
if not name:
|
||||
raise HTTPException(400, "分类名称不能为空")
|
||||
c.name = name
|
||||
if data.get("color"):
|
||||
c.color = data["color"]
|
||||
c.name = payload.name
|
||||
c.color = payload.color
|
||||
db.commit()
|
||||
return c.to_dict()
|
||||
|
||||
|
|
@ -292,25 +285,46 @@ def delete_category(cid: int, db: Session = Depends(get_db)):
|
|||
return {"ok": True}
|
||||
|
||||
|
||||
@router.get("/tags")
|
||||
def list_tags(db: Session = Depends(get_db)):
|
||||
return [t.to_dict() for t in db.query(Tag).order_by(Tag.id).all()]
|
||||
|
||||
|
||||
@router.post("/tags")
|
||||
def create_tag(payload: TagIn, db: Session = Depends(get_db)):
|
||||
t = db.query(Tag).filter(Tag.name == payload.name).one_or_none()
|
||||
if t:
|
||||
return t.to_dict()
|
||||
t = Tag(name=payload.name, color=payload.color)
|
||||
db.add(t)
|
||||
db.commit()
|
||||
db.refresh(t)
|
||||
return t.to_dict()
|
||||
|
||||
|
||||
@router.delete("/tags/{tid}")
|
||||
def delete_tag(tid: int, db: Session = Depends(get_db)):
|
||||
t = db.get(Tag, tid)
|
||||
if not t:
|
||||
raise HTTPException(404, "标记不存在")
|
||||
db.delete(t)
|
||||
db.commit()
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 执行记录
|
||||
@router.get("/updates")
|
||||
def list_updates(
|
||||
project_id: int | None = None,
|
||||
period_id: int | None = None,
|
||||
year: int | None = None,
|
||||
month: int | None = None,
|
||||
limit: int = Query(50, le=500),
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
"""执行记录。周期口径与项目清单一致:period_id 或 year+month(月粒度含该月各周)。"""
|
||||
q = db.query(Update)
|
||||
if project_id:
|
||||
q = q.filter(Update.project_id == project_id)
|
||||
if period_id or (year and month):
|
||||
ids = resolve_period_ids(db, period_id, year, month)
|
||||
if not ids: # 该周期/该月还没有任何周
|
||||
return []
|
||||
q = q.filter(Update.period_id.in_(ids))
|
||||
if period_id:
|
||||
q = q.filter(Update.period_id == period_id)
|
||||
rows = q.order_by(Update.id.desc()).limit(limit).all()
|
||||
return [u.to_dict(with_project=True) for u in rows]
|
||||
|
||||
|
|
@ -330,13 +344,9 @@ def create_update(payload: UpdateIn, db: Session = Depends(get_db)):
|
|||
db.add(t)
|
||||
db.flush()
|
||||
data["task_id"] = t.id
|
||||
p = _require_project(db, payload.project_id)
|
||||
_require_period(db, payload.period_id)
|
||||
_check_status(payload.status)
|
||||
if not (payload.content or "").strip() and not (payload.summary or "").strip():
|
||||
raise HTTPException(400, "请填写执行情况内容")
|
||||
u = Update(**data)
|
||||
db.add(u)
|
||||
p = db.get(Project, payload.project_id)
|
||||
if p and data.get("progress") is not None:
|
||||
p.progress = float(data["progress"])
|
||||
db.commit()
|
||||
|
|
@ -344,25 +354,6 @@ def create_update(payload: UpdateIn, db: Session = Depends(get_db)):
|
|||
return u.to_dict()
|
||||
|
||||
|
||||
def _require_project(db: Session, pid: int) -> Project:
|
||||
p = db.get(Project, pid)
|
||||
if not p:
|
||||
raise HTTPException(404, "项目不存在")
|
||||
return p
|
||||
|
||||
|
||||
def _require_period(db: Session, period_id: int) -> Period:
|
||||
p = db.get(Period, period_id)
|
||||
if not p:
|
||||
raise HTTPException(404, "周期不存在,请重新选择周期")
|
||||
return p
|
||||
|
||||
|
||||
def _check_status(status: str | None):
|
||||
if status and status not in constants.STATUS_CODES:
|
||||
raise HTTPException(400, "状态不认识:" + status)
|
||||
|
||||
|
||||
@router.patch("/updates/{uid}")
|
||||
def patch_update(uid: int, payload: UpdatePatch, db: Session = Depends(get_db)):
|
||||
"""修改单条执行记录;改了进度就同步项目档案,与新建时的口径一致。"""
|
||||
|
|
@ -382,11 +373,8 @@ def patch_update(uid: int, payload: UpdatePatch, db: Session = Depends(get_db)):
|
|||
db.add(t)
|
||||
db.flush()
|
||||
data["task_id"] = t.id
|
||||
if "period_id" in data:
|
||||
if not data["period_id"]:
|
||||
raise HTTPException(400, "周期不能为空")
|
||||
_require_period(db, data["period_id"])
|
||||
_check_status(data.get("status"))
|
||||
if "period_id" in data and not data["period_id"]:
|
||||
raise HTTPException(400, "周期不能为空")
|
||||
for k, v in data.items():
|
||||
setattr(u, k, v)
|
||||
if data.get("progress") is not None:
|
||||
|
|
@ -408,6 +396,15 @@ def delete_update(uid: int, db: Session = Depends(get_db)):
|
|||
return {"ok": True}
|
||||
|
||||
|
||||
@router.post("/tasks")
|
||||
def create_task(payload: dict, db: Session = Depends(get_db)):
|
||||
t = Task(project_id=payload["project_id"], name=payload["name"])
|
||||
db.add(t)
|
||||
db.commit()
|
||||
db.refresh(t)
|
||||
return t.to_dict()
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 设置
|
||||
@router.get("/settings")
|
||||
def get_settings(db: Session = Depends(get_db)):
|
||||
|
|
|
|||
|
|
@ -1,139 +1,57 @@
|
|||
"""权限管理:角色(菜单授权矩阵)、用户(挂角色 / 启停 / 重置密码)、在线会话、操作日志。
|
||||
"""权限管理:角色(菜单权限矩阵)与用户(分配角色 / 启停 / 重置密码)。
|
||||
|
||||
进入这一页需要「权限管理」授权,写操作还要 rw,由 security.guard 拦。
|
||||
两条自我保护规则:
|
||||
· 内置「管理员」角色永远保留权限管理授权,也删不掉;
|
||||
· 不让最后一个可管理权限的账号被停用 / 删除 / 降权。
|
||||
只有拿到「权限管理」菜单授权的用户能进(写操作还要 rw),由 security.guard 拦。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
from fastapi import APIRouter, Depends, HTTPException, Query, Request
|
||||
from fastapi import APIRouter, Depends, HTTPException
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from .. import audit, security
|
||||
from ..constants import MENU_KEYS, MENU_LABELS, LEVEL_LABELS, merge_levels
|
||||
from .. import security
|
||||
from ..db import get_db
|
||||
from ..models import AuditLog, Role, RoleMenu, User, UserRole, UserSession
|
||||
from ..models import Role, User
|
||||
from ..schemas import RoleIn, RolePatch, UserIn, UserPatch
|
||||
|
||||
router = APIRouter()
|
||||
|
||||
ADMIN_ROLE = "管理员"
|
||||
|
||||
|
||||
def _role_menus(db: Session, role_id: int) -> dict[str, str]:
|
||||
return {g.menu: g.level for g in db.query(RoleMenu).filter(RoleMenu.role_id == role_id).all()}
|
||||
|
||||
|
||||
def _set_role_menus(db: Session, role: Role, menus: dict) -> None:
|
||||
"""整体替换角色的菜单授权(矩阵里改一格也是整行覆盖)。"""
|
||||
clean = security.normalize_menus(menus)
|
||||
if role.is_builtin and role.name == ADMIN_ROLE:
|
||||
clean["rbac"] = "rw" # 管理员不能被自己关在门外
|
||||
# 逐条 ORM 删除后再插:批量 delete() 会把旧对象留在 identity map 里,
|
||||
# 主键相同时 SQLAlchemy 会告警,甚至让随后的读取拿到改之前的旧级别
|
||||
for row in db.query(RoleMenu).filter(RoleMenu.role_id == role.id).all():
|
||||
db.delete(row)
|
||||
db.flush()
|
||||
for menu, level in clean.items():
|
||||
db.add(RoleMenu(role_id=role.id, menu=menu, level=level))
|
||||
db.commit()
|
||||
|
||||
|
||||
def _set_user_roles(db: Session, user: User, role_ids: list[int]) -> None:
|
||||
ids = sorted({int(r) for r in role_ids if r})
|
||||
for rid in ids:
|
||||
if db.get(Role, rid) is None:
|
||||
raise HTTPException(status_code=400, detail="角色不存在")
|
||||
# 同 _set_role_menus:先 ORM 删除再插入,避免主键冲突的旧对象残留在 identity map
|
||||
for row in db.query(UserRole).filter(UserRole.user_id == user.id).all():
|
||||
db.delete(row)
|
||||
db.flush()
|
||||
for rid in ids:
|
||||
db.add(UserRole(user_id=user.id, role_id=rid))
|
||||
db.commit()
|
||||
|
||||
|
||||
def _menus_of_role_ids(db: Session, role_ids) -> dict[str, str]:
|
||||
"""预判:这几个角色挂上去之后用户会拿到什么权限(用于改角色前的自我保护判断)。"""
|
||||
maps = []
|
||||
for rid in {int(r) for r in role_ids if r}:
|
||||
role = db.get(Role, rid)
|
||||
if role is not None:
|
||||
maps.append(_role_menus(db, role.id))
|
||||
return merge_levels(*maps)
|
||||
|
||||
|
||||
def _rbac_managers(db: Session, exclude_id: int | None = None) -> int:
|
||||
"""还有几个可用账号拥有「权限管理 · 可编辑」。"""
|
||||
n = 0
|
||||
for u in db.query(User).filter(User.active.is_(True)).all():
|
||||
if exclude_id is not None and u.id == exclude_id:
|
||||
continue
|
||||
if u.menus.get("rbac") == "rw":
|
||||
n += 1
|
||||
return n
|
||||
|
||||
|
||||
def _effective_role_ids(user: User, role_ids) -> list[int]:
|
||||
"""没传角色 = 保持原样;传了 = 整体替换。"""
|
||||
return [int(r) for r in role_ids] if role_ids is not None else [r.id for r in user.roles]
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------- 元信息
|
||||
@router.get("/rbac/meta")
|
||||
def meta():
|
||||
return {
|
||||
"menus": [{"key": k, "label": v} for k, v in
|
||||
[(k, MENU_LABELS[k]) for k in MENU_KEYS]],
|
||||
"levels": [{"value": v, "label": LEVEL_LABELS[v]} for v in ("rw", "ro", "")],
|
||||
"actions": [
|
||||
{"value": "create", "label": "新增"},
|
||||
{"value": "update", "label": "修改"},
|
||||
{"value": "delete", "label": "删除"},
|
||||
{"value": "login", "label": "登录"},
|
||||
{"value": "logout", "label": "退出"},
|
||||
{"value": "password", "label": "改密码"},
|
||||
{"value": "revoke", "label": "下线"},
|
||||
{"value": "deny", "label": "越权"},
|
||||
],
|
||||
"menus": [{"key": k, "label": v} for k, v in security.MENUS],
|
||||
"levels": [{"value": "rw", "label": "可编辑"}, {"value": "ro", "label": "只读"},
|
||||
{"value": "", "label": "无权限"}],
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------- 角色
|
||||
@router.get("/rbac/roles")
|
||||
def list_roles(db: Session = Depends(get_db)):
|
||||
users = db.query(User).all()
|
||||
counts: dict[int, int] = {}
|
||||
for u in users:
|
||||
for r in u.roles:
|
||||
counts[r.id] = counts.get(r.id, 0) + 1
|
||||
roles = db.query(Role).order_by(Role.id).all()
|
||||
out = []
|
||||
for r in db.query(Role).order_by(Role.id).all():
|
||||
for r in roles:
|
||||
d = r.to_dict()
|
||||
d["user_count"] = counts.get(r.id, 0)
|
||||
d["user_count"] = db.query(User).filter(User.role_id == r.id).count()
|
||||
out.append(d)
|
||||
return out
|
||||
|
||||
|
||||
@router.post("/rbac/roles")
|
||||
def create_role(body: RoleIn, request: Request, db: Session = Depends(get_db)):
|
||||
def create_role(body: RoleIn, db: Session = Depends(get_db)):
|
||||
name = (body.name or "").strip()
|
||||
if not name:
|
||||
raise HTTPException(status_code=400, detail="角色名不能为空")
|
||||
if db.query(Role).filter(Role.name == name).count():
|
||||
raise HTTPException(status_code=400, detail=f"角色「{name}」已存在")
|
||||
role = Role(name=name[:64], description=(body.description or "").strip() or None,
|
||||
is_builtin=False)
|
||||
menus=security.menus_json(body.menus))
|
||||
db.add(role)
|
||||
db.commit()
|
||||
_set_role_menus(db, role, body.menus)
|
||||
audit.note(request, f"新建角色「{role.name}」")
|
||||
return role.to_dict()
|
||||
|
||||
|
||||
@router.patch("/rbac/roles/{rid}")
|
||||
def update_role(rid: int, body: RolePatch, request: Request, db: Session = Depends(get_db)):
|
||||
def update_role(rid: int, body: RolePatch, db: Session = Depends(get_db)):
|
||||
role = db.get(Role, rid)
|
||||
if role is None:
|
||||
raise HTTPException(status_code=404, detail="角色不存在")
|
||||
|
|
@ -141,68 +59,42 @@ def update_role(rid: int, body: RolePatch, request: Request, db: Session = Depen
|
|||
name = body.name.strip()
|
||||
if not name:
|
||||
raise HTTPException(status_code=400, detail="角色名不能为空")
|
||||
if db.query(Role).filter(Role.name == name, Role.id != rid).count():
|
||||
dup = db.query(Role).filter(Role.name == name, Role.id != rid).count()
|
||||
if dup:
|
||||
raise HTTPException(status_code=400, detail=f"角色「{name}」已存在")
|
||||
if role.is_builtin and role.name == ADMIN_ROLE and name != ADMIN_ROLE:
|
||||
raise HTTPException(status_code=400, detail="内置「管理员」角色不能改名")
|
||||
role.name = name[:64]
|
||||
if body.description is not None:
|
||||
role.description = body.description.strip() or None
|
||||
db.commit()
|
||||
if body.menus is not None:
|
||||
before = _role_menus(db, rid)
|
||||
_set_role_menus(db, role, body.menus)
|
||||
db.expire(role)
|
||||
if before != _role_menus(db, rid):
|
||||
_kick_role_users(db, rid) # 权限变了,让他们重新登录取新权限
|
||||
audit.note(request, f"调整角色「{role.name}」的菜单授权,已下线该角色下的用户")
|
||||
else:
|
||||
audit.note(request, f"修改角色「{role.name}」")
|
||||
else:
|
||||
audit.note(request, f"修改角色「{role.name}」")
|
||||
role.menus = security.menus_json(body.menus)
|
||||
db.commit()
|
||||
return role.to_dict()
|
||||
|
||||
|
||||
def _kick_role_users(db: Session, rid: int) -> None:
|
||||
for uid in [u.id for u in db.query(User).all()
|
||||
if any(r.id == rid for r in u.roles)]:
|
||||
security.revoke_all(db, uid)
|
||||
|
||||
|
||||
@router.delete("/rbac/roles/{rid}")
|
||||
def delete_role(rid: int, request: Request, me: User = Depends(security.current_user),
|
||||
db: Session = Depends(get_db)):
|
||||
def delete_role(rid: int, me: User = Depends(security.current_user), db: Session = Depends(get_db)):
|
||||
role = db.get(Role, rid)
|
||||
if role is None:
|
||||
raise HTTPException(status_code=404, detail="角色不存在")
|
||||
if role.is_builtin:
|
||||
raise HTTPException(status_code=400, detail="内置角色不能删除,可以改它的菜单授权")
|
||||
if any(r.id == rid for r in me.roles):
|
||||
raise HTTPException(status_code=400, detail="内置角色不能删除,可以改它的菜单权限")
|
||||
if me.role_id == rid:
|
||||
raise HTTPException(status_code=400, detail="不能删除自己正在使用的角色")
|
||||
if db.query(UserRole).filter(UserRole.role_id == rid).count():
|
||||
if db.query(User).filter(User.role_id == rid).count():
|
||||
raise HTTPException(status_code=400, detail="该角色下还有用户,请先给他们换角色")
|
||||
db.delete(role) # Role.grants 是 delete-orphan,菜单授权行跟着一起删
|
||||
db.delete(role)
|
||||
db.commit()
|
||||
audit.note(request, f"删除角色「{role.name}」")
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------- 用户
|
||||
@router.get("/rbac/users")
|
||||
def list_users(db: Session = Depends(get_db)):
|
||||
online = {}
|
||||
for s in db.query(UserSession).all():
|
||||
online[s.user_id] = online.get(s.user_id, 0) + 1
|
||||
out = []
|
||||
for u in db.query(User).order_by(User.id).all():
|
||||
d = u.to_dict()
|
||||
d["online"] = online.get(u.id, 0)
|
||||
out.append(d)
|
||||
return out
|
||||
return [u.to_dict() for u in db.query(User).order_by(User.id).all()]
|
||||
|
||||
|
||||
@router.post("/rbac/users")
|
||||
def create_user(body: UserIn, request: Request, db: Session = Depends(get_db)):
|
||||
def create_user(body: UserIn, db: Session = Depends(get_db)):
|
||||
name = (body.name or "").strip()
|
||||
username = (body.username or "").strip()
|
||||
password = (body.password or "").strip()
|
||||
|
|
@ -212,183 +104,58 @@ def create_user(body: UserIn, request: Request, db: Session = Depends(get_db)):
|
|||
raise HTTPException(status_code=400, detail="初始密码至少 6 位")
|
||||
if db.query(User).filter(User.username == username).count():
|
||||
raise HTTPException(status_code=400, detail=f"登录账号「{username}」已存在")
|
||||
role_ids = body.role_ids or _default_role_ids(db)
|
||||
if not role_ids:
|
||||
raise HTTPException(status_code=400, detail="至少要给账号挂一个角色")
|
||||
pw_hash, salt = security.hash_password(password)
|
||||
user = User(name=name[:64], username=username[:64], password_hash=pw_hash,
|
||||
password_salt=salt, active=bool(body.active))
|
||||
user = User(name=name[:64], username=username[:64], password_hash=pw_hash, password_salt=salt,
|
||||
role_id=body.role_id, active=bool(body.active))
|
||||
db.add(user)
|
||||
db.commit()
|
||||
_set_user_roles(db, user, role_ids)
|
||||
audit.note(request, f"新建账号 {user.username}({user.name})")
|
||||
return user.to_dict()
|
||||
|
||||
|
||||
def _default_role_ids(db: Session) -> list[int]:
|
||||
role = db.query(Role).filter(Role.name == "部门成员").one_or_none()
|
||||
return [role.id] if role else []
|
||||
|
||||
|
||||
@router.patch("/rbac/users/{uid}")
|
||||
def update_user(uid: int, body: UserPatch, request: Request,
|
||||
me: User = Depends(security.current_user), db: Session = Depends(get_db)):
|
||||
def update_user(uid: int, body: UserPatch, me: User = Depends(security.current_user),
|
||||
db: Session = Depends(get_db)):
|
||||
user = db.get(User, uid)
|
||||
if user is None:
|
||||
raise HTTPException(status_code=404, detail="用户不存在")
|
||||
|
||||
# 先把所有校验跑完再落库:否则角色/密码改了一半时后面报 400,库里已经是新值了
|
||||
name = None
|
||||
if body.name is not None:
|
||||
name = body.name.strip()
|
||||
if not name:
|
||||
raise HTTPException(status_code=400, detail="姓名不能为空")
|
||||
new_ids: list[int] | None = None
|
||||
if body.role_ids is not None:
|
||||
ids = _effective_role_ids(user, body.role_ids)
|
||||
if sorted(ids) != sorted(r.id for r in user.roles):
|
||||
if user.id == me.id:
|
||||
raise HTTPException(status_code=400, detail="不能修改自己的角色")
|
||||
after = _menus_of_role_ids(db, ids)
|
||||
if user.menus.get("rbac") == "rw" and after.get("rbac") != "rw" \
|
||||
and not _rbac_managers(db, exclude_id=user.id):
|
||||
raise HTTPException(status_code=400, detail="系统里要保留一个可管理权限的账号")
|
||||
new_ids = ids
|
||||
password = (body.password or "").strip()
|
||||
if password and len(password) < 6:
|
||||
raise HTTPException(status_code=400, detail="新密码至少 6 位")
|
||||
if body.active is not None and user.id == me.id and not body.active:
|
||||
raise HTTPException(status_code=400, detail="不能停用自己的账号")
|
||||
if body.active is False and user.menus.get("rbac") == "rw" \
|
||||
and not _rbac_managers(db, exclude_id=user.id):
|
||||
raise HTTPException(status_code=400, detail="系统里要保留一个可管理权限的账号")
|
||||
|
||||
changed_role = False
|
||||
if name:
|
||||
user.name = name[:64]
|
||||
if new_ids is not None:
|
||||
_set_user_roles(db, user, new_ids)
|
||||
changed_role = True
|
||||
if password:
|
||||
user.password_hash, user.password_salt = security.hash_password(password)
|
||||
security.revoke_all(db, user.id) # 改密即下线,旧 token 立即失效
|
||||
if body.role_id is not None and body.role_id != user.role_id:
|
||||
if db.get(Role, body.role_id) is None:
|
||||
raise HTTPException(status_code=400, detail="角色不存在")
|
||||
if user.id == me.id:
|
||||
raise HTTPException(status_code=400, detail="不能修改自己的角色")
|
||||
user.role_id = body.role_id
|
||||
security.revoke_all(db, user.id) # 权限变了,强制重新登录
|
||||
if body.password is not None and body.password.strip():
|
||||
if len(body.password.strip()) < 6:
|
||||
raise HTTPException(status_code=400, detail="新密码至少 6 位")
|
||||
user.password_hash, user.password_salt = security.hash_password(body.password.strip())
|
||||
security.revoke_all(db, user.id)
|
||||
if body.active is not None:
|
||||
if user.id == me.id and not body.active:
|
||||
raise HTTPException(status_code=400, detail="不能停用自己的账号")
|
||||
user.active = bool(body.active)
|
||||
if not user.active:
|
||||
security.revoke_all(db, user.id)
|
||||
db.commit()
|
||||
if changed_role:
|
||||
security.revoke_all(db, user.id) # 权限变了,强制重新登录
|
||||
db.expire(user)
|
||||
what = []
|
||||
if name:
|
||||
what.append("改名")
|
||||
if new_ids is not None:
|
||||
what.append("改角色")
|
||||
if password:
|
||||
what.append("重置密码")
|
||||
if body.active is not None:
|
||||
what.append("启用" if body.active else "停用")
|
||||
audit.note(request, f"修改账号 {user.username}" + (f":{'、'.join(what)}" if what else ""))
|
||||
return user.to_dict()
|
||||
|
||||
|
||||
@router.delete("/rbac/users/{uid}")
|
||||
def delete_user(uid: int, request: Request, me: User = Depends(security.current_user),
|
||||
db: Session = Depends(get_db)):
|
||||
def delete_user(uid: int, me: User = Depends(security.current_user), db: Session = Depends(get_db)):
|
||||
user = db.get(User, uid)
|
||||
if user is None:
|
||||
raise HTTPException(status_code=404, detail="用户不存在")
|
||||
if user.id == me.id:
|
||||
raise HTTPException(status_code=400, detail="不能删除自己,可以换一个角色或让别人删")
|
||||
username = user.username
|
||||
if not db.query(User).filter(User.active.is_(True), User.id != uid).count():
|
||||
remaining = db.query(User).filter(User.active.is_(True), User.id != uid).count()
|
||||
if not remaining:
|
||||
raise HTTPException(status_code=400, detail="至少要保留一个可用账号")
|
||||
if user.active and user.menus.get("rbac") == "rw" and not _rbac_managers(db, exclude_id=user.id):
|
||||
raise HTTPException(status_code=400, detail="系统里要保留一个可管理权限的账号")
|
||||
security.revoke_all(db, user.id)
|
||||
db.delete(user) # user_roles 是 secondary 关联,删用户时 SQLAlchemy 自己会清
|
||||
db.delete(user)
|
||||
db.commit()
|
||||
audit.note(request, f"删除账号 {username}")
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
@router.post("/rbac/users/{uid}/revoke")
|
||||
def revoke_user_sessions(uid: int, request: Request, db: Session = Depends(get_db)):
|
||||
user = db.get(User, uid)
|
||||
if user is None:
|
||||
raise HTTPException(status_code=404, detail="用户不存在")
|
||||
security.revoke_all(db, uid)
|
||||
audit.note(request, f"强制下线 {user.username}")
|
||||
return {"ok": True, "revoked": True}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------- 在线会话
|
||||
@router.get("/rbac/sessions")
|
||||
def list_sessions(db: Session = Depends(get_db)):
|
||||
users = {u.id: u for u in db.query(User).all()}
|
||||
out = []
|
||||
for s in db.query(UserSession).order_by(UserSession.created_at.desc()).all():
|
||||
u = users.get(s.user_id)
|
||||
if u is None:
|
||||
continue
|
||||
d = s.to_dict()
|
||||
d["token"] = s.token # 下线要用真实 token,列表里只展示 token_hint
|
||||
d.update({"user_id": u.id, "name": u.name, "username": u.username})
|
||||
out.append(d)
|
||||
return out
|
||||
|
||||
|
||||
@router.delete("/rbac/sessions/{token}")
|
||||
def revoke_session(token: str, request: Request, db: Session = Depends(get_db)):
|
||||
sess = db.get(UserSession, token)
|
||||
if sess is None:
|
||||
raise HTTPException(status_code=404, detail="会话不存在或已失效")
|
||||
target = db.get(User, sess.user_id)
|
||||
db.delete(sess)
|
||||
db.commit()
|
||||
audit.note(request, f"下线一个登录会话:{target.username if target else '已删除的账号'}")
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------- 操作日志
|
||||
@router.get("/rbac/logs")
|
||||
def list_logs(
|
||||
username: str | None = None,
|
||||
menu: str | None = None,
|
||||
action: str | None = None,
|
||||
days: int = Query(30, ge=1, le=365),
|
||||
limit: int = Query(200, ge=1, le=1000),
|
||||
offset: int = Query(0, ge=0),
|
||||
db: Session = Depends(get_db),
|
||||
):
|
||||
from datetime import timedelta
|
||||
|
||||
from ..models import now as _now
|
||||
|
||||
q = db.query(AuditLog).filter(AuditLog.created_at >= _now() - timedelta(days=days))
|
||||
if username:
|
||||
q = q.filter(AuditLog.username == username)
|
||||
if menu:
|
||||
q = q.filter(AuditLog.menu == menu)
|
||||
if action:
|
||||
q = q.filter(AuditLog.action == action)
|
||||
total = q.count()
|
||||
rows = q.order_by(AuditLog.id.desc()).offset(offset).limit(limit).all()
|
||||
return {"total": total, "items": [r.to_dict() for r in rows]}
|
||||
|
||||
|
||||
@router.delete("/rbac/logs")
|
||||
def clear_logs(days: int = Query(0, ge=0), db: Session = Depends(get_db)):
|
||||
"""清空操作日志;days > 0 时只清 N 天以前的。"""
|
||||
from datetime import timedelta
|
||||
|
||||
from ..models import now as _now
|
||||
|
||||
q = db.query(AuditLog)
|
||||
if days > 0:
|
||||
q = q.filter(AuditLog.created_at < _now() - timedelta(days=days))
|
||||
n = q.count()
|
||||
q.delete(synchronize_session=False)
|
||||
db.commit()
|
||||
return {"ok": True, "deleted": n}
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
"""人力资源库:人员维护 + 人员负载。
|
||||
|
||||
项目 / 定制项目的「负责人」统一取这里的姓名,因此:
|
||||
项目 / 定开项目的「负责人」统一取这里的姓名,因此:
|
||||
· 改名时同步刷新已有项目的负责人字段;
|
||||
· 被项目引用的人不允许直接删除,只能归档(归档后不再出现在下拉里)。
|
||||
"""
|
||||
|
|
@ -51,7 +51,7 @@ ALLOWED_PATCH = ("name", "group", "affiliation", "note", "sort_order", "archived
|
|||
|
||||
|
||||
def _workload(db: Session) -> dict[str, dict]:
|
||||
"""按姓名汇总在管项目 / 定制项目负载。"""
|
||||
"""按姓名汇总在管项目 / 定开项目负载。"""
|
||||
load: dict[str, dict] = {}
|
||||
|
||||
def slot(name: str) -> dict:
|
||||
|
|
@ -283,7 +283,7 @@ def delete_staff(sid: int, force: bool = False, db: Session = Depends(get_db)):
|
|||
if (n1 or n2) and not force:
|
||||
raise HTTPException(
|
||||
400,
|
||||
f"「{m.name}」名下还有 {n1} 个在管项目 / {n2} 个定制项目。"
|
||||
f"「{m.name}」名下还有 {n1} 个在管项目 / {n2} 个定开项目。"
|
||||
f"离职人员建议直接「归档」(归档后不再出现在负责人下拉里,历史记录保留);"
|
||||
f"确需删除请先转交这些项目。",
|
||||
)
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
"""周看板:重点项目 + 定制项目的单周总览。
|
||||
"""周看板:重点项目 + 定开项目的单周总览。
|
||||
|
||||
左侧总览清单(左栏)+ 右侧执行详情(右栏)一次给齐:
|
||||
· 重点项目 = 打了 ★ 的项目,以及本周期有执行记录的项目
|
||||
· 定制项目 = 打了 ★ 的定制项目,本周期有交付记录的,以及本周期新入库的(is_new,可切「全部在途」)
|
||||
· 定开项目 = 打了 ★ 的定开项目,本周期有交付记录的,以及本周期新入库的(is_new,可切「全部在途」)
|
||||
前端左栏只给一个入口,点开后在右栏按「本周新增 / 本周有变化」分组展示。
|
||||
右栏点开某一条时再按需拉 /projects/{id} 或 /custom/projects/{id} 看全量历史。
|
||||
工作看板左栏的「本周工作重点」不在本接口里:前端并发取 /api/focus 后合并成一组。
|
||||
|
|
@ -22,16 +22,6 @@ from .board import resolve_period_ids, worst_status
|
|||
router = APIRouter()
|
||||
|
||||
|
||||
def empty_kpi() -> dict:
|
||||
"""空周期的 KPI 骨架:键与统计结果保持一致,前端不用防 undefined。"""
|
||||
return {
|
||||
"key_total": 0, "key_updated": 0, "key_idle": 0, "project_listed": 0,
|
||||
"update_count": 0, "custom_total": 0, "custom_new": 0, "custom_updated": 0,
|
||||
"custom_amount": 0.0, "amount_delta": 0.0, "revenue_delta": 0.0,
|
||||
"risk_count": 0, "at_risk_count": 0, "blocked_count": 0,
|
||||
}
|
||||
|
||||
|
||||
@router.get("/weekly")
|
||||
def weekly(
|
||||
period_id: int | None = None,
|
||||
|
|
@ -43,14 +33,12 @@ def weekly(
|
|||
):
|
||||
period_ids = resolve_period_ids(db, period_id, year, month)
|
||||
if not period_ids:
|
||||
# 选中的年月还没有任何一周:给同样的结构 + 全 0 指标,而不是空对象
|
||||
return {"periods": [], "projects": [], "custom": [], "kpi": empty_kpi()}
|
||||
return {"periods": [], "projects": [], "custom": [], "kpi": {}}
|
||||
|
||||
periods = db.query(Period).filter(Period.id.in_(period_ids)).order_by(Period.sort_key).all()
|
||||
scope_sort = max(p.sort_key for p in periods)
|
||||
# 本周期(月视图 = 该月所有周)的日期范围,用来判断「本周期新入库」,
|
||||
# 口径与「入库时间」一致:第 1 周 = 第一个周四落在本月的那一周(constants.month_week1),
|
||||
# 所以月范围不等于自然月,跨月周整周算进周四那个月
|
||||
# 口径与「入库时间」一致:该月第一个周一算第 1 周
|
||||
scope_start = min(constants.period_first_day(p.year, p.month, p.week) for p in periods)
|
||||
scope_end = max(constants.period_last_day(p.year, p.month, p.week) for p in periods)
|
||||
# 全部周次(算「连续几周没更新」用)
|
||||
|
|
@ -87,7 +75,7 @@ def weekly(
|
|||
|
||||
project_rows = []
|
||||
for p in db.query(Project).filter(Project.archived.is_(False)).order_by(
|
||||
Project.is_key.desc(), Project.id
|
||||
Project.is_key.desc(), Project.sort_order, Project.id
|
||||
).all():
|
||||
items = ups_by_project.get(p.id, [])
|
||||
if owner and owner not in all_owners(p.owner, p.other_owners):
|
||||
|
|
@ -120,7 +108,7 @@ def weekly(
|
|||
}
|
||||
)
|
||||
|
||||
# ---------------------------------------------------------------- 定制项目
|
||||
# ---------------------------------------------------------------- 定开项目
|
||||
cups_by_project: dict[int, list[CustomUpdate]] = defaultdict(list)
|
||||
for u in (
|
||||
db.query(CustomUpdate).filter(CustomUpdate.period_id.in_(period_ids)).order_by(CustomUpdate.id).all()
|
||||
|
|
@ -137,8 +125,8 @@ def weekly(
|
|||
continue
|
||||
entry = (cp.entry_date or "").strip()
|
||||
is_new = bool(scope_start and scope_end and entry and scope_start <= entry <= scope_end)
|
||||
# 「本周新增 / 本周验收」与「定制项目 · 本周进展」同一口径(见 web/src/views/CustomView.tsx 的「本周进展」与
|
||||
# web/src/views/BoardView.tsx 的定制动态汇总):新增按「下单时间」,验收按「更新时间 + 状态=已验收」。
|
||||
# 「本周新增 / 本周验收」与「定开项目 · 本周进展」同一口径(见 web/app.js 的
|
||||
# customWeeklySections):新增按「下单时间」,验收按「更新时间 + 状态=已验收」。
|
||||
sign = (cp.sign_date or "").strip()[:10]
|
||||
upd = (cp.update_date or "").strip()[:10]
|
||||
is_signed_new = bool(scope_start and scope_end and sign and scope_start <= sign <= scope_end)
|
||||
|
|
@ -194,11 +182,7 @@ def weekly(
|
|||
|
||||
key_all = sum(1 for p in db.query(Project).filter(Project.archived.is_(False), Project.is_key.is_(True)).all())
|
||||
risks = sum(len(r["risks"]) for r in project_rows) + sum(len(r["risks"]) for r in custom_rows)
|
||||
# 风险 / 阻塞分开计数:取执行记录状态(at_risk=风险、blocked=阻塞);定制执行记录没有状态字段,不计入
|
||||
at_risk = sum(1 for r in project_rows for u in r["updates"] if u["status"] == "at_risk")
|
||||
blocked = sum(1 for r in project_rows for u in r["updates"] if u["status"] == "blocked")
|
||||
kpi = {
|
||||
**empty_kpi(),
|
||||
"key_total": key_all,
|
||||
"key_updated": sum(1 for r in project_rows if r["is_key"] and r["has_update"]),
|
||||
"key_idle": sum(1 for r in project_rows if r["is_key"] and not r["has_update"]),
|
||||
|
|
@ -211,10 +195,7 @@ def weekly(
|
|||
"amount_delta": round(sum(r["period_amount_delta"] for r in custom_rows), 2),
|
||||
"revenue_delta": round(sum(r["period_revenue_delta"] for r in custom_rows), 2),
|
||||
"risk_count": risks,
|
||||
"at_risk_count": at_risk,
|
||||
"blocked_count": blocked,
|
||||
}
|
||||
assert set(kpi) == set(empty_kpi()) # 两种返回结构的键必须一致
|
||||
return {
|
||||
"periods": [p.to_dict() for p in periods],
|
||||
"projects": project_rows,
|
||||
|
|
|
|||
|
|
@ -1,12 +1,9 @@
|
|||
"""老库列级对齐:create_all 只会建新表,不会给已存在的表加字段,也不会删字段。
|
||||
"""老库补列:create_all 只会建新表,不会给已存在的表加字段。
|
||||
|
||||
- 模型新增可空字段后(如定制项目的验收时间 / 开票 / 回款),启动时自动
|
||||
`ALTER TABLE ... ADD COLUMN` 补齐:`ensure_columns(engine, Base.metadata)`。
|
||||
- 模型删掉的死字段(历史上如 currency / sort_order / periods 起止日期)用
|
||||
`drop_stale_columns(engine)` 定点清除——只删下方白名单里明确列出的列,
|
||||
不做「模型没有就删」的全量对账,避免误伤老库里来历不明的列。
|
||||
不清理的后果:NOT NULL 列没了默认值来源,INSERT 会直接约束失败。
|
||||
需要 SQLite ≥ 3.35(DROP COLUMN),低版本跳过并在启动日志提示。
|
||||
模型新增可空字段后(如定开项目的验收时间 / 开票 / 回款),启动时自动
|
||||
`ALTER TABLE ... ADD COLUMN` 补齐,不需要手写迁移脚本。
|
||||
|
||||
用法:在 `Base.metadata.create_all()` 之后调用 `ensure_columns(engine, Base.metadata)`。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
|
|
@ -15,47 +12,6 @@ from sqlalchemy.engine import Engine
|
|||
from sqlalchemy.sql.schema import MetaData
|
||||
|
||||
|
||||
# 已在模型中删除、但老库里可能残留的死列(表名, 列名)。删掉模型字段时同步登记到这里。
|
||||
STALE_COLUMNS: tuple[tuple[str, str], ...] = (
|
||||
("custom_projects", "currency"), # 外币折算从未落地,Python 端 default 一删,老库 INSERT 会撞 NOT NULL
|
||||
("tasks", "sort_order"), # 子任务实际按 id 排序,此列只写不读
|
||||
("periods", "start_date"), # 周期起止由 year/month/week 推导,两列从未被读取
|
||||
("periods", "end_date"),
|
||||
("projects", "priority"), # 优先级无界面读写,导出恒为 P2(NOT NULL 列,必须清)
|
||||
("projects", "sort_order"), # 恒为 0 的排序位:无任何入口写过,排序语义空转(Staff/Category 的同名列是活的)
|
||||
("projects", "description"),
|
||||
)
|
||||
|
||||
|
||||
def drop_stale_columns(engine: Engine) -> list[str]:
|
||||
"""删除 STALE_COLUMNS 里登记的残留列,返回实际删掉的(表.列)。幂等。
|
||||
|
||||
这个函数在 main.py 导入期执行,任何一列失败都不能掀翻整个服务:
|
||||
索引 / UNIQUE / 视图引用会让 DROP COLUMN 报错(老库常态),逐列 try 后跳过即可——
|
||||
死列留着不碍业务,服务起不来才碍。
|
||||
"""
|
||||
if engine.dialect.name != "sqlite": # MySQL 等目标库不做 SQLite 式清列
|
||||
return []
|
||||
from sqlite3 import sqlite_version_info # 先看驱动能力,低版本直接跳过
|
||||
if sqlite_version_info < (3, 35):
|
||||
print("[warn] SQLite < 3.35 不支持 DROP COLUMN,死列保留(不影响功能,只是占位)")
|
||||
return []
|
||||
insp = inspect(engine)
|
||||
dropped: list[str] = []
|
||||
for table, col in STALE_COLUMNS:
|
||||
if not insp.has_table(table):
|
||||
continue
|
||||
if col not in {c["name"] for c in insp.get_columns(table)}:
|
||||
continue
|
||||
try:
|
||||
with engine.begin() as conn:
|
||||
conn.execute(text(f"ALTER TABLE {table} DROP COLUMN {col}"))
|
||||
dropped.append(f"{table}.{col}")
|
||||
except Exception as e: # 索引/UNIQUE/视图引用等:留着死列继续启动,日志说清人话
|
||||
print(f"[warn] 跳过死列 {table}.{col}:删不掉({e}),不影响使用")
|
||||
return dropped
|
||||
|
||||
|
||||
def ensure_columns(engine: Engine, metadata: MetaData) -> list[str]:
|
||||
"""给已存在的表补上模型里新增的可空字段,返回补过的列名(表.列)。"""
|
||||
insp = inspect(engine)
|
||||
|
|
|
|||
|
|
@ -12,8 +12,10 @@ class ProjectIn(BaseModel):
|
|||
owners: list[str] | None = None # 多负责人(第一位是主负责人),整体替换
|
||||
members: list[str] | None = None # 团队成员,整体替换
|
||||
status: str = "in_progress"
|
||||
priority: str = "p2"
|
||||
is_key: bool = False
|
||||
progress: float = 0
|
||||
description: str | None = None
|
||||
archived: bool = False
|
||||
tags: list[str] = Field(default_factory=list) # 标签名,自动创建
|
||||
|
||||
|
|
@ -25,8 +27,10 @@ class ProjectPatch(BaseModel):
|
|||
owners: list[str] | None = None # 不传即不改;传空数组即清空
|
||||
members: list[str] | None = None
|
||||
status: str | None = None
|
||||
priority: str | None = None
|
||||
is_key: bool | None = None
|
||||
progress: float | None = None
|
||||
description: str | None = None
|
||||
archived: bool | None = None
|
||||
tags: list[str] | None = None
|
||||
|
||||
|
|
@ -36,10 +40,24 @@ class CategoryIn(BaseModel):
|
|||
color: str = "#2563eb"
|
||||
|
||||
|
||||
class CategoryPatch(BaseModel):
|
||||
"""分类部分更新:只改传了的字段(README 两种请求体模式的既定语义)。"""
|
||||
name: str | None = None
|
||||
color: str | None = None
|
||||
class TagIn(BaseModel):
|
||||
name: str
|
||||
color: str = "#6b7280"
|
||||
|
||||
|
||||
class PeriodIn(BaseModel):
|
||||
label: str
|
||||
kind: str = "week"
|
||||
year: int
|
||||
month: int
|
||||
week: int = 0
|
||||
start_date: str | None = None
|
||||
end_date: str | None = None
|
||||
|
||||
|
||||
class TaskIn(BaseModel):
|
||||
project_id: int
|
||||
name: str
|
||||
|
||||
|
||||
class UpdateIn(BaseModel):
|
||||
|
|
@ -93,6 +111,10 @@ class AICommitIn(BaseModel):
|
|||
model: str | None = None
|
||||
|
||||
|
||||
class SettingsIn(BaseModel):
|
||||
values: dict[str, str]
|
||||
|
||||
|
||||
class FocusIn(BaseModel):
|
||||
"""每周重点工作(单条录入)。
|
||||
|
||||
|
|
@ -151,12 +173,12 @@ class UserIn(BaseModel):
|
|||
name: str
|
||||
username: str
|
||||
password: str
|
||||
role_ids: list[int] = Field(default_factory=list) # 可挂多个角色,权限取并集
|
||||
role_id: int | None = None
|
||||
active: bool = True
|
||||
|
||||
|
||||
class UserPatch(BaseModel):
|
||||
name: str | None = None
|
||||
role_ids: list[int] | None = None # 不传即不改;传空数组即清空(该用户将没有任何权限)
|
||||
role_id: int | None = None
|
||||
active: bool | None = None
|
||||
password: str | None = None # 管理员重置密码,不需要旧密码
|
||||
|
|
|
|||
|
|
@ -1,54 +1,56 @@
|
|||
"""登录与权限(RBAC)。
|
||||
|
||||
三层模型:**用户 ←(多对多)→ 角色 ←(一对多)→ 菜单授权**
|
||||
· `role_menus` 存授权矩阵:一行 = 一个菜单一个级别,`rw` 可编辑 / `ro` 只读,
|
||||
表里没有这一行就是看不到该菜单;
|
||||
· 一个用户可以挂多个角色,最终权限取并集(同一菜单取更高级别);
|
||||
· 菜单权限同时管两端:前端按 `/auth/me` 返回的 menus 过滤侧栏与写操作按钮,
|
||||
后端 `guard` 按「请求路径 → 菜单 → 级别」二次校验,直接调接口也绕不过去;
|
||||
· 所有写操作与登录行为写进 `audit_logs`,在「权限管理 → 操作日志」里查。
|
||||
|
||||
会话是服务端 token(HttpOnly Cookie),退出登录 / 停用 / 改密 / 强制下线都是删 token,立即失效。
|
||||
角色 = 一组功能菜单权限(rw 可编辑 / ro 只读 / 没配就是看不到),用户挂一个角色。
|
||||
菜单权限同时管两端:
|
||||
· 前端按 /auth/me 返回的 menus 过滤侧边栏菜单、隐藏写操作按钮;
|
||||
· 后端用 guard 依赖按「请求路径 -> 菜单」做二次校验,直接调接口也绕不过去。
|
||||
会话是服务端 token(HttpOnly Cookie),退出登录 / 禁用用户时删 token 立即失效。
|
||||
密码只存 pbkdf2 派生值,用标准库,不引额外依赖。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import hashlib
|
||||
import hmac
|
||||
import json
|
||||
import secrets
|
||||
from datetime import timedelta
|
||||
from datetime import datetime, timedelta
|
||||
|
||||
from fastapi import Depends, HTTPException, Request
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from . import config
|
||||
from .constants import (
|
||||
LEVEL_LABELS,
|
||||
LEVEL_RANK,
|
||||
LEVELS,
|
||||
MENU_KEYS,
|
||||
MENU_LABELS,
|
||||
)
|
||||
from .db import get_db
|
||||
from .models import Role, RoleMenu, User, UserRole, UserSession, now
|
||||
from .models import Role, User, UserSession, now
|
||||
|
||||
SESSION_COOKIE = "unis_session"
|
||||
PBKDF2_ROUNDS = 120_000
|
||||
|
||||
__all__ = [
|
||||
"MENU_KEYS", "MENU_LABELS", "LEVELS", "LEVEL_LABELS",
|
||||
"SESSION_COOKIE", "normalize_menus", "hash_password", "verify_password",
|
||||
"start_session", "revoke_all", "user_from_token", "current_user", "guard",
|
||||
"resolve_rule", "ensure_seed",
|
||||
# 功能菜单:键是前后端共用的权限标识,顺序即权限管理页里的展示顺序
|
||||
MENUS = [
|
||||
("board", "工作看板"),
|
||||
("projects", "自研产品"),
|
||||
("custom", "定制项目"),
|
||||
("focus", "每周工作"),
|
||||
("staff", "人力资源"),
|
||||
("intake", "更新录入"),
|
||||
("settings", "设置"),
|
||||
("rbac", "权限管理"),
|
||||
]
|
||||
MENU_KEYS = [k for k, _ in MENUS]
|
||||
MENU_LABELS = dict(MENUS)
|
||||
LEVELS = ("ro", "rw")
|
||||
|
||||
# 接口路径首段 -> 菜单。没列出来的(/meta 等)只要求登录,不看菜单。
|
||||
SEGMENT_MENU = {
|
||||
"focus": "focus",
|
||||
"weekly": "board",
|
||||
"board": "board",
|
||||
"stats": "board",
|
||||
"projects": "projects",
|
||||
"categories": "projects",
|
||||
"tags": "projects",
|
||||
"updates": "projects",
|
||||
"tasks": "projects",
|
||||
"custom": "custom",
|
||||
"staff": "staff",
|
||||
"ai": "intake",
|
||||
|
|
@ -67,66 +69,49 @@ EXPORT_MENU = {
|
|||
}
|
||||
|
||||
|
||||
# ------------------------------------------------------------------ 权限表
|
||||
def normalize_menus(raw) -> dict:
|
||||
"""清洗前端传来的权限表:只留已知菜单 + 合法级别。"""
|
||||
out: dict[str, str] = {}
|
||||
for key, value in (raw or {}).items():
|
||||
if key in MENU_LABELS and value in LEVELS:
|
||||
if key in MENU_KEYS and value in LEVELS:
|
||||
out[key] = value
|
||||
return out
|
||||
|
||||
|
||||
def menus_json(menus: dict) -> str:
|
||||
return json.dumps(normalize_menus(menus), ensure_ascii=False, sort_keys=True)
|
||||
|
||||
|
||||
# ------------------------------------------------------------------ 密码
|
||||
def hash_password(password: str) -> tuple[str, str]:
|
||||
salt = secrets.token_hex(16)
|
||||
digest = hashlib.pbkdf2_hmac("sha256", password.encode(), bytes.fromhex(salt), PBKDF2_ROUNDS)
|
||||
digest = hashlib.pbkdf2_hmac("sha256", password.encode("utf-8"), bytes.fromhex(salt), PBKDF2_ROUNDS)
|
||||
return digest.hex(), salt
|
||||
|
||||
|
||||
def verify_password(password: str, password_hash: str, salt: str) -> bool:
|
||||
try:
|
||||
digest = hashlib.pbkdf2_hmac(
|
||||
"sha256", (password or "").encode(), bytes.fromhex(salt), PBKDF2_ROUNDS
|
||||
)
|
||||
digest = hashlib.pbkdf2_hmac("sha256", password.encode("utf-8"), bytes.fromhex(salt), PBKDF2_ROUNDS)
|
||||
except ValueError:
|
||||
return False
|
||||
return hmac.compare_digest(digest.hex(), password_hash)
|
||||
|
||||
|
||||
# ------------------------------------------------------------------ 会话
|
||||
def _clip(value: str | None, size: int) -> str | None:
|
||||
return value[:size] if value else None
|
||||
|
||||
|
||||
def start_session(db: Session, user: User, ip: str | None = None,
|
||||
user_agent: str | None = None) -> str:
|
||||
def start_session(db: Session, user: User) -> str:
|
||||
token = secrets.token_urlsafe(32)
|
||||
db.add(UserSession(token=token, user_id=user.id,
|
||||
expires_at=now() + timedelta(days=config.SESSION_DAYS),
|
||||
ip=_clip(ip, 64), user_agent=_clip(user_agent, 128)))
|
||||
expires_at=now() + timedelta(days=config.SESSION_DAYS)))
|
||||
user.last_login_at = now()
|
||||
db.commit()
|
||||
return token
|
||||
|
||||
|
||||
def revoke_all(db: Session, user_id: int, keep_token: str | None = None) -> None:
|
||||
q = db.query(UserSession).filter(UserSession.user_id == user_id)
|
||||
if keep_token:
|
||||
q = q.filter(UserSession.token != keep_token)
|
||||
q.delete(synchronize_session=False)
|
||||
def revoke_all(db: Session, user_id: int) -> None:
|
||||
db.query(UserSession).filter(UserSession.user_id == user_id).delete(synchronize_session=False)
|
||||
db.commit()
|
||||
|
||||
|
||||
def purge_expired_sessions(db: Session) -> int:
|
||||
q = db.query(UserSession).filter(UserSession.expires_at < now())
|
||||
n = q.count()
|
||||
if n:
|
||||
q.delete(synchronize_session=False)
|
||||
db.commit()
|
||||
return n
|
||||
|
||||
|
||||
def user_from_token(db: Session, token: str | None) -> User | None:
|
||||
if not token:
|
||||
return None
|
||||
|
|
@ -139,59 +124,6 @@ def user_from_token(db: Session, token: str | None) -> User | None:
|
|||
return user
|
||||
|
||||
|
||||
# ------------------------------------------------------------------ 内置数据
|
||||
BUILTIN_ROLES = [
|
||||
("管理员", "全部菜单可编辑,含设置与权限管理", {k: "rw" for k in MENU_KEYS}, True),
|
||||
("部门成员", "业务菜单可编辑,不能改设置与权限",
|
||||
{k: "rw" for k in MENU_KEYS if k not in ("settings", "rbac")}, True),
|
||||
("只读访客", "只能查看,不能修改任何数据",
|
||||
{k: "ro" for k in MENU_KEYS if k != "rbac"}, True),
|
||||
]
|
||||
|
||||
|
||||
def ensure_seed(db: Session) -> list[str]:
|
||||
"""首次启动(或升级后)补内置角色与管理员账号,返回新建的提示项。"""
|
||||
notes: list[str] = []
|
||||
for name, desc, menus, builtin in BUILTIN_ROLES:
|
||||
role = db.query(Role).filter(Role.name == name).one_or_none()
|
||||
if role is None:
|
||||
role = Role(name=name, description=desc, is_builtin=builtin)
|
||||
db.add(role)
|
||||
db.flush()
|
||||
notes.append(f"已创建内置角色「{name}」")
|
||||
if not db.query(RoleMenu).filter(RoleMenu.role_id == role.id).count():
|
||||
for menu, level in normalize_menus(menus).items():
|
||||
db.add(RoleMenu(role_id=role.id, menu=menu, level=level))
|
||||
admin_role = db.query(Role).filter(Role.name == "管理员").one()
|
||||
if not db.query(User).count():
|
||||
pw_hash, salt = hash_password(config.ADMIN_PASSWORD)
|
||||
user = User(name=config.ADMIN_USERNAME, username=config.ADMIN_USERNAME,
|
||||
password_hash=pw_hash, password_salt=salt, active=True)
|
||||
db.add(user)
|
||||
db.flush()
|
||||
db.add(UserRole(user_id=user.id, role_id=admin_role.id))
|
||||
notes.append(f"已创建管理员账号 {config.ADMIN_USERNAME}(请尽快在用户设置里改密码)")
|
||||
else:
|
||||
# 保证系统里至少有一个「启用 + 能管权限」的账号,不会把自己锁在门外。
|
||||
# 兜底顺序:启但没挂管理员的最早账号 → 全员停用时启用最早账号;插入前先查重,避免撞 user_roles 唯一键。
|
||||
guarded = [u for u in db.query(User).filter(User.active.is_(True)).all()
|
||||
if u.menus.get("rbac") == "rw"]
|
||||
if not guarded:
|
||||
active = db.query(User).filter(User.active.is_(True)).order_by(User.id).all()
|
||||
target = active[0] if active else db.query(User).order_by(User.id).first()
|
||||
if target is not None:
|
||||
dup = db.query(UserRole).filter_by(user_id=target.id, role_id=admin_role.id).first()
|
||||
if not dup:
|
||||
db.add(UserRole(user_id=target.id, role_id=admin_role.id))
|
||||
revived = ""
|
||||
if not target.active:
|
||||
target.active = True
|
||||
revived = "并重新启用"
|
||||
notes.append(f"已把「管理员」角色{revived}补给 {target.username},避免没人能管权限")
|
||||
db.commit()
|
||||
return notes
|
||||
|
||||
|
||||
# ------------------------------------------------------------------ 依赖
|
||||
READ_METHODS = ("GET", "HEAD", "OPTIONS")
|
||||
|
||||
|
|
@ -200,12 +132,7 @@ def resolve_rule(path: str, method: str):
|
|||
"""请求 -> (菜单, 是否写操作);菜单为 None 表示只要登录就能访问。"""
|
||||
parts = [x for x in path.split("/") if x] # /api/custom/projects -> [...]
|
||||
if len(parts) >= 2 and parts[0] == "api" and parts[1] == "export":
|
||||
name = parts[2] if len(parts) > 2 else ""
|
||||
menu = EXPORT_MENU.get(name)
|
||||
if menu is None:
|
||||
# fail-closed:新增 /export/* 必须先在 EXPORT_MENU 登记归属菜单,否则一律 403,
|
||||
# 不会出现「忘了挂权限、任何登录用户都能下载」的窗口。
|
||||
raise HTTPException(status_code=403, detail=f"导出接口「{name}」未登记权限归属,禁止访问")
|
||||
menu = EXPORT_MENU.get(parts[2] if len(parts) > 2 else "")
|
||||
elif len(parts) >= 2 and parts[0] == "api":
|
||||
menu = SEGMENT_MENU.get(parts[1])
|
||||
else:
|
||||
|
|
@ -218,39 +145,52 @@ def resolve_rule(path: str, method: str):
|
|||
return menu, method not in READ_METHODS
|
||||
|
||||
|
||||
def ensure_seed(db: Session) -> list[str]:
|
||||
"""首次启动(或升级后)补内置角色与管理员账号,返回新建的提示项。"""
|
||||
notes: list[str] = []
|
||||
presets = [
|
||||
("管理员", "全部菜单可编辑,含设置与权限管理",
|
||||
{k: "rw" for k in MENU_KEYS}, True),
|
||||
("部门成员", "业务菜单可编辑,不能改设置与权限",
|
||||
{k: "rw" for k in MENU_KEYS if k not in ("settings", "rbac")}, True),
|
||||
("只读访客", "只能查看,不能修改任何数据",
|
||||
{k: "ro" for k in MENU_KEYS if k != "rbac"}, True),
|
||||
]
|
||||
role_map: dict[str, Role] = {r.name: r for r in db.query(Role).all()}
|
||||
for name, desc, menus, builtin in presets:
|
||||
role = role_map.get(name)
|
||||
if role is None:
|
||||
role = Role(name=name, description=desc, menus=menus_json(menus), is_builtin=builtin)
|
||||
db.add(role)
|
||||
db.flush()
|
||||
role_map[name] = role
|
||||
notes.append(f"已创建内置角色「{name}」")
|
||||
if not db.query(User).count():
|
||||
pw_hash, salt = hash_password(config.ADMIN_PASSWORD)
|
||||
db.add(User(name=config.ADMIN_USERNAME, username=config.ADMIN_USERNAME,
|
||||
password_hash=pw_hash, password_salt=salt,
|
||||
role_id=role_map["管理员"].id, active=True))
|
||||
db.commit()
|
||||
notes.append(f"已创建管理员账号 {config.ADMIN_USERNAME}(请尽快在用户设置里改密码)")
|
||||
db.commit()
|
||||
return notes
|
||||
|
||||
|
||||
def guard(request: Request, db: Session = Depends(get_db)) -> User | None:
|
||||
"""挂在 /api 子应用上的总闸:先验登录,再按菜单权限放行。"""
|
||||
path = request.url.path
|
||||
if path.rstrip("/") == "/api/auth/login":
|
||||
return None
|
||||
user = user_from_token(db, request.cookies.get(SESSION_COOKIE))
|
||||
request.state.user = user
|
||||
if user is None:
|
||||
raise HTTPException(status_code=401, detail="登录已失效,请重新登录")
|
||||
if path.startswith("/api/rbac/"):
|
||||
# 权限管理自身必须显式授权,普通用户即使能读别的菜单也不能碰
|
||||
if "rbac" not in user.menus:
|
||||
raise HTTPException(status_code=403, detail=f"没有「{MENU_LABELS['rbac']}」的访问权限")
|
||||
raise HTTPException(status_code=403, detail="没有「权限管理」的访问权限")
|
||||
if request.method not in READ_METHODS and user.menus.get("rbac") != "rw":
|
||||
raise HTTPException(status_code=403, detail=f"「{MENU_LABELS['rbac']}」是只读权限,不能修改")
|
||||
raise HTTPException(status_code=403, detail="「权限管理」是只读权限,不能修改")
|
||||
return user
|
||||
# 录入页跨菜单依赖:录入定制项目必须能读定制元数据 / 项目清单,并写交付记录(含 AI 整理 / AI 落库)。
|
||||
# 只给「更新录入」权限的账号也要能完成录入,这几个接口按 custom / intake 两者中较高的级别放行;
|
||||
# 定制项目其余接口(详情、修改、归档……)仍严格走 custom 菜单。
|
||||
assist_reads = ("/api/custom/meta", "/api/custom/projects")
|
||||
assist_writes = ("/api/custom/updates", "/api/custom/ai/parse", "/api/custom/ai/commit")
|
||||
assist = ((request.method in READ_METHODS and path in assist_reads)
|
||||
or (request.method == "POST" and path in assist_writes))
|
||||
if assist:
|
||||
need_write = request.method not in READ_METHODS
|
||||
have = max((user.menus.get(m, "") for m in ("custom", "intake")),
|
||||
key=lambda x: LEVEL_RANK.get(x, 0))
|
||||
if have and (not need_write or have == "rw"):
|
||||
return user
|
||||
pair = f"「{MENU_LABELS['intake']}」或「{MENU_LABELS['custom']}」"
|
||||
raise HTTPException(status_code=403, detail=(
|
||||
f"操作定制项目需要{pair}的可编辑权限" if need_write
|
||||
else f"查看定制项目需要{pair}的查看权限"))
|
||||
rule = resolve_rule(path, request.method)
|
||||
if rule is None:
|
||||
return user
|
||||
|
|
@ -267,5 +207,4 @@ def current_user(request: Request, db: Session = Depends(get_db)) -> User:
|
|||
user = user_from_token(db, request.cookies.get(SESSION_COOKIE))
|
||||
if user is None:
|
||||
raise HTTPException(status_code=401, detail="请先登录")
|
||||
request.state.user = user
|
||||
return user
|
||||
|
|
|
|||
Binary file not shown.
|
|
@ -0,0 +1,25 @@
|
|||
本周主要完成华润啤酒的需求开发和华智工厂的问题定位;
|
||||
一、华润啤酒(开发进度70%):基本完成开发,下周合代码进行联调
|
||||
(1)集群迁移 --确定新方案k3s,进度 70%
|
||||
(2)网关接入(先实现了麒麟)--方案确定用nginx自己实现,网关开放8113端口,文件分发走一个端口,增加域名,网关不做集群,进度70%
|
||||
(3)数据恢复工具,已提供解决方案(仅限windows)
|
||||
(4)wifi二次认证未验证 --已完成开发,需要现场验证
|
||||
(5)域用户模式下ip配置穿透到麒麟系统 ----开发完成
|
||||
(6)系统日志收集,--开发完成
|
||||
(7)管理平台支持https --开发完成
|
||||
(8)服务器组raid,提供文档和验证,不涉及修改代码
|
||||
(9)信创通升级增加提示,会覆盖数据 --开发完成
|
||||
(10)升级明细删除 --开发完成
|
||||
(11) 镜像文件路径切换 --开发完成
|
||||
二、协助处理华智工厂反馈的卡死问题
|
||||
(1)终端24h运行使用,本身盒子性能不高,我们提供了关闭agent的脚本,建议定时重启释放内存与清理缓存
|
||||
10.虚拟应用更新缺少覆盖提醒 --主线版本开发中
|
||||
三、临沂公安、龙江交投、大唐能源、佛山盘古、云南楚雄暂无进度和投入,详见表格
|
||||
四、主线:
|
||||
(1)center面板,开发进度100%
|
||||
(2)集群部署,进度70%
|
||||
(3)国产化操作系统和国产化数据库切换,进度60%
|
||||
(4)授权卸载管理,开发100%
|
||||
(5)内核升级,开发100%
|
||||
(6)升级任务删除,开发100%
|
||||
(7)系统默认用户名称修改开发100%
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -1,42 +0,0 @@
|
|||
# 部门关键任务追踪看板 · 部署编排
|
||||
#
|
||||
# 常用命令(推荐用封装脚本,会顺带检查 docker/.env/data 目录并等健康检查):
|
||||
# ./scripts/deploy.sh up 构建 + 后台启动
|
||||
# ./scripts/deploy.sh update 改完代码重建并替换容器
|
||||
# ./scripts/deploy.sh logs # 看日志
|
||||
# ./scripts/deploy.sh down # 停止(数据留在 ./data)
|
||||
#
|
||||
# 等价的裸 compose 命令:docker compose up -d --build
|
||||
|
||||
services:
|
||||
board:
|
||||
build:
|
||||
context: .
|
||||
args:
|
||||
# 基础镜像仓库前缀 + pip 源,都由 scripts/deploy.sh 探测后写进 .env(也可手工在 .env 里钉死)
|
||||
BASE_IMAGE: "${BASE_IMAGE:-python:3.12-slim}"
|
||||
PIP_INDEX_URL: "${PIP_INDEX_URL:-https://pypi.tuna.tsinghua.edu.cn/simple}"
|
||||
image: unis-board:latest
|
||||
container_name: unis-board
|
||||
restart: unless-stopped
|
||||
|
||||
# AI 整理参数、管理员账号等都来自 .env(compose 会自动读同目录的 .env 做变量替换)
|
||||
env_file: .env
|
||||
|
||||
environment:
|
||||
# 容器内端口固定 8770,跟 EXPOSE/健康检查对齐;要换对外端口请改 HOST_PORT
|
||||
PORT: "8770"
|
||||
# 容器里不开热加载(uvicorn --reload 会白耗 CPU,且代码在镜像内不可改)
|
||||
DEV: "0"
|
||||
# 覆盖宿主机的 TZ:周期/周次/入库时间都按这个时区计算
|
||||
TZ: "${TZ:-Asia/Shanghai}"
|
||||
|
||||
ports:
|
||||
- "${HOST_PORT:-8770}:8770"
|
||||
|
||||
volumes:
|
||||
# SQLite 库、上传件、导出件都落在宿主机的 ./data,升级镜像不动数据
|
||||
- ./data:/app/data
|
||||
|
||||
# Linux 上想让容器以普通用户跑(配合 ./data 的属主):
|
||||
# user: "1000:1000"
|
||||
|
|
@ -1,65 +0,0 @@
|
|||
# NEX 0.1.7 默认项目配置
|
||||
# 新项目使用明确默认栈;已有项目保留真实栈。
|
||||
# 普通使用无需填写整张表,只需覆盖与项目意图不同的字段。
|
||||
|
||||
nex:
|
||||
version: "0.1.7"
|
||||
compliance: required
|
||||
|
||||
project:
|
||||
name: auto
|
||||
lifecycle: auto # auto | new | existing
|
||||
type: fullstack # fullstack | frontend-only | backend-only
|
||||
language: zh-CN
|
||||
|
||||
# 仅作为新项目的默认技术方案。已有项目不得据此迁移。
|
||||
stack:
|
||||
preset: nex-standard-fullstack
|
||||
version_policy: latest-stable-compatible
|
||||
lockfile: required
|
||||
frontend:
|
||||
framework: React
|
||||
language: TypeScript
|
||||
build_tool: Vite
|
||||
package_manager: npm
|
||||
ui_library: Ant Design
|
||||
styling: Tailwind CSS v4 + CSS Variables
|
||||
state_management: Zustand
|
||||
routing: React Router
|
||||
http_client: Axios
|
||||
backend:
|
||||
language: Python
|
||||
framework: FastAPI
|
||||
validation: Pydantic
|
||||
orm: SQLAlchemy
|
||||
migrations: Alembic
|
||||
database:
|
||||
development: SQLite
|
||||
production: PostgreSQL
|
||||
api:
|
||||
style: REST
|
||||
contract: OpenAPI
|
||||
storage:
|
||||
local_assets: ./data
|
||||
|
||||
# NEX 只定义设计和开发行为,不定义测试工具或质量闸门。
|
||||
requirements:
|
||||
use_shared_components: true
|
||||
use_design_tokens: true
|
||||
maintain_existing_interactions: true
|
||||
preserve_verified_patterns: true
|
||||
preserve_existing_stack: true
|
||||
avoid_duplicate_design_system_layers: true
|
||||
responsive_design: required
|
||||
accessibility_design: required
|
||||
performance_aware_design: required
|
||||
audit_before_broad_refactor: true
|
||||
require_approval_for_broad_changes: true
|
||||
|
||||
agent:
|
||||
default_execution: lightweight
|
||||
load_documents_by_task: true
|
||||
create_reports_by_default: false
|
||||
create_custom_check_scripts: false
|
||||
add_test_frameworks: false
|
||||
run_full_project_audit_for_routine_tasks: false
|
||||
|
|
@ -1,3 +0,0 @@
|
|||
[pytest]
|
||||
testpaths = tests
|
||||
addopts = -q
|
||||
|
|
@ -1,6 +0,0 @@
|
|||
# 开发 / 测试依赖
|
||||
# ./.venv/bin/pip install -r requirements-dev.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
|
||||
# ./.venv/bin/python -m pytest -q
|
||||
pytest>=8.0
|
||||
httpx>=0.27
|
||||
openpyxl>=3.1
|
||||
|
|
@ -0,0 +1,100 @@
|
|||
#!/usr/bin/env bash
|
||||
# 部门关键任务追踪看板 · 启动脚本
|
||||
# 用法: ./run.sh 正常启动(默认开热更新)
|
||||
# PORT=8771 ./run.sh 换端口启动
|
||||
# DEV=0 ./run.sh 关闭热更新(改代码不自动重启、页面不自动刷新)
|
||||
# NO_OPEN=1 ./run.sh 启动后不自动打开浏览器
|
||||
set -euo pipefail
|
||||
cd "$(dirname "$0")"
|
||||
|
||||
# 热更新默认开启:改 Python / 前端 / .env 自动重启服务,页面发现重启后自动刷新。
|
||||
# 需要 DEV 也传给 app.config(/health 的 dev 标记决定页面是否轮询),所以这里 export 出去。
|
||||
DEV="${DEV:-1}"
|
||||
export DEV
|
||||
|
||||
PORT="${PORT:-8770}"
|
||||
XLSX="${XLSX:-/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx}"
|
||||
STAFF_XLSX="${STAFF_XLSX:-/Users/jiliu/WorkSpace/unissense/部门管理/软件开发部人员名单.xlsx}"
|
||||
|
||||
echo "==> 部门关键任务追踪看板"
|
||||
|
||||
# ---------- 1. 选择带依赖的 Python 解释器 ----------
|
||||
CANDIDATES=(
|
||||
"./.venv/bin/python"
|
||||
"/Users/jiliu/.workbuddy/binaries/python/envs/default/bin/python"
|
||||
"$(command -v python3 2>/dev/null || true)"
|
||||
"/usr/bin/python3"
|
||||
)
|
||||
PY=""
|
||||
FALLBACK=""
|
||||
for c in "${CANDIDATES[@]}"; do
|
||||
[ -n "$c" ] && [ -x "$c" ] || continue
|
||||
[ -z "$FALLBACK" ] && FALLBACK="$c"
|
||||
if "$c" -c "import fastapi, uvicorn, sqlalchemy" >/dev/null 2>&1; then
|
||||
PY="$c"; break
|
||||
fi
|
||||
done
|
||||
|
||||
if [ -z "$PY" ]; then
|
||||
PY="$FALLBACK"
|
||||
if [ -z "$PY" ]; then
|
||||
echo "!! 没有找到 Python 3,请先安装后再运行。" >&2
|
||||
exit 1
|
||||
fi
|
||||
echo "==> 缺少依赖,正在安装到 $PY"
|
||||
"$PY" -m pip install -r requirements.txt || {
|
||||
echo "!! 依赖安装失败,请手动执行:" >&2
|
||||
echo " $PY -m pip install -r requirements.txt" >&2
|
||||
exit 1
|
||||
}
|
||||
fi
|
||||
echo " 使用解释器:$PY"
|
||||
|
||||
# ---------- 2. 端口占用检查(已在运行就直接给出地址) ----------
|
||||
if curl -s -o /dev/null --max-time 2 "http://127.0.0.1:${PORT}/health" 2>/dev/null; then
|
||||
echo "==> 端口 ${PORT} 上已有服务在运行"
|
||||
echo " 看板地址: http://127.0.0.1:${PORT}"
|
||||
echo " (要重启请先在原窗口按 Ctrl+C,或执行:lsof -ti:${PORT} | xargs kill)"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# ---------- 3. 首次运行:建库 + 导入历史数据 ----------
|
||||
if [ ! -f data/board.db ]; then
|
||||
echo "==> 首次运行,初始化数据库"
|
||||
"$PY" scripts/init_db.py
|
||||
if [ -f "$XLSX" ]; then
|
||||
echo "==> 导入历史数据:$XLSX"
|
||||
"$PY" scripts/import_excel.py "$XLSX"
|
||||
echo "==> 拆分定开项目"
|
||||
"$PY" scripts/migrate_custom.py
|
||||
else
|
||||
echo " (未找到 Excel 源文件,跳过历史数据导入:$XLSX)"
|
||||
fi
|
||||
if [ -f "$STAFF_XLSX" ]; then
|
||||
echo "==> 导入人员名单:$STAFF_XLSX"
|
||||
"$PY" scripts/import_staff.py "$STAFF_XLSX"
|
||||
else
|
||||
echo " (未找到人员名单,跳过人力库导入:$STAFF_XLSX)"
|
||||
fi
|
||||
fi
|
||||
|
||||
# ---------- 4. 启动 ----------
|
||||
# uvicorn 默认只监听 *.py,这里补上前端文件与 .env
|
||||
RELOAD_ARGS=()
|
||||
if [ "$DEV" = "1" ]; then
|
||||
RELOAD_ARGS=(--reload
|
||||
--reload-include "*.js" --reload-include "*.css" --reload-include "*.html"
|
||||
--reload-include ".env")
|
||||
fi
|
||||
|
||||
URL="http://127.0.0.1:${PORT}"
|
||||
echo "==> 启动服务: $URL"
|
||||
echo " API 文档: $URL/api/docs"
|
||||
echo " 停止服务: Ctrl+C"
|
||||
echo
|
||||
|
||||
if [ "${NO_OPEN:-0}" != "1" ]; then
|
||||
( sleep 3; open "$URL" >/dev/null 2>&1 || true ) &
|
||||
fi
|
||||
|
||||
exec "$PY" -m uvicorn app.main:app --host 127.0.0.1 --port "$PORT" ${RELOAD_ARGS[@]+"${RELOAD_ARGS[@]}"}
|
||||
|
|
@ -1,36 +0,0 @@
|
|||
# scripts/ 目录说明
|
||||
|
||||
运维 / 启动脚本统一收在这里。所有脚本都自带 `cd 项目根目录`,在哪个目录执行都可以。
|
||||
|
||||
## 启动与部署
|
||||
|
||||
| 文件 | 用途 |
|
||||
|---|---|
|
||||
| `run.sh` | 本地启动。自动检查 Python 3.10+、创建 `.venv`、缺依赖自动 `pip install`(默认源失败会切国内镜像)、缺 `.env` 从 `.env.example` 生成、首次运行建库,然后起 uvicorn |
|
||||
| `deploy.sh` | Docker 部署。`up` / `update` / `restart` / `down` / `logs` / `status` / `backup` / `mirror`;缺 docker / compose 时按 `AUTO_INSTALL=1` 尝试安装并拉起守护进程 |
|
||||
|
||||
```bash
|
||||
./scripts/run.sh # 本地启动(默认热更新)
|
||||
PORT=8771 ./scripts/run.sh # 换端口
|
||||
AUTO_INSTALL=0 ./scripts/run.sh # 只检查环境,不自动安装
|
||||
|
||||
./scripts/deploy.sh up # Docker 构建 + 后台启动
|
||||
./scripts/deploy.sh logs # 跟踪日志
|
||||
```
|
||||
|
||||
## 数据导入(按需手动执行)
|
||||
|
||||
| 文件 | 用途 |
|
||||
|---|---|
|
||||
| `init_db.py` | 建表 + 预置分类(幂等,`run.sh` / 容器启动会自动调用) |
|
||||
| `import_excel.py` | 导入《软件开发部管理工作执行表.xlsx》 |
|
||||
| `import_staff.py` | 导入《软件开发部人员名单.xlsx》 |
|
||||
| `import_custom_ledger.py` | 导入《定开项目.xlsx》市场台账(`--dry-run` 预演) |
|
||||
|
||||
> 导入脚本不传路径时,默认读 `data/import/` 下的同名文件;
|
||||
> 也可以用 `XLSX` / `STAFF_XLSX` / `CUSTOM_LEDGER_XLSX` 环境变量或命令行参数指定。
|
||||
|
||||
## legacy/(历史一次性脚本)
|
||||
|
||||
旧数据修复 / 迁移脚本,**不参与启动流程**,也不需要放进 Docker 镜像。
|
||||
只有遇到对应的历史数据问题时才手动执行,详见 [`legacy/README.md`](legacy/README.md)。
|
||||
|
|
@ -13,19 +13,18 @@
|
|||
- Excel 里是平移前的年份,这里按 (月, 周) 匹配现有周期并取最早的一年,避免年份口径耦合。
|
||||
|
||||
用法:
|
||||
python scripts/legacy/add_entry_date.py --dry-run
|
||||
python scripts/legacy/add_entry_date.py
|
||||
python scripts/legacy/add_entry_date.py --force
|
||||
python scripts/add_entry_date.py --dry-run
|
||||
python scripts/add_entry_date.py
|
||||
python scripts/add_entry_date.py --force
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import os
|
||||
import sys
|
||||
from collections import defaultdict
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[2]))
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
|
||||
|
||||
import openpyxl # noqa: E402
|
||||
from sqlalchemy import inspect, text # noqa: E402
|
||||
|
|
@ -39,9 +38,7 @@ from app.models import ( # noqa: E402
|
|||
Period,
|
||||
)
|
||||
|
||||
DEFAULT_XLSX = os.environ.get("XLSX") or str(
|
||||
Path(__file__).resolve().parents[2] / "data" / "import" / "软件开发部管理工作执行表.xlsx"
|
||||
)
|
||||
DEFAULT_XLSX = "/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx"
|
||||
COLUMN = "entry_date"
|
||||
|
||||
|
||||
|
|
@ -1,359 +0,0 @@
|
|||
#!/usr/bin/env bash
|
||||
# 部门关键任务追踪看板 · Docker 部署脚本
|
||||
# 用法: ./scripts/deploy.sh up 构建镜像并后台启动(默认命令)
|
||||
# ./scripts/deploy.sh update 改完代码后重建镜像并替换容器
|
||||
# ./scripts/deploy.sh restart 重启容器(不换镜像)
|
||||
# ./scripts/deploy.sh down 停止并删除容器,数据留在 ./data
|
||||
# ./scripts/deploy.sh logs 跟踪日志(Ctrl+C 退出)
|
||||
# ./scripts/deploy.sh backup 导出数据库快照(部署到新机器时带走数据)
|
||||
# ./scripts/deploy.sh status 容器状态 + 健康检查 + 访问地址
|
||||
# ./scripts/deploy.sh mirror 重新探测可用的 pip 源(基础镜像只认本地已有的,不去试加速站)
|
||||
# 环境变量:CN_MIRROR=0 跳过加速探测;NO_BUILD=1 不构建、直接用本地镜像;
|
||||
# AUTO_INSTALL=0 缺 docker / compose 时不尝试自动安装,只打印安装命令
|
||||
set -euo pipefail
|
||||
|
||||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$ROOT"
|
||||
|
||||
CONTAINER=unis-board
|
||||
AUTO_INSTALL="${AUTO_INSTALL:-1}"
|
||||
|
||||
log() { printf '%s\n' "$*"; }
|
||||
warn() { printf '!! %s\n' "$*" >&2; }
|
||||
|
||||
run_root() {
|
||||
if [ "$(id -u)" = "0" ]; then
|
||||
"$@"
|
||||
elif command -v sudo >/dev/null 2>&1; then
|
||||
# 交互式终端允许 sudo 提示密码;非交互时不要卡住等密码
|
||||
if [ -t 0 ] || sudo -n true 2>/dev/null; then
|
||||
sudo "$@"
|
||||
else
|
||||
return 1
|
||||
fi
|
||||
else
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# 装 docker:优先系统包管理器,再退回官方安装脚本(仅 Linux;macOS 需 Docker Desktop)
|
||||
install_docker() {
|
||||
[ "$AUTO_INSTALL" = "1" ] || return 1
|
||||
[ "$(uname -s)" = "Linux" ] || return 1
|
||||
log "==> 未找到 docker,尝试自动安装"
|
||||
if command -v dnf >/dev/null 2>&1; then
|
||||
run_root dnf install -y docker docker-compose-plugin 2>/dev/null ||
|
||||
run_root dnf install -y docker docker-compose 2>/dev/null || true
|
||||
elif command -v yum >/dev/null 2>&1; then
|
||||
run_root yum install -y docker docker-compose-plugin 2>/dev/null ||
|
||||
run_root yum install -y docker docker-compose 2>/dev/null || true
|
||||
elif command -v apt-get >/dev/null 2>&1; then
|
||||
run_root apt-get update 2>/dev/null || true
|
||||
run_root apt-get install -y docker.io docker-compose-plugin 2>/dev/null ||
|
||||
run_root apt-get install -y docker.io docker-compose 2>/dev/null || true
|
||||
elif command -v apk >/dev/null 2>&1; then
|
||||
run_root apk add --no-cache docker docker-cli-compose 2>/dev/null || true
|
||||
fi
|
||||
if ! command -v docker >/dev/null 2>&1 && command -v curl >/dev/null 2>&1; then
|
||||
log "==> 系统包管理器没装上,改用 Docker 官方脚本(get.docker.com)"
|
||||
curl -fsSL https://get.docker.com | run_root sh || true
|
||||
fi
|
||||
command -v docker >/dev/null 2>&1
|
||||
}
|
||||
|
||||
# 守护进程没起来时尝试拉起(Linux systemd / macOS Docker Desktop)
|
||||
start_docker_daemon() {
|
||||
if command -v systemctl >/dev/null 2>&1; then
|
||||
log "==> 尝试启动 docker 服务"
|
||||
run_root systemctl enable --now docker 2>/dev/null || run_root systemctl start docker 2>/dev/null || true
|
||||
elif [ "$(uname -s)" = "Darwin" ] && [ -d "/Applications/Docker.app" ]; then
|
||||
log "==> 尝试启动 Docker Desktop"
|
||||
open -a Docker >/dev/null 2>&1 || true
|
||||
fi
|
||||
local i
|
||||
for i in $(seq 1 30); do
|
||||
docker info >/dev/null 2>&1 && return 0
|
||||
sleep 2
|
||||
done
|
||||
return 1
|
||||
}
|
||||
|
||||
# 装 compose 插件(docker compose / 独立 docker-compose 二选一)
|
||||
install_compose() {
|
||||
[ "$AUTO_INSTALL" = "1" ] || return 1
|
||||
[ "$(uname -s)" = "Linux" ] || return 1
|
||||
log "==> 未找到 docker compose,尝试自动安装"
|
||||
if command -v dnf >/dev/null 2>&1; then
|
||||
run_root dnf install -y docker-compose-plugin 2>/dev/null || run_root dnf install -y docker-compose 2>/dev/null || true
|
||||
elif command -v yum >/dev/null 2>&1; then
|
||||
run_root yum install -y docker-compose-plugin 2>/dev/null || run_root yum install -y docker-compose 2>/dev/null || true
|
||||
elif command -v apt-get >/dev/null 2>&1; then
|
||||
run_root apt-get install -y docker-compose-plugin 2>/dev/null || run_root apt-get install -y docker-compose 2>/dev/null || true
|
||||
elif command -v apk >/dev/null 2>&1; then
|
||||
run_root apk add --no-cache docker-cli-compose 2>/dev/null || true
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
# ---------- 0. 前置检查(缺什么补什么) ----------
|
||||
if ! command -v docker >/dev/null 2>&1; then
|
||||
if ! install_docker; then
|
||||
warn "没有 docker 命令。请先安装 Docker / Docker Desktop:
|
||||
macOS : 安装 Docker Desktop https://www.docker.com/products/docker-desktop/
|
||||
Ubuntu/Debian : sudo apt install -y docker.io docker-compose-plugin
|
||||
RHEL/openEuler : sudo dnf install -y docker docker-compose-plugin
|
||||
(脚本默认已尝试自动安装;设了 AUTO_INSTALL=0 时可去掉该变量重试)"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
if ! docker info >/dev/null 2>&1; then
|
||||
if ! start_docker_daemon; then
|
||||
warn "docker 守护进程没起来(Docker Desktop 是否没运行?)"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
if docker compose version >/dev/null 2>&1; then
|
||||
COMPOSE=(docker compose)
|
||||
elif command -v docker-compose >/dev/null 2>&1; then
|
||||
COMPOSE=(docker-compose)
|
||||
else
|
||||
install_compose
|
||||
if docker compose version >/dev/null 2>&1; then
|
||||
COMPOSE=(docker compose)
|
||||
elif command -v docker-compose >/dev/null 2>&1; then
|
||||
COMPOSE=(docker-compose)
|
||||
else
|
||||
warn "没找到 docker compose,也没找到 docker-compose。请安装 docker-compose-plugin 后重试。"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# 对外端口:命令行环境变量 > .env 里的 HOST_PORT > 8770
|
||||
if [ -z "${HOST_PORT:-}" ] && [ -f .env ]; then
|
||||
HOST_PORT="$(sed -n 's/^HOST_PORT=//p' .env | tail -1)"
|
||||
fi
|
||||
HOST_PORT="${HOST_PORT:-8770}"
|
||||
URL="http://127.0.0.1:${HOST_PORT}"
|
||||
|
||||
# ---------- 0.5 通用小工具(供后面读写 .env、探测、加超时用)----------
|
||||
env_get() { { [ -f .env ] && sed -n "s/^$1=//p" .env | tail -1; } || true; }
|
||||
|
||||
# with_timeout 秒 命令…(macOS 没有 timeout 命令,自己搭一个,防止探测卡死)
|
||||
with_timeout() {
|
||||
local t="$1" rc=0; shift
|
||||
# 整个动作丢进子 shell 并把它的 stderr 关掉:否则后台任务被 kill 时
|
||||
# bash 会往终端插一行「已终止」,看着像脚本自己挂了。
|
||||
( "$@" >/dev/null 2>&1 &
|
||||
pid=$!
|
||||
( sleep "$t"; kill "$pid" 2>/dev/null ) >/dev/null 2>&1 &
|
||||
wpid=$!
|
||||
wait "$pid" || rc=$?
|
||||
kill "$wpid" 2>/dev/null || true
|
||||
wait "$wpid" 2>/dev/null || true
|
||||
exit "$rc" ) 2>/dev/null
|
||||
}
|
||||
|
||||
# ---------- 1. 国内加速:基础镜像 + pip 源 ----------
|
||||
# 国内直连 docker.io / pypi.org 会 TLS 超时(报错形如 failed to resolve source
|
||||
# metadata for docker.io/library/python),所以构建前先把「真能拉到东西的源」探出来,
|
||||
# 并写回 .env —— 之后裸跑 docker compose up -d --build 用的也是同一套配置。
|
||||
|
||||
BASE_IMAGE="${BASE_IMAGE:-$(env_get BASE_IMAGE)}"
|
||||
BASE_IMAGE="${BASE_IMAGE:-python:3.12-slim}" # 本地有哪个 python 镜像就用哪个;内网自建仓库才需要在这里钉死
|
||||
PIP_URLS="${PIP_URLS:-https://pypi.tuna.tsinghua.edu.cn/simple https://mirrors.aliyun.com/pypi/simple https://mirrors.cloud.tencent.com/pypi/simple https://pypi.org/simple}"
|
||||
|
||||
configure_mirror() {
|
||||
local force="${1:-}" url tag
|
||||
PIP_INDEX_URL="${PIP_INDEX_URL:-$(env_get PIP_INDEX_URL)}"
|
||||
if [ "$force" = "--force" ]; then
|
||||
PIP_INDEX_URL=""
|
||||
# 手工钉死过的基础镜像不冲掉,只重探 pip 源
|
||||
# .env 里钉死过的基础镜像不冲掉,--force 只重探 pip 源
|
||||
if [ -z "$(env_get BASE_IMAGE)" ]; then BASE_IMAGE="python:3.12-slim"; fi
|
||||
fi
|
||||
BASE_IMAGE="${BASE_IMAGE:-python:3.12-slim}"
|
||||
|
||||
if [ "${CN_MIRROR:-1}" = "0" ] || [ "${NO_BUILD:-0}" = "1" ]; then
|
||||
export BASE_IMAGE PIP_INDEX_URL
|
||||
echo "==> 跳过源探测(CN_MIRROR=0 或 NO_BUILD=1):${BASE_IMAGE:-官方 python} / ${PIP_INDEX_URL:-官方 pypi}"
|
||||
return 0
|
||||
fi
|
||||
|
||||
# 基础镜像只用「本地有没有」做判据,不去逐个试加速站(试一圈要几分钟,而且多半全挂)。
|
||||
# 判据也不看宿主机 curl:宿主机走 HTTP_PROXY,守护进程和构建容器都不认 shell 的代理变量。
|
||||
tag="${BASE_IMAGE##*/}" # 纯 tag,例 python:3.12-slim
|
||||
if docker image inspect "$BASE_IMAGE" >/dev/null 2>&1; then
|
||||
echo "==> 基础镜像本地已有,不联网:$BASE_IMAGE"
|
||||
elif docker image inspect "$tag" >/dev/null 2>&1; then
|
||||
# 本地已有同名 tag 就直接用。镜像内容是同一份,仓库前缀只是「当初从哪儿拉的」,
|
||||
# 换台机器还抱着旧前缀去联网拉,反而会把一次本来能成的构建搞挂。
|
||||
echo "==> 本地已有 ${tag},直接用它(忽略 .env 里的仓库前缀)"
|
||||
BASE_IMAGE="$tag"
|
||||
elif with_timeout 25 docker pull --quiet "$BASE_IMAGE"; then
|
||||
echo "==> 基础镜像已从当前配置的源拉取:$BASE_IMAGE"
|
||||
else
|
||||
echo "!! 本地没有 ${BASE_IMAGE},25 秒内也没拉到;这一步过不去,构建必然失败,先解决基础镜像:" >&2
|
||||
echo " 1) 本地有别的 python 镜像 → 指定它:BASE_IMAGE=$(docker images --format '{{.Repository}}:{{.Tag}}' | grep -m1 python || echo python:3.12-slim) ./scripts/deploy.sh up" >&2
|
||||
echo " 2) 手工拉一次(守护进程配的 registry-mirrors 在这一步生效):docker pull $tag" >&2
|
||||
echo " 3) 机器不能上网 → 从别处拷:docker save -o py.tar $tag && scp py.tar 目标机 && docker load -i py.tar" >&2
|
||||
echo " 4) 已经构建过本项目镜像 → 跳过构建直接起:NO_BUILD=1 ./scripts/deploy.sh up" >&2
|
||||
return 1
|
||||
fi
|
||||
|
||||
# pip 源:装依赖是在构建容器里发生的,容器不继承宿主机的代理,
|
||||
# 所以拿刚定下的基础镜像(此时必然已在本地)真跑一次访问探测,比宿主机 curl 靠谱。
|
||||
if [ -n "${PIP_INDEX_URL:-}" ]; then
|
||||
echo "==> pip 源(沿用已有配置):$PIP_INDEX_URL"
|
||||
else
|
||||
for url in $PIP_URLS; do
|
||||
if with_timeout 40 docker run --rm --entrypoint python "$BASE_IMAGE" \
|
||||
-c "import sys,urllib.request;urllib.request.urlopen(sys.argv[1],timeout=8)" "$url/"; then
|
||||
PIP_INDEX_URL="$url"; break
|
||||
fi
|
||||
done
|
||||
if [ -z "${PIP_INDEX_URL:-}" ]; then
|
||||
PIP_INDEX_URL="https://pypi.org/simple"
|
||||
echo "!! 构建容器里访问不到任何国内 pip 源,先用官方源;超时就手工指定:" >&2
|
||||
echo " PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./scripts/deploy.sh up" >&2
|
||||
fi
|
||||
fi
|
||||
|
||||
# 只 export 给本次构建,故意不写回 .env —— .env 在 git 里,把这台机器探到的
|
||||
# 加速站带到另一台机器上,正是那边拉不到镜像的原因。
|
||||
# 想固定就在 .env 里手工写 BASE_IMAGE= / PIP_INDEX_URL= 两行(裸 compose 命令也吃这两个值)。
|
||||
export BASE_IMAGE PIP_INDEX_URL
|
||||
echo "==> 本次构建用:基础镜像 $BASE_IMAGE | pip 源 $PIP_INDEX_URL"
|
||||
}
|
||||
|
||||
# 构建失败时给一份可操作的排查清单(国内环境九成是源的问题)
|
||||
build_hint() {
|
||||
if [ -n "${HTTPS_PROXY:-}${HTTP_PROXY:-}${https_proxy:-}${http_proxy:-}" ]; then
|
||||
echo "!! 注意:当前 shell 配了 HTTP(S)_PROXY,但 Docker 守护进程不认 shell 环境变量。" >&2
|
||||
echo " 要用代理出网,得在 Docker Desktop → Settings → Resources → Proxies 里配" >&2
|
||||
echo " http://host.docker.internal:7897(端口换成你本机代理的),否则构建期出不了网。" >&2
|
||||
fi
|
||||
cat >&2 <<'HINT'
|
||||
!! 构建失败。国内环境最常见的两个原因:
|
||||
1) 基础镜像拉不到(failed to resolve source metadata / TLS handshake timeout)
|
||||
docker images | grep python # 看看本地有哪个可用
|
||||
BASE_IMAGE=python:3.12-slim ./scripts/deploy.sh up # 显式指定本地已有的镜像
|
||||
docker pull python:3.12-slim # 或手工拉一次
|
||||
也可以给 Docker 守护进程配 registry-mirrors(服务器改 /etc/docker/daemon.json,
|
||||
桌面端 Settings → Docker Engine),保存并重启 Docker 后再 ./scripts/deploy.sh up
|
||||
2) pip 装依赖超时
|
||||
PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./scripts/deploy.sh up
|
||||
完全不能上网的机器:在能上网的机器上构建后拷镜像过去
|
||||
docker save -o unis-board.tar unis-board:latest && scp unis-board.tar host:/srv/unis_manager/
|
||||
ssh host 'docker load -i /srv/unis_manager/unis-board.tar'
|
||||
然后在目标机 NO_BUILD=1 ./scripts/deploy.sh up
|
||||
HINT
|
||||
}
|
||||
|
||||
# ---------- 2. 准备 .env 与 data 目录 ----------
|
||||
prepare() {
|
||||
if [ ! -f .env ]; then
|
||||
cp .env.example .env
|
||||
echo "==> 已从 .env.example 生成 .env(AI Key、管理员账号密码请按需修改,改完 restart 生效)"
|
||||
fi
|
||||
# 先建好目录,免得 Docker 用 root 建出来盖掉宿主机权限
|
||||
mkdir -p data/uploads data/exports
|
||||
}
|
||||
|
||||
# ---------- 3. 等服务就绪 ----------
|
||||
wait_ready() {
|
||||
echo -n "==> 等待服务就绪 "
|
||||
for _ in $(seq 1 30); do
|
||||
state="$(docker inspect -f '{{if .State.Health}}{{.State.Health.Status}}{{else}}{{.State.Status}}{{end}}' "$CONTAINER" 2>/dev/null || echo missing)"
|
||||
case "$state" in
|
||||
healthy) echo; echo "==> 已就绪:$URL"; return 0 ;;
|
||||
unhealthy) echo; echo "!! 容器不健康,执行 ./scripts/deploy.sh logs 看原因" >&2; return 1 ;;
|
||||
esac
|
||||
echo -n "."
|
||||
sleep 2
|
||||
done
|
||||
echo; echo "!! 等待超时(当前状态:${state}),执行 ./scripts/deploy.sh logs 看原因" >&2
|
||||
return 1
|
||||
}
|
||||
|
||||
# ---------- 4. 构建并启动(NO_BUILD=1 时直接用本地镜像)----------
|
||||
up_or_exit() {
|
||||
if [ "${NO_BUILD:-0}" = "1" ]; then
|
||||
echo "==> NO_BUILD=1:跳过构建,直接用本地镜像 unis-board:latest"
|
||||
"${COMPOSE[@]}" up -d
|
||||
elif "${COMPOSE[@]}" up -d --build; then
|
||||
return 0
|
||||
else
|
||||
build_hint; return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------- 5. 分发命令 ----------
|
||||
case "${1:-up}" in
|
||||
up|start)
|
||||
first_run=0
|
||||
[ -f data/board.db ] || first_run=1
|
||||
prepare
|
||||
configure_mirror
|
||||
up_or_exit || exit 1
|
||||
wait_ready
|
||||
echo " API 文档:$URL/api/docs"
|
||||
if [ "$first_run" = "1" ]; then
|
||||
echo " 首次启动:管理员账号取自 .env 的 ADMIN_USERNAME/ADMIN_PASSWORD(默认 admin / admin123,请登录后立刻改密码)"
|
||||
fi
|
||||
;;
|
||||
update)
|
||||
prepare
|
||||
configure_mirror
|
||||
if [ "${NO_BUILD:-0}" = "1" ]; then "${COMPOSE[@]}" up -d --force-recreate
|
||||
else "${COMPOSE[@]}" up -d --build --force-recreate || { build_hint; exit 1; }
|
||||
fi
|
||||
wait_ready
|
||||
;;
|
||||
restart)
|
||||
"${COMPOSE[@]}" restart
|
||||
wait_ready
|
||||
;;
|
||||
down|stop)
|
||||
"${COMPOSE[@]}" down
|
||||
echo "==> 已停止(数据仍在 ./data,要备份请复制 data/board.db)"
|
||||
;;
|
||||
logs)
|
||||
exec "${COMPOSE[@]}" logs -f --tail=100
|
||||
;;
|
||||
backup)
|
||||
# 用 SQLite 备份 API 取一致性快照:服务正在写也不会拷到半截页
|
||||
[ -f data/board.db ] || { echo "!! 没找到 data/board.db(若已换 MySQL,请改用 mysqldump)" >&2; exit 1; }
|
||||
PYBIN="$(command -v python3 || command -v python || true)"
|
||||
[ -n "$PYBIN" ] || { echo "!! 备份需要 python3(只拷库,不用装项目依赖)" >&2; exit 1; }
|
||||
mkdir -p data/backups
|
||||
OUT="data/backups/board-$(date +%Y%m%d_%H%M%S).db"
|
||||
"$PYBIN" - "$OUT" <<'PYEOF'
|
||||
import os, sqlite3, sys
|
||||
src = sqlite3.connect("data/board.db")
|
||||
dst = sqlite3.connect(sys.argv[1])
|
||||
with dst:
|
||||
src.backup(dst)
|
||||
print(f"[ok] 已导出 {sys.argv[1]}({os.path.getsize(sys.argv[1]) // 1024} KB)")
|
||||
PYEOF
|
||||
echo "==> 部署到新机器:把这个文件放到目标机的 data/board.db,再执行 ./scripts/deploy.sh up"
|
||||
;;
|
||||
mirror)
|
||||
prepare
|
||||
configure_mirror --force
|
||||
echo "==> 想让以后的构建固定用这组源,把下面两行写进 .env 即可(不写也行):"
|
||||
echo " BASE_IMAGE=${BASE_IMAGE:-python:3.12-slim}"
|
||||
if [ -n "${PIP_INDEX_URL:-}" ]; then echo " PIP_INDEX_URL=$PIP_INDEX_URL"; fi
|
||||
;;
|
||||
status)
|
||||
"${COMPOSE[@]}" ps
|
||||
echo -n "==> /health:"
|
||||
curl -s --max-time 3 "$URL/health" 2>/dev/null || echo " 无响应(容器未启动?./scripts/deploy.sh up)"
|
||||
echo
|
||||
echo "==> 访问地址:$URL"
|
||||
;;
|
||||
*)
|
||||
sed -n '3,11p' "$0"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
|
|
@ -18,20 +18,19 @@
|
|||
|
||||
用法
|
||||
----
|
||||
python scripts/legacy/fix_period_split.py --dry-run # 预演
|
||||
python scripts/legacy/fix_period_split.py # 执行
|
||||
python scripts/fix_period_split.py --dry-run # 预演
|
||||
python scripts/fix_period_split.py # 执行
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import os
|
||||
import shutil
|
||||
import sys
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[2]
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
sys.path.insert(0, str(ROOT))
|
||||
|
||||
import openpyxl # noqa: E402
|
||||
|
|
@ -47,7 +46,7 @@ from app.models import ( # noqa: E402
|
|||
Update,
|
||||
)
|
||||
|
||||
XLSX = os.environ.get("XLSX") or str(ROOT / "data" / "import" / "软件开发部管理工作执行表.xlsx")
|
||||
XLSX = "/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx"
|
||||
|
||||
|
||||
# --------------------------------------------------------------------------- #
|
||||
|
|
@ -255,7 +254,7 @@ def main() -> None:
|
|||
t = db.query(Task).filter(
|
||||
Task.project_id == p.id, Task.name == task_name[:255]).one_or_none()
|
||||
if not t:
|
||||
t = Task(project_id=p.id, name=task_name[:255])
|
||||
t = Task(project_id=p.id, name=task_name[:255], sort_order=999)
|
||||
db.add(t)
|
||||
db.flush()
|
||||
db.add(Update(
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue