duxingchen/KCGL
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,027 Commits 5 Branches 0 Tags
1c58789fd9227aebb3ae2149290d860695f3f993
Commit Graph

36 Commits

Author SHA1 Message Date
yueli
b998b00889 feat(borrow): 借库转交一期数据层（迁移、转交/归还流水表、发货操作人列） 
背景
----
原 trans_borrow 是单行记录模式，身份维度只有 borrower_name 一个字符串：
「谁借的」与「谁现在还拿着」是同一个字段，无法表达持有权变更；归还时
return_time/return_operator/return_signature 被逐次覆盖，部分归还下
「谁在什么时候还了多少」永久丢失。

本次改动（全部增量，无破坏性 DDL，可回滚）
----
1) trans_borrow 补列
   · borrower_id / current_holder_id / current_holder_name —— 身份锚点
   · dispatch_operator —— 执行借出的库管（operator_name 形参此前被接收却从未落库）
2) 新建 trans_borrow_transfer —— 转交流水，一行=一次转交，不做覆盖式更新
3) 新建 trans_borrow_return   —— 归还流水，逐次记录，根治部分归还失忆症
4) 历史回填（已执行）：85 行中 84 行 borrower_id 唯一命中 sys_user；
   未归还的 32 行全部绑定 current_holder
5) 注册 borrow_transfer 权限码（无冒号形式，避免 _expand_operation_perms
   前缀桥接把权限放大给所有持有 op_borrow:operation 的角色）

设计取舍
----
· current_holder 只回填「未归还」行：已归还=物品已回库、无人持有，保持 NULL。
  这样「current_holder_id IS NOT NULL」本身就是「仍在某人手上」的有效信号，
  归还校验不会对已结清单据误触发。
· 三张表都不建外键：与 trans_return / trans_defective_goods 一致 ——
  库存行会被入库模块物理删除（实测已有悬空），台账必须能独立存活。
· dispatch_operator 不回填历史：执行人信息从未被采集，系统中不存在可回填的
  数据源；用申请人或借用人冒充实物交接人比留空更危险。

验证：迁移已对 inventory_db 执行，核对段全部通过。
 2026-09-17 09:17:51 +08:00
yueli
69c38a1bf7 feat(return): 逆向物流数据模型与迁移 
新增原单退回与不良品在管的持久化结构。

- TransOutbound 增 returned_quantity（numeric(19,4)，非 float）：该值参与
  「return_qty <= quantity - returned_quantity」判等，浮点误差会让反复部分
  退回后出现「已退满却判定未退满」的错判
- 新增 TransReturn：退回流水，每次退回写一条而非覆盖式更新。刻意与
  trans_borrow 划清界限——后者部分归还时会覆盖 return_time/operator，
  导致归还历史永久丢失
- 新增 TransDefectiveGoods：不良品在管台账。坏件全程不入库存表，因为
  status 是行级属性而质量是件级属性，把坏件加回原行只能整行打不良
  （实测 stock_buy 单行最大 4789 件、中位 8 件，整行打不良会凭空损失良品）
- 状态机：待处理 → 处理中 → {已回库|已报废|已闭环}。终态由累计去向推导
  而非「最后一次动作」——一批坏件可能既回库过又报废过，按最后动作定状态
  会产生误导
- restocked_qty/scrapped_qty 两列：二期用 quantity-remaining_qty 反推回库量，
  三期加入报废出口后该反推失效
- 审计白名单与模型预加载同步登记（监听器绑定 18 → 20 个模型）

迁移脚本均为纯追加式 DDL，含预检、回滚段与执行后核对。首个脚本用
COALESCE 包裹数量列——库存表允许数量为 NULL，而「NULL 大于 0」求值为
NULL 而非真，裸写会让脏行在预览与诊断两次查询里凭空消失。
 2026-09-16 15:45:22 +08:00
yueli
ec66c33b06 feat(scan-draft): 扫码草稿表与接口，支持暂停后继续扫码 
场景
----
扫码出库/借库的作业可能很长（一张单几十项），工人常需中途暂停去处理
更紧急的单据。改造前切换单据会清空已扫内容，刷新/退出页面则全部丢失。

由于库存在申请审批通过时已**预占**，暂停期间货不会被他人抢走 ——
因此草稿只记录「扫到哪了」，**不涉及任何库存操作**。即使草稿丢失也只是
需要重扫，不会造成库存错乱。

隔离粒度
--------
按 (user_id, biz_type, request_id) 一人一单：每个人扫自己的草稿，互不影响；
同一人可同时持有多张单据的草稿（正是「暂停 A 去出 B」的场景）。
user_id 一律取自 JWT，不接受入参覆盖，故不可能读写他人草稿。

为什么整单存一个 JSON（而非每条明细一行）
------------------------------------------
1. 保存是「全量覆盖」语义，逐行存无增量更新的收益；
2. 恢复时需要物料名称/规格/库位等展示字段，逐行方案只能回查申请单的
   items_json —— 而历史单据的 items_json 不含 stock_id，回查会错配。
   整单快照把展示字段一并存下，恢复零依赖，对老单据同样可靠。

接口
----
GET    /api/v1/scan-draft           读取草稿
POST   /api/v1/scan-draft           保存（全量覆盖；空清单则删除）
DELETE /api/v1/scan-draft           清除（提交成功后调用）
GET    /api/v1/scan-draft/overview  各单据进度，供下拉徽标

实现要点
--------
· items_json 列是 jsonb，模型必须用 db.JSON —— 用 db.Text 会让 psycopg2
  拿到 Python list/dict 时无法适配，报 "can't adapt type 'dict'"，而异常
  被接口的 except 吞掉后 POST 仍返回"成功"，问题极难发现（开发中实际踩到）；
· 概览接口做防御：残留的空草稿不参与展示。

实测：保存/读回、跨单据隔离（B 读 A 的草稿为 0 项）、全量覆盖、
      提交后清除，全部符合预期。
 2026-09-10 17:21:14 +08:00
yueli
b67d577616 feat(my-requests): 跨模块聚合端点，一个页面看全部申请 
动机
----
出库/借库/报废三个模块各有一套审批流，申请人此前没有统一入口。
新增只读聚合视图，把三类单据合并返回。

为什么单独建蓝图
----------------
权限模型不同：审批端点是「管理视角」，本端点是「申请人视角」。
把两者塞进同一端点（if not privileged: applicant_id = me）会让管理逻辑
与用户逻辑混流，一旦 is_privileged_viewer() 判定出错即越权。
本模块从设计上就没有「看别人」的分支 —— applicant_id 硬编码为当前用户。

只读保证
--------
本模块只做查询，不修改任何数据。撤回等写操作仍由各模块自己的端点承担
（因为三者释放逻辑不同：出库/借库已接入预占，报废尚未接入）。
把风险锁在只读层，即使聚合逻辑有 bug 也不会破坏业务数据。

字段归一化
----------
三个模块的 items_json 存在差异，统一在服务端抹平：
  · 数量字段：报废用 scrap_qty，出库/借库用 quantity → 统一为 quantity
  · 库位字段：报废用 location → 统一为 warehouse_location
这专门避免「报废行的数量列显示空白」这类不报错的隐性 bug。

健壮性
------
单个模块查询失败时记日志并跳过，其余模块照常返回
（例如某张表尚未迁移时，其它两类仍可用）。

响应中附带 withdraw_endpoint 字段，前端据此分发撤回请求，
无需硬编码三个模块的 URL 映射。

实测
----
  普通员工（INBOUND 角色，无任何审批权限）访问 → 200，18 单
  三类单据齐全，type_label 正确
  报废明细数量字段归一化成功（quantity=1.0）
  B 看不到 A 的单 → 0 条
  type=scrap 过滤 → 全部为报废
 2026-09-10 15:37:05 +08:00
yueli
4808a48594 refactor(audit): 审计架构清理——复活白名单监听器、停用噪声监听器、清除僵尸装饰器 
一、统一为单一监听器实现
  原先两套 SQLAlchemy 事件监听器并存：
    · app/utils/audit_events.py   —— 全局监听 db.Model、无白名单、无请求上下文守卫（实际在跑）
    · app/core/audit_listener.py  —— 白名单制、有守卫、有模型级开关（从未生效）
  后者失效的根因：注册代码写在 extensions.py 的 init_extensions() 内，
  而该函数全仓库只有定义、没有任何调用（create_app 直接内联调用 db.init_app 等）。

  现统一由 app/core/audit_listener.py 承担，并在 create_app() 中显式注册。
  extensions.py 的死函数 init_extensions 整体删除，避免后人误以为它是有效入口。

二、修复监听器三处致命缺陷（此前注册了也写不进数据）
  1. 事件回调第二个参数是 Connection，原代码却调用 Connection.add()（不存在），
     每次写日志都抛 AttributeError 并被 except 吞掉 → 改为 connection.execute()
  2. register_audit_listeners 从 app.models 批量 import 多个未导出的模型，
     ImportError 被上层 try/except 吞掉 → 改为按表名从 db.metadata 取模型
  3. 本项目有 31 处函数体内延迟导入模型（如 scrap.py 内部才 import ScrapApproval），
     一次性注册会静默漏表 → 增加 ensure_audit_listeners() 惰性补绑，
     并在模型预加载段补全审批单/BOM/采购等模型

三、强约束
  · WHITELIST_TABLES：仅 18 张核心业务表，系统表/草稿表/向量表不再自审
  · has_request_context() 守卫：系统初始化与后台定时任务不再产生 username=system 噪声
  · IGNORE_FIELDS 增加 password/password_hash/salt/token/secret/api_key（安全红线）
  · created_at 显式写 beijing_time()，与全系统时间口径一致

四、清除僵尸装饰器
  @audit_log 早已退化为直接透传的空壳（module/action 参数全被忽略，
  数据库中零星的中文 action 即其历史遗留产物），却仍挂在 38 处路由上。
  连同 13 个文件的 import 一并移除；audit_events.register_audit_events 改为空操作。

验证：应用上下文中的写操作不产生日志；HTTP 请求产生 5 条日志，
对象为业务单号（APR-SCRAP-... / SKU），模块中文，操作人真实，时间为北京时间。
 2026-09-10 14:16:27 +08:00
yueli
23fc10a25f fix: Day2就绪 — 删除硬化+索引补全+全局异常处理 
## base_service.py — MaterialBase删除硬化
- 新增 BomTable 引用检查(bom_usage_count)
- 物料被BOM引用时禁止删除,提示「请先解除BOM绑定」

## models/base.py + bom.py — 缺失索引补全
- material_base: company_name + is_enabled 添加 index=True
- bom_table: is_enabled 添加 index=True

## __init__.py — 全局异常处理
- @app.errorhandler(ValueError) → 400 + 自定义消息
- @app.errorhandler(404/405) → 标准错误
- @app.errorhandler(Exception) → 500 + 通用消息
  堆栈仅记录服务器日志,不泄露到前端
 2026-07-16 14:14:43 +08:00
yueli
5411cabd0a feat: Excel批量导入后端 — 模板下载+预览验证+执行导入 
## import_service.py (新增)
- generate_template(): 基础信息/BOM Excel模板生成(带样例数据)
- parse_boolean(): 是/否/True/False 稳健布尔解析
- preview_material/bom(): Dry-Run解析+验证(重复/存在性/必填)
- BOM ffill: 父件列自动向下填充(支持合并单元格UX)
- execute_material/bom_import(): 事务包裹批量写入

## import_api.py (新增)
- GET /api/v1/import/template?type=material|bom
- POST /api/v1/import/preview (文件→预览验证)
- POST /api/v1/import/execute (确认导入)

## __init__.py + requirements.txt
- 注册 import 蓝图; 新增 pandas>=1.5.0
 2026-07-16 14:00:28 +08:00
yueli
0b75740ae0 feat: 权限系统重构 — 操作权限双向展开 + 启动时自动补全默认权限 
## permission_service.py
- init_all_menus: menu_defs 新增 inbound_purchase(采购申请) 菜单项
- init_all_menus: 创建 inbound_purchase:operation 操作元素
- 新增 ensure_default_permissions(): 启动时从 sys_user 提取活跃角色,
  对空权限角色自动补全默认菜单(按角色类型分级)
- 自动迁移: 已有 inbound_buy 权限的角色 → 自动获得 inbound_purchase
- SUPERVISOR 启动时自动获得 inbound_purchase 菜单权限

## decorators.py
- _expand_operation_perms 改为双向桥接:
  正向(inbound_buy:operation←inbound_buy:write)→通过
  反向(inbound_buy←inbound_buy:operation)→通过(可编辑隐含可读)
- 新增详细诊断日志,记录展开路径和失败原因

## __init__.py
- 启动时调用 PermissionService.ensure_default_permissions()
 2026-07-16 11:25:41 +08:00
DXC
1a7c06f197 feat: 添加以图搜图功能（CLIP ONNX + pgvector）+ Dify会话修复 + 版本升至V3.30 2026-05-21 14:09:57 +08:00
DXC
4d81056075 feat: 实现异步导出骨架（Threading + Redis 状态流转），支持 POST 提交/轮询状态/下载文件 2026-05-19 10:35:33 +08:00
dxc
9dfcb93146 feat(purchase): 新增采购申请模块后端（模型+Service+API路由） 2026-05-12 16:33:18 +08:00
dxc
259f3a7e0d 4.29扫码获取库位小工具接口 2026-04-29 15:40:43 +08:00
DXC
d6ae9499db feat: 新增首页全局搜索功能，支持跨模块多词搜索 2026-04-27 15:57:26 +08:00
DXC
4b794b9bcc feat(audit): 添加全局无侵入审计日志拦截器 2026-04-22 10:41:15 +08:00
DXC
6336432a5c refactor: restructure permission list to a tree format matching the sidebar navigation 2026-03-20 09:42:14 +08:00
DXC
1ad57da2a7 chore: remove legacy inventory stocktake menu and permission configs 2026-03-20 09:34:36 +08:00
DXC
b375cbfe25 fix: add stocktake and adjustment modules to role permission assignment UI 2026-03-20 09:31:33 +08:00
DXC
d8a57ab66e feat: initialize inventory profit and loss adjustment module 2026-03-19 12:06:32 +08:00
dxc
d2d9abe201 全局审计日fix: 使用鸭子类型强制安全解包 SQLAlchemy Row 对象，彻底解决 to_dict 报错志 2026-03-11 13:11:16 +08:00
DXC
e1e74e5983 feat: 增加后端初始化逻辑，自动向数据库注入审计日志菜单与默认权限 2026-03-10 12:24:34 +08:00
DXC
be6575344a feat: 新增企业级操作审计日志闭环模块（包含底层模型、记录装饰器与前端看板） 2026-03-10 12:15:26 +08:00
dxc
359b8a8345 "feat: 1-实现动态层级树形库位管理功能 
2 - 首页新增库位设置按钮和树形管理弹窗
     3 - 后端添加 SysWarehouseLocation 模型和 CRUD API
     4 - 树形结构支持无限层级，自动计算 full_path
     5 - 修复 product.vue 中 defaultColumns 未定义 bug
 2026-03-06 14:33:13 +08:00
dxc
7431f1f41e 权限管理，没有页面修改之前版本 2026-02-25 16:10:12 +08:00
dxc
20e4329a44 (no commit message provided) 
Co-authored-by: aider (openai/DeepSeek-V3.2-Thinking) <aider@aider.chat>
 2026-02-09 15:25:05 +08:00
dxc
04ee938cd1 借库逻辑实现 2026-02-06 17:11:47 +08:00
dxc
797b611530 出库逻辑添加，扫码识别编码成功，后续对应逻辑没有完成 2026-02-04 17:22:20 +08:00
dxc
fd5600b65b 修改登录退出逻辑 2026-02-04 14:29:59 +08:00
dxc
13590b1fac 超级管理员登录设置 2026-02-04 13:30:07 +08:00
dxc
7fa40115d9 采购件图像上传初实现 2026-02-03 11:16:12 +08:00
dxc
cf6a4a8957 添加条形码内容 2026-02-02 15:06:20 +08:00
dxc
30181fd21b 维护三个基础物件入库时候与数据库不匹配问题 2026-01-30 11:50:35 +08:00
dxc
06ba2d7563 采购件，半成品，产品页面初步完成 2026-01-29 09:27:56 +08:00
dxc
b0df5c7458 添加半成品页面进行数据 2026-01-28 17:44:39 +08:00
dxc
3afea217b7 物料-采购件入库页面功能实现 2026-01-27 15:50:23 +08:00
dxc
2f8a5c55b1 python-flask和Vue两种模式初模板 2026-01-26 17:00:12 +08:00
dxc
ee9f4aed3e 修正git管理关系 2026-01-26 13:47:53 +08:00