duxingchen/track
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
410 Commits 3 Branches 0 Tags
edd43fec292d23be72a4ae869dd63c7d43b72d79
Commit Graph

27 Commits

Author SHA1 Message Date
duxingchen
1fea30b03b feat(audit): 日活使用统计 + 双 CSV 导出（审计/上下线，列可自定义） 
【日活统计：GET /audit/daily-usage】
按【北京时间自然日 × 操作人】聚合，单个 GROUP BY 完成（count(*) FILTER），
不用窗口函数。指标：上线/下线时间、操作次数、登录/登出次数。

⚠️ 上线/下线时间取【当天首次/末次活动】，刻意不取登录时间：
   Refresh Token 有效期 7 天，用户不必每天重新登录。按登录算会出现
   「登录次数 0、上线时间空，但操作次数 35」——报表自相矛盾。
   时间一律按 +08:00 分日与渲染，否则早班（00:00~08:00）操作会掉到前一天。

【CSV 导出：两个端点 + 列自定义】
- /audit/logs/export        整体审计导出，筛选维度与列表页完全一致
- /audit/daily-usage/export 上下线导出，每人一行
- 列清单由后端统一维护并经 /audit/options 下发（log_export_columns /
  usage_export_columns），前端不硬编码表头，避免两端漂移
- ⚠️ 响应带 UTF-8 BOM：Excel 靠它识别编码，否则中文表头全乱码
- 单次上限 5 万行，超出经 X-Export-Truncated 头告知前端明确提示
  （静默截断比报错更危险）
- list_audit_logs 与 export_audit_logs 共用 _log_filters，
  保证「看到的」与「导出的」永远是同一批数据

【前端】
- 审计页页头新增「人员统计」「导出 CSV」两个按钮，现有表格与筛选零改动
- 人员统计走抽屉（AuditUsagePanel）：日期范围+快捷键、日活表格、
  上下线次数彩色标签、北京时间渲染、导出前弹列勾选面板
- ExportColumnsModal 为两处导出共用，默认全选
 2026-09-21 12:06:43 +08:00
openhands
7635802a42 feat(audit): 新增操作审计日志（表/中间件/查询接口）+ 角色常量收敛 
背景：系统此前没有操作审计。task_logs 的 task_id 是 NOT NULL 外键，只能挂在
任务上，且全项目仅 4 处写入点 —— 登录、导出、产品增删改、收编完全不留痕。
需求方整理的问题清单里「无审计日志查看页」正源于此：不是没有页面，是没数据。

设计参考 MOM(KCGL) 的 audit_logs / audit_listener，但按 Track 栈做了取舍：

1) 写入时机：MOM 用 SQLAlchemy event listener + 同事务写入，优点是零侵入，
   缺点是**业务回滚时审计一起消失**，而失败/被拒的操作（越权尝试、参数错误）
   恰恰最需要留痕。Track 改为响应生成后用**独立 session** 写入：
   - 业务回滚不影响审计（已验证 422/401 失败操作同样落库）
   - 审计写入失败也不影响业务（全包裹 try/except）
   - 代价：非原子提交，响应后进程立即被 kill 可能丢一条（已注释说明取舍）

2) 采集方式：中间件自动采集写操作 + 导出/下载/打印这类「读但敏感」的 GET。
   路径段推导 module/action/target_id。不做手写埋点，因为手写必然漏 ——
   task_logs 只有 4 处写入点就是前车之鉴。

3) 增量价值：新增 request_id 字段，与 core/logging.py 的结构化日志打通，
   凭一个 ID 就能从审计记录直接跳到那一次接口日志。MOM 无此字段。

4) 敏感信息：details 经 sanitize_details 递归剔除 password/token/secret 等键；
   中间件不读请求体，登录明文密码不会落库（已断言表内无密码痕迹）。

配套改动：
- core/roles.py：角色常量与 is_admin 收敛为单一事实来源。此前同一份
  「管理员角色」规则散在 task_service、products.py 内联判断和前端
  constants/task.ts 三处，已因此发生过「移动端漏判 SUPERVISOR 误挡主管」。
  task_service 改为从 core.roles 导入同名常量，保持既有引用可用。
- core/deps.py：抽出 require_roles/require_admin 可复用依赖，替代内联判断。
- main.py：500 响应显式补 X-Request-ID 头 —— 该响应由 ServerErrorMiddleware
  生成，位于 RequestContextMiddleware 外层，中间件没机会写头。
- auth.py：登录校验前把「尝试的账号」写入 request.state，使登录事件
  （含失败登录）可归属到人，可用于追踪暴力破解。

验证：本地起 PostgreSQL 17 + 迁移后跑端到端测试，32/32 通过
（TestClient 每个请求新建事件循环，与模块级 asyncpg 连接池冲突会报
 "got Future attached to a different loop"，故改用 httpx.AsyncClient +
 ASGITransport 单循环；生产 uvicorn 单循环无此问题）。
 2026-09-21 02:23:19 +00:00
duxingchen
d666bbd4ed feat: 直接完结通道与报表口径收口（后端） 
【直接完结：保留动作，剥离状态】
- transfer_task 权限硬拦截：仅 SUPER_ADMIN / SUPERVISOR。判据取签名保护的
  operator_role，刻意不用客户端可通过 ?operator_id= 伪造的 operator_id
- 直接完结【不再改写】overall_status —— 它只是任务闭环动作，不改变物理状态。
  已出库设备完结后依然是「已出库」，回归 WIP 矩阵的已出库列
- 物理终态保护：create_task / receive_task / transfer_task 三处写入点统一加
  _is_physical_terminal 守卫，禁止用任务名覆写 已入库/在库/已出库。
  历史缺陷：「发货测试」会把设备的「已出库」标识静默抹掉，跨报表口径随之打架

【位置与工序口径】
- _recalc_product_location：已出库且闲置 → 位置清空（货发走就离场）。
  只清「已出库」；已入库/在库的设备确实还在仓库里，位置必须保留
- MOM 出库回调同步清空 current_location_id
- 新增 ProductResponse.current_step：只认活跃主干任务，无活跃任务时返回
  宏观终态或空。不再让已 COMPLETED 的历史工序（扫码出库/测试…）冒充"当前工序"

【售后烙印去死锁】
- 拆分 OUTBOUND_QC_STEPS(发货测试) / AFTER_SALES_REPAIR_STEPS(售后维修)
- resolve_phase_for_step 与 _mark_after_sales_if_reactivated 双双改为仅
  「售后维修」触发 AFTER_SALES，解除「已出库 + 发货测试」被永久烙印的死锁
- PRODUCTION_OVERALL_STEPS 补入「发货测试」，使出厂质检在生产阶段合法
  （否则 _enforce_step_isolation 会把已出库设备的发货测试直接 400）

【游魂收口】
- get_wip_matrix / get_wip_matrix_detail 的 is_terminal 增加"名下再无任何活跃
  任务则视同终结态"，让被直接完结的生产设备接受时间筛选，不再恒挂在看板上
  冒充在制。两处必须一字不差同步，否则会出现"矩阵有数、下钻为空"
 2026-09-17 17:05:42 +08:00
duxingchen
1e6c006360 feat: MES/MOM 出入库状态解绑与直接完结通道（后端契约 + 移动端） 
- TaskTransferRequest 新增 finish_directly 开关：闭环当前任务但不产生任何下游任务，
  产品 overall_status 保持原样，工人无需再借道「入库(virtual_warehouse)」来关闭任务，
  从根源上避免产品被误标「待仓库收货」而卡住 MOM 对账
- 空 assignees 分支加防呆校验：想直接完结必须显式传 finish_directly=true，
  杜绝漏填导致「转交」静默退化成「直接完结」的丢件级隐患
- 直接完结跳过 _mark_after_sales_if_reactivated：不产生新任务即不构成「回流返厂」信号，
  否则已出库设备的正常收官会把产品误翻成售后机（该标志单向不可回退）
- 补齐直接完结的独立响应文案，不再拼出「已创建 0 个下一道工序任务「None」」
- 移动端转交弹窗改为「转交个人 / 入库 / 直接完结」三选一互斥
 2026-09-17 14:07:02 +08:00
duxingchen
71e660b428 feat: 驳回图片改为选填，驳回原因/转交备注落库留痕 
业务调整：车间驳回不必须拍照（编号错误、选错工序等场景无需照片举证）。

- schemas/task.py: TaskRejectRequest.images 由必填(min_length=1)改为
  default_factory=list，保留 max_length=9 与 URL 总长保护；reason 增加
  mode="before" 的 strip 校验器，堵住纯空格凑长度绕过 min_length 的口子
  （顺带保证落库的 reject_reason 不带首尾空白）
- task_service.py: 驳回时把原因+图片写入 TaskRecord 挂到被驳回任务下，
  修复前端时间线看不到驳回详情的问题；转交时把交接备注也挂一条记录到
  下家任务，补齐接手人的上下文视角
- task_service.py: create_task / receive_task 写入 overall_status 后调用
  sync_product_status 对齐 status 字段
 2026-09-15 10:57:35 +08:00
duxingchen
b40340ea55 feat: 产品接口暴露lifecycle_phase并做阶段感知状态校验 2026-09-14 14:49:34 +08:00
duxingchen
b09187ac6e feat(backend): 生产总天数返回自然天+工作日两个口径 
- ProductResponse 加 production_days(自然天)/production_days_workdays(工作日)
- get_all_products 计算：自然天自创建至今，工作日用 working_duration_hours 排除周末/节假日
- FlowDevice 加 total_days/total_workdays(设备生产总天数，自最早介入至今)
 2026-08-28 15:28:56 +08:00
duxingchen
90d615cbb0 feat(backend): 产品列表返回当前人滞留时长 active_duration_hours 
- ProductResponse 增加 active_duration_hours(小时) 字段
- get_all_products 批量计算每个产品活跃任务(WIP/PENDING)最早接手时间到现在的时长
- 复用 get_people_workload 相同的北京时间口径，前端无需额外请求
 2026-08-28 10:46:10 +08:00
duxingchen
e5829c7d06 fix(backend): 修复并发任务聚合——当前位置汇总全部负责人、最新动态携带操作人、状态聚合补齐 REJECTED 2026-08-13 11:17:10 +08:00
duxingchen
b8ade13b61 fix: TaskRecordResponse改用field_validator — 不再污染ORM对象导致图片列表写回VARCHAR报错 
根因: model_validate直接obj.images=json.loads()把ORM对象的字符串改成列表
     SQLAlchemy autoflush时把列表写回VARCHAR列 → DataError
修复: field_validator(mode=before)在序列化层转换, 不修改ORM源对象
 2026-08-13 09:03:17 +08:00
duxingchen
d8d42e9613 feat: 上游显示真实发送人 — 从task_logs追溯created_by 2026-08-12 17:52:35 +08:00
duxingchen
e511952ea0 feat: 最新动态列支持图片展示 — 纯文字/纯图片/图文混合三种模式 
后端: ProductResponse 新增 latest_record_has_images
前端: 📷图标 + 纯图片时显示"图片记录" + Tooltip标注[含图片]
 2026-08-12 16:01:24 +08:00
duxingchen
163d9c20bb feat: 任务全景表格新增"最新动态"列 
后端:
  - ProductResponse 新增 latest_record_time/content 字段
  - get_all_products 批量查询活跃任务(WIP/PENDING)的最新 task_records
  - 使用窗口函数 ROW_NUMBER() PARTITION BY product_id

前端:
  - AdminTasksPage: grid-cols-12→grid-cols-[14]
  - 表头+数据行新增"最新动态"列
  - Tooltip悬浮显示完整内容, 截断+灰字二级排版
 2026-08-12 15:43:33 +08:00
duxingchen
40a2d87345 fix: 消息通知页不能点进详情 — 补全 product_serial_number 
问题: 点击通知卡片跳转 detail?taskId=xxx，但 detail.vue onLoad 只认 serial 参数导致空白页

修复:
1. 后端 NotificationResponse 新增 product_serial_number 字段
2. 后端 notifications API 联表 tasks+products 批量填充 serial
3. 前端 notify/index.vue handleCardTap 优先用 product_serial_number 跳转，兜底从 content 正则解析
4. 前端 detail.vue onLoad 新增 taskId 兜底 → doQueryByTask 反查 product_sn
 2026-08-11 15:56:25 +08:00
duxingchen
b43bded0ef feat: 宏观状态动态从主干任务获取+任务树assignee中文姓名映射(后端+前端) 2026-08-10 11:25:44 +08:00
duxingchen
45b5376537 fix: 三致命Bug—macro_status预计算+排除已完工脏读+flush落盘+递归深度限制10 2026-08-09 18:23:55 +08:00
duxingchen
bc43b5a732 feat: 产品管理 — 当前位置显示真实姓名 + 编辑弹窗 + 删除确认 2026-08-07 15:38:01 +08:00
duxingchen
bff8787e62 feat: OTA热更新 — 版本检测API + App端WGT下载安装 + app_versions表 2026-08-07 11:49:59 +08:00
duxingchen
b71c5a2d07 feat: 双Token认证(Access 2h/Refresh 7d) + 通知系统(转交/驳回自动推送) 2026-08-07 11:44:04 +08:00
duxingchen
0d323e8181 血缘锚定法: task_type字段+迁移+三大接口写入+TreeCanvas基于task_type布局 2026-08-06 13:03:25 +08:00
duxingchen
7810097b39 全栈修复: remark字段全链路打通 — TaskCreate+TransferRequest+transfer_task+前端Payload 2026-08-05 15:59:20 +08:00
duxingchen
f736cf0c13 修复: TaskResponse补remark字段 + 记录按时间降序取最新一条(latestRecord) 2026-08-05 15:37:10 +08:00
duxingchen
22f7bb2f79 全栈: Task模型+remark字段 + 前端任务卡片初始说明展示区 2026-08-05 15:22:50 +08:00
duxingchen
f9e10a7dd1 feat(schemas): 扩充 Task/Product Pydantic Schema 
Task Schema:
- TaskResponse 新增 is_rework, reject_reason, received_at, completed_at, records, product_sn
- 新增 TaskRejectRequest, TaskTransferRequest, TaskRecordCreate, TaskRecordResponse
- TaskRecordResponse 含 json.loads 反序列化 images

Product Schema:
- ProductResponse/ProductScanResponse 新增 external_serial, current_location_id, overall_status
- ProductScanResponse 新增 task_tree (递归任务树)
- ProductCreate 改为 material_id/material_name/spec_model + external_serial + order_no 自由文本
- ProductUpdate 新增 order_no
 2026-08-05 14:00:32 +08:00
duxingchen
b22de514a1 feat: 实现后端核心业务逻辑 (Auth鉴权、二维码服务、看板与产品端点) 2026-08-04 17:09:47 +08:00
duxingchen
cb97d390ad feat(schemas): 更新 Pydantic Schema，新增请求/响应模型 
Task Schema 更新:
- TaskResponse/TaskSummaryResponse 新增 is_rework, reject_reason, received_at, completed_at 字段
- 新增 TaskRejectRequest (品质驳回请求, reason 必填)
- 新增 TaskTransferRequest (裂变转交请求, next_assignees + next_task_name 必填)
- 新增 TaskTransferResponse (裂变转交响应)
- TaskCreate 新增 is_rework 字段

Product Schema 更新:
- ProductResponse/ProductScanResponse 新增 current_location_id 字段
- ProductScanResponse 新增 task_tree 字段 (递归任务树，供十字矩阵树状图)
 2026-08-04 17:03:29 +08:00
duxingchen
17105dc9c2 初始提交：项目基础结构 
- backend: FastAPI 后端服务 (Python)
- frontend: React + Tauri 前端应用
- docker-compose.yml: 容器编排配置
 2026-08-04 10:05:59 +08:00