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

157 Commits

Author SHA1 Message Date
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
openhands
04eb87b091 fix: 访问日志的 user 字段恒为 null —— 改用 request.state 跨 task 传递 
上一提交(4454047)的 RequestContextMiddleware 通过 contextvar 读取 user，
但 Starlette 的 BaseHTTPMiddleware 用 anyio start_soon 把下游放进新 task
执行，而 asyncio 每个 Task 创建时会复制 context —— 路由内 set 的
contextvar 不会回流到中间件，导致访问日志的 user 永远是 null。

修复：
- get_current_user 同时写 contextvar（供请求任务内业务日志用）与
  request.state（由 ASGI scope 承载，跨 task 可见），并带上
  display_name / role 备用。
- 中间件 _log_access 改为优先读 request.state.audit_user。

验证（TestClient + 解析最终 JSON 输出，而非读 record 属性）：
- track.access 日志 user=zhangsan01（经 request.state）
- 请求任务内 track.service 日志 user=zhangsan01（经 contextvar）
- 两者 request_id 一致；X-Request-ID 透传正常
 2026-09-21 02:11:41 +00:00
openhands
4454047ce3 fix: 修复任务分页总数错误 + 补齐可观测性基建 
分页总数（#5）：
- get_all_tasks 的 total 原为 len(flat_tasks)（当前页条数），移动端
  「我的任务」用 tasks.length < total 判断 hasMore，首页满员时恒为
  false，列表永远停在第一页 20 条。改为独立 COUNT 查询（与
  notifications.py 已有写法保持一致）。

可观测性（#9）：
- 新增 core/logging.py：单行 JSON 结构化日志 + request_id/user 上下文
  注入；零第三方依赖；接管 uvicorn 自带 handler 避免格式绕过。
- 新增 core/middleware.py：RequestContextMiddleware 生成/透传
  X-Request-ID 并回写响应头，输出含耗时/用户的结构化访问日志。
- 新增 core/health.py：拆分存活/就绪探针。/health/live 不触依赖；
  /health/ready 探主库，不可用返回 503；MOM 挂掉仅降级不摘流量。
- main.py：全局异常处理器只把堆栈写日志，响应体仅回 request_id；
  接入可选 Sentry（未装 SDK 时静默跳过）。
- auth_service：解析 Token 后写入 user 上下文，日志自动带操作人。

注：异常处理器由 ServerErrorMiddleware 调用，此时 contextvar 已被重置，
故 request_id 同时写入 request.state（由 ASGI scope 承载）再读取。

已用 TestClient 验证：探针状态码/检查项、X-Request-ID 透传与生成、
500 响应携带可对账的 request_id 且不泄露堆栈。
 2026-09-21 01:57:20 +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
dcc92b223e feat: 生产看板多维度重构（全量在制品、时间维度联动、口径提示） 
本次只含后端看板接口与 PC 端页面。移动端的体验优化已在之前的 12 个提交中
入库，不在本提交范围内。

后端 · 服务层 dashboard_service.py
- 在制品列表不再按 20 条静默截断：此前 `.limit(limit*2)` 预取再排序切片，
  前端又拿数组长度当总数，表现为「卡片 23、列表却写共 20 个」的数据被吞。
  现默认返回全量，limit 降级为防御性上限
- 产品流转「已完结」接入右上角时间筛选（since/until），废弃硬编码「本月」。
  此前选「今天」也会看到整月产出，业务语义分裂；待流转/流转中仍为实时快照。
  Product 表无 completed_at，以名下工序的完成时间锚定「完结时刻」
- 返工任务可见性：未完结卡点永远展示，已了结的仅限本月，且与卡片数字共用
  同一份条件，避免「按钮显示 2、点开共 0 条」
- 驳回明细的「返工给」改为真实溯源：直接查派生出的返工任务当前 assignee_id，
  不再复刻 reject_task 的推算逻辑（返工任务事后被转交时会显示旧名字）

后端 · 接口层 dashboard.py
- /wip-tasks 的 limit 默认 20→500、上限 100→1000
- /my-stats 支持 since/until，新增接收/转交/上传备注口径（与 PC 人员操作统计
  逐字段交叉验证一致）

PC 端
- AdminDashboard: 在制品计数绑定真实总数并加截断提示、列表改为容器内滚动；
  驳回明细只展示「已驳回」行（返工行不再独立成行，其信息已由「返工给」承载）；
  「待流转」「待接收」图例新增口径 Tooltip，消除「产品数 > 任务数」的误解；
  移除已失真的时间筛选提示条
- App.tsx: dayjs 中文 locale 上提到应用根。此前散落在 AdminPeoplePage /
  AnalyticsDashboard 两个页面里，而路由是 lazy 分割的 —— 直接打开概览页时
  那两个模块未加载，日期面板就露出 Sep/Su/Mo
- AdminPeoplePage / AnalyticsDashboard: 移除重复的页面级 locale 设置
- dashboardApi.ts: fetchWipTasks 默认值同步为 500
 2026-09-16 14:29:56 +08:00
duxingchen
44ca09ae22 feat: 新增个人效能统计接口 /dashboard/my-stats（支持自选时段） 
移动端「个人中心 → 工作统计」的数据源。现有接口拿不到这份数据：
/dashboard/people-history 支持 assignee_id 但只返回 WIP/PENDING/COMPLETED，
不含 REJECTED；/dashboard/rejected-tasks 则根本没有 assignee_id 参数 ——
「今日被驳回数」按现有接口无论如何都过滤不到个人。故补一个薄桥接端点。

服务端 get_my_stats(db, assignee_id, since, until) 返回两组指标：

生产战绩（按 Task.assignee_id 归因）
- tasks_completed / tasks_rejected：status 判定 + completed_at 落在区间，
  与 get_dashboard_stats 的 t_done_q 同一口径，只多了 assignee_id 过滤
- products_touched：按 product_id 去重，同一台设备做多道工序只算一台

操作统计（与 PC /dashboard/user-operations 严格同口径）
- receive/transfer：task_logs 的 receive / complete，按 operator_id 归因
- record：task_records 按 Task.assignee_id 归因，排除 '[' 开头的系统自动备注
- 前两项归因 operator_id、第三项归因 assignee_id 是 PC 端既有口径，
  此处刻意保持一致，便于工人自查的数与主管看到的面板对得上

端点侧新增 _parse_bound()：裸时间字符串（无时区偏移）按北京时间解释，
否则会被当作服务器本地时间，边界整体偏 8 小时，出现「选了今日却统计到
昨天下午」。since/until 缺省为「本月 1 日 ~ 此刻」。
 2026-09-15 15:51:34 +08:00
duxingchen
0d1e45e3fb feat: 管理层数据大屏（后端聚合接口 + 前端全屏页面） 
PC 管理端新增独立全屏数据大屏，供管理层查看直通率/产量趋势/不良分布，
替代原 AdminDashboard 上零散的手工下钻。

后端：
- endpoints/screen.py + services/screen_service.py: 大屏聚合接口
  （复用 lifecycle 的售后工序归一，保证统计口径与展示一致）
- router.py: 注册 screen_router

前端：
- pages/admin/ScreenDashboard.tsx: 全屏大屏页（自带鉴权守卫，无侧边栏）
- services/screenApi.ts: 大屏数据接口封装
- components/admin/UserOperationDetailDrawer.tsx: 人员操作明细抽屉，
  由 AdminDashboard 的原生 state 抽成独立组件（含命令式 handle）
- AdminDashboard.tsx: 改为使用该抽屉组件，移除内联的下钻状态
- MatrixBoard.tsx / App.tsx / AdminLayout.tsx: 挂载路由与导航入口
- BaseEChart.tsx: 注册 GaugeChart 与 GraphicComponent
  （graphic 需显式注册，否则饼图中心文字静默不渲染）
 2026-09-15 10:57:46 +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
f22eae315f fix: 售后回流口径统一 — 状态双字段同步、工序名归一、标签配色 
产品存在 overall_status 与 status 两个状态字段，此前各写入点各写一份映射、
甚至只改 overall_status 不改 status，导致回流设备（product.status 停留在
OUTBOUND）污染看板统计口径。

- lifecycle.py: 把映射表收敛为单一来源 overall_to_product_status /
  sync_product_status；新增 normalize_after_sales_step，将售后设备沿用生产
  阶段写法的历史工序名（测试/维修）折算到售后区独立工序名
- product_service.py: 删除本地 _OVERALL_TO_STATUS 副本，改用共享函数
- dashboard_service.py: WIP 矩阵补出 lifecycle_phase 列，活跃任务判定
  (is_active) 提前到所有终结态判定之前，避免残留 OUTBOUND 被误判为完结
- scripts/fix_product_status.py: 历史数据修复脚本（一次性）
- constants/task.ts: 售后工序标签由红色改紫色 —— 红色在本系统是「驳回/危险」
  语义色，售后只是另一条流转支线，用红色会让操作员误以为设备报错
 2026-09-15 10:57:29 +08:00
duxingchen
2de95799c6 feat: 售后回流判定与工序选项隔离守卫(建单/接收/转交) 2026-09-14 14:49:34 +08:00
duxingchen
b40340ea55 feat: 产品接口暴露lifecycle_phase并做阶段感知状态校验 2026-09-14 14:49:34 +08:00
duxingchen
b9f9b897a1 feat: 新增产品生命周期阶段字段lifecycle_phase与售后工序词表 2026-09-14 14:49:34 +08:00
duxingchen
3568d17865 fix: 转交时动态推导task_type,避免协助分支转交被误升为主线 2026-09-14 14:49:26 +08:00
duxingchen
7b7dbbb0d8 fix: WIP矩阵-左外连接纳入无任务新品归待接收,PENDING并入待接收,空负责人显式计数为未分配; 表头去待确认列并做TOP N折叠 2026-09-09 17:29:36 +08:00
duxingchen
d757c7985b fix: WIP矩阵口径重构-在制无条件计入,终结态按完工时间锚点(completed_at兜底created_at)过滤,多维终结归类(含扫码入库/出库节点),下钻同步 2026-09-07 14:46:58 +08:00
duxingchen
70c8357bc0 feat: 后端新增产品收口接口(已入库/已出库,管理员,含扫码节点与操作日志,可反向纠错与强收口) 2026-09-07 13:43:06 +08:00
duxingchen
109f45f22a feat: 产品/任务搜索支持业务序列号(external_serial)检索 2026-09-07 11:08:49 +08:00
duxingchen
cd5a904a16 fix: 效能分析flow时间筛选改为设备级(该时间有活动即入选),任务完整返回不切片 2026-09-03 16:27:04 +08:00
duxingchen
2d8c937189 feat: 效能分析flow区间携带自然/工作日双时长并支持时间过滤 2026-09-02 10:38:53 +08:00
duxingchen
3019653dfa refactor: 宏观状态统一(待仓库收货/已入库)废弃"在库"; WIP矩阵返回product_name并新增下钻明细 2026-09-02 10:38:49 +08:00
duxingchen
e194b97649 fix: 全状态对齐 - 已出库(OUTBOUND)覆盖所有看板 
- 看板产品流转 finished_cond 加'已出库',已出库归入已完结
- WIP 矩阵区分'已出库'维度
- MyTasksPage tab 加'已出库'
- 移动端 detail/WorkspaceArea STATUS_MAP 补 OUTBOUND
 2026-09-02 09:07:37 +08:00
duxingchen
262e28b9f2 fix: 仓储任务节点修复(assignee=None + WAREHOUSE 类型) + 前端防御性渲染 
- webhook 生成任务 assignee_id 置 None,不再填中文,避免前端解析报错跳过渲染
- task_type=WAREHOUSE,并同步 isMain 判断(后端+双端前端)使其画在中央主干道
- 前端对扫码入库/出库任务:不请求用户数据,直接显示 📦 + 'MOM 仓储系统'
 2026-09-01 17:25:22 +08:00
duxingchen
5407e2135f feat: Webhook 入库/出库后动态生成扫码任务节点与操作日志 
- mom-inbound/mom-outbound 在标记已入库/已出库后,追加'扫码入库/扫码出库'主线任务
- 新任务 parent_task_id 取最后一个主线任务,task_type=TRANSFER 保证画在主干道
- 生成 TaskRecord 操作日志,前端流转树最底部长出节点
- 幂等:已存在同名任务则不重复插入
 2026-09-01 16:55:13 +08:00
duxingchen
2b889b99d6 fix: webhook 匹配支持 external_serial 外部业务序列号 
- mom-inbound/mom-outbound 用 or_ 双字段联合匹配 serial_number 与 external_serial
- MOM 推送 ceshi123 等自定义序列号时也能精准认领产品并闭环状态
 2026-09-01 15:25:42 +08:00
duxingchen
73faa1fd93 feat: Track 打通已完成/已入库/已出库状态闭环与外部联动 
- 完工转交入库同步 status=COMPLETED;MOM 入库/出库回调同步 status
- 新增 mom-outbound webhook(发货出库标记已出库),lookup 返回 material_id
- VALID_OVERALL_STATUS 新增已出库;update_overall_status 同步 status 字段
- WIP 矩阵区分已入库/待仓库收货;虚拟节点正确处理已出库/转入在库人
 2026-09-01 13:53:24 +08:00
duxingchen
7f5bedf87c fix(流转树): 在库设备无在库任务时追加虚拟在库节点 
- 设备在库(virtual_warehouse)但无在库任务时，流转树追加虚拟「在库」节点
- 转入人用最后一道主工序负责人兜底(近似)，显示在库归属
- 递归检查任务树避免重复追加(在库任务可能是子任务)
 2026-08-31 17:38:38 +08:00
duxingchen
39019f4312 fix(流转树): 在库任务无创建日志时兜底显示转入人 
- 有 create 日志的在库任务用真实转入人(张欣欣/孔贺等)
- 无日志的历史在库任务，用该产品在库前最近一道主工序的负责人兜底
- 解决『流转树到负责人就结束、不显示谁入库』的问题
 2026-08-31 17:26:57 +08:00
duxingchen
0fc061728c fix(透视表): 在库按设备实际位置判断，修复数量不匹配 
- 之前按最新主任务 task_name='在库' 判断，漏掉实际在库但无在库任务的历史设备
- 改为 current_location_id='virtual_warehouse' → 在库(生产完成)
- 其他设备按最新主任务工序归属(活跃/完成态都归该工序)
- 在库数量与实际在库设备一致
 2026-08-31 17:24:38 +08:00
duxingchen
0dea116faa feat(backend): 流转树 created_by 加入中文名映射 
- get_product_by_serial 把任务创建人(created_by)纳入 assignee_names 中文名映射
- 前端可显示『谁转入在库』等创建人信息
 2026-08-31 17:20:41 +08:00
duxingchen
c3e03bb177 fix(透视表): 不再把任意已完成工序强制归在库 
- 设备当前工序 = 最新主任务的工序名(task_name)，不区分状态
- 「在库」只在该设备最新主任务真为在库工序时出现
- 完成的测试/生产等工序按原工序显示，不再误归在库
 2026-08-28 16:57:02 +08:00
duxingchen
b57ae19b44 fix(透视表): 每台设备只按当前工序统计一次，修复待确认重复计数 
- 取每台设备最新主任务作为当前状态
- 活跃任务(WIP/PENDING)→归属对应工序(待确认=转交未接收)
- 完成态任务→归属「在库」(生产完成)
- 上一步已完成+下一步待确认时只算一次，不再重复
- 时间筛选按设备最新主任务创建时间
 2026-08-28 16:54:43 +08:00
duxingchen
0dcdb5dad7 fix(透视表): WIP 分布矩阵只统计主分支 
- get_wip_matrix 过滤 parent_task_id IS NULL 或 TRANSFER/RECOVERY 的主线任务
- 排除 SPAWN 协助分支与返工任务，避免同一设备/工序重复计数
 2026-08-28 16:51:46 +08:00
duxingchen
41dd257260 feat(透视表): 工序分布包含在库/完成 + 增加时间筛选 
- wip-matrix 去掉状态过滤，全量分布，工序包含「在库」(生产完成)
- 后端加 since/until 按任务接手/创建时间过滤
- 前端 MatrixBoard 加 RangePicker 日期筛选 + 全部清除
 2026-08-28 16:32:01 +08:00
duxingchen
7547a886cc feat(backend): 新增 /dashboard/wip-matrix 在制品交叉聚合接口 
- 规格型号×人员/工序 的设备数量聚合(WIP/PENDING任务)
- dimension 参数: assignee(中文姓名)/task_name(工序名)
- 返回扁平数组含 count + assignees(该交叉点主负责人列表)
 2026-08-28 16:25:20 +08:00
duxingchen
907473b18c feat(效能分析): 人员视图也支持自然天/工作日耗时切换 
- capability 接口加 mode 参数，natural 用自然小时、workdays 用工作小时
- 人员视图柱状图随顶部按钮切换，排除休息日的耗时
- 切换按钮自动重新请求 capability 与 flow
 2026-08-28 15:38:32 +08:00
duxingchen
4447a1f52d feat(效能分析): 轨迹流转图时间轴支持工作日/自然天切换 
- flow 接口加 mode 参数，workdays 模式把时间偏移换算为排除周末/节假日的工作小时
- 轨迹流转图的横轴随顶部按钮(自然天/工作日)切换，休息日被压缩
- 按钮切换自动重新请求 flow
 2026-08-28 15:34:17 +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
451e24c34c fix(workload): get_people_workload 内嵌 _to_bj 改用 to_beijing，修复 BEIJING_TZ 未定义 
- 移除 import 后内嵌 _to_bj 仍引用 BEIJING_TZ 导致 NameError
 2026-08-28 15:13:18 +08:00
duxingchen
bad0941d67 fix(时长): 所有时长计算排除非工作日 + 修复两处时区多算8小时 
- get_wip_tasks/get_people_workload/get_people_history/product active_duration_hours/analytics 均改用 working_duration_hours
- 修复 get_wip_tasks 与 active_duration_hours 的 naive 时间误标北京时间 bug(DB实存UTC，原多算8小时)
- 每处读取 holidays 表排除配置的放假日期
 2026-08-28 15:08:10 +08:00
duxingchen
ad4b55dece feat(工作日): 新增工作小时计算工具 + 节假日表与管理接口 
- time_utils 新增 to_beijing(统一naive按UTC转北京时间) + working_duration_hours(排除周末/节假日)
- Holiday 模型 + alembic 迁移建 holidays 表
- GET/POST/DELETE /holidays 节假日管理接口，可随时配置放假日期
 2026-08-28 15:08:05 +08:00
duxingchen
7205de369a feat(backend): 新增 /dashboard/user-operations/detail 操作明细下钻接口 
- 按人+操作类型(receive/transfer/record)查询明细：任务/产品/备注/时间
- record 明细与该人统计口径一致(名下任务手动备注，排除系统自动)
 2026-08-28 13:36:23 +08:00
duxingchen
477a187fc1 fix(操作统计): 上传备注改为按任务负责人归因，历史数据可回溯 
- 备注统计不用 task_logs(历史无record日志)，改为 task_records 按任务 assignee 归因
- 排除系统自动生成的备注(以'['开头的接收/转交/撤回等)，只计手动上传
- 移除 add_task_record 冗余的 record 日志(不再用于统计)
- 不改数据库，历史182条备注也能正确归属到人
 2026-08-28 13:26:26 +08:00
duxingchen
41c19242cf fix(操作统计): 返回全部人员而非仅有操作的人 
- get_user_operations 先取全部 IRIS 人员清单，再合并各自操作次数
- 无操作的显示 0，避免只看得到当前有操作记录的人(如只看自己)
 2026-08-28 13:22:56 +08:00
duxingchen
b85188e625 feat(backend): 新增 /dashboard/user-operations 人员操作统计接口 
- add_task_record 补 action_type=record 日志，使上传备注可统计到人
- get_user_operations 按人聚合 接收(receive)/转交(complete)/上传备注(record) 次数，时间筛选，中文名映射
- 复用 get_display_names，不新增数据库字段
 2026-08-28 13:14:09 +08:00
duxingchen
90f5718e68 fix(驳回/返工): 抽屉与卡片数字口径一致，同时展示已驳回+返工任务 
- 根因：卡片数字含返工任务(tasks_rework 实时快照)，但抽屉只列已驳回 → 点开为空
- get_rejected_tasks 扩展返回两类(kind=rejected 按时间过滤 / kind=rework 实时不过滤)
- 前端抽屉按「已驳回」「返工任务」分组展示，数字与明细一一对应
 2026-08-28 11:33:54 +08:00
duxingchen
7e00683a21 feat(backend): 新增 /dashboard/rejected-tasks 驳回/返工下钻接口 
- RejectedTask schema: 设备/工序/驳回人/返工负责人/原因/时间
- get_rejected_tasks 批量窗口取驳回人(reject log) + 复刻 reject_task 的返工负责人追溯逻辑(create log→父任务→自身)
- 复用 get_display_names 中文名映射、BEIJING_TZ 时间转换
 2026-08-28 11:18:58 +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
1e374e76bf feat(analytics): CapabilityDevice 增加 material_name（X 轴展示物料名） 
- 后端 CapabilityDevice 新增 material_name，get_capability_profile 查询并填充
- 前端类型同步 material_name
 2026-08-14 15:43:22 +08:00
duxingchen
807df56c3a feat(analytics): 规格型号带物料名 + 设备字典（/options 数据契约扩展） 
- 后端新增 SpecModelOption/DeviceOption schema
- get_analytics_options 返回规格型号的物料名（同型号取首个非空名）+ 关联设备列表
- 前端同步 SpecModelOption/DeviceOption 类型
 2026-08-14 14:30:35 +08:00