diff --git a/db_migrations/phase6_material_purchase_link.sql b/db_migrations/phase6_material_purchase_link.sql new file mode 100644 index 0000000..cad1808 --- /dev/null +++ b/db_migrations/phase6_material_purchase_link.sql @@ -0,0 +1,94 @@ +-- ============================================================================= +-- 基础信息 · 新增「采购链接」字段 + 权限注册 +-- +-- 需求 +-- 物料主数据上增加一个可直接跳转的补货地址(淘宝 / 1688 等), +-- 并纳入字段级权限管控。 +-- +-- --------------------------------------------------------------------------- +-- ★ 设计取舍:读写**共用同一个权限码** material_list:purchaseLink +-- 上一轮刚修完「写用了 A 码、读用了 B 码」造成的读写错位(附件备注), +-- 新字段刻意沿用 referencePrice 的既有模式 —— 一个码同时进 +-- field_permissions.py(读过滤)与 base.py 的 field_to_perm(写过滤)。 +-- 单码最大的好处是**结构上不可能出现口径错位**:能读必然能写、反之亦然, +-- 不会再有「填了看不到」或「看得到改不了」。 +-- +-- 若业务后续要求「能看不能改」,再拆成两个码并同步改三处 +-- (field_permissions.py / base.py 的 POST 与 PUT),届时请一并回归验证。 +-- +-- ★ 为什么列类型用 text 而不是 varchar(N) +-- 外链(尤其是电商)常带很长的查询串,varchar 截断后得到的是打不开的地址, +-- 而且截断是静默的 —— 用户只会觉得"链接坏了"。 +-- +-- 默认授予:SUPER_ADMIN / SUPERVISOR / WAREHOUSE_MGR / INBOUND +-- —— 覆盖「实际补货的人」与「管理物料的人」。 +-- ⚠ 这是本次取的默认值,业务可按需增删;增删只需改下面的 VALUES 再执行一次。 +-- +-- 幂等:带 IF NOT EXISTS / WHERE NOT EXISTS,可重复执行。 +-- 脚本文本不含 psql 元命令,DataGrip / DBeaver 可直接整段执行。 +-- 执行:docker exec -i inventory_db psql -U test -d inventory_system < 本文件 +-- ============================================================================= + +BEGIN; + +-- --------------------------------------------------------------------------- +-- 一、加列 +-- --------------------------------------------------------------------------- +ALTER TABLE material_base + ADD COLUMN IF NOT EXISTS purchase_link text DEFAULT ''; + +COMMENT ON COLUMN material_base.purchase_link IS + '采购链接:补货时直接跳转的购买地址。受 material_list:purchaseLink 字段权限管控(读写同码)'; + +-- --------------------------------------------------------------------------- +-- 二、注册字段权限元素 +-- --------------------------------------------------------------------------- +INSERT INTO sys_element (menu_code, name, code, element_type) +SELECT 'material_list', '采购链接', 'material_list:purchaseLink', 'element' +WHERE NOT EXISTS (SELECT 1 FROM sys_element WHERE code = 'material_list:purchaseLink'); + +-- --------------------------------------------------------------------------- +-- 三、默认授予 +-- --------------------------------------------------------------------------- +INSERT INTO sys_role_permission (role_code, target_code, type, company_name) +SELECT v.role_code, 'material_list:purchaseLink', 'element', NULL +FROM (VALUES ('SUPER_ADMIN'), ('SUPERVISOR'), ('WAREHOUSE_MGR'), ('INBOUND')) AS v(role_code) +WHERE NOT EXISTS ( + SELECT 1 FROM sys_role_permission r + WHERE r.role_code = v.role_code + AND r.target_code = 'material_list:purchaseLink' + AND r.type = 'element' +); + +COMMIT; + + +-- ============================================================================= +-- 执行后核对 +-- ============================================================================= +SELECT '=== 1) 新列已就位 ===' AS "核对项"; +SELECT column_name, data_type, column_default FROM information_schema.columns + WHERE table_name = 'material_base' AND column_name = 'purchase_link'; + +SELECT '=== 2) 权限元素已注册 ===' AS "核对项"; +SELECT code, name, menu_code, element_type FROM sys_element + WHERE code = 'material_list:purchaseLink'; + +SELECT '=== 3) 已授予角色(默认应为 4 个)===' AS "核对项"; +SELECT role_code FROM sys_role_permission + WHERE target_code = 'material_list:purchaseLink' AND type = 'element' ORDER BY role_code; + +SELECT '=== 4) 存量数据回填为空的应占多数 ===' AS "核对项"; +SELECT count(*) AS 物料总数, + count(*) FILTER (WHERE coalesce(purchase_link,'') = '') AS 未填链接 + FROM material_base; + + +-- ============================================================================= +-- 回滚段 +-- ============================================================================= +-- BEGIN; +-- DELETE FROM sys_role_permission WHERE target_code = 'material_list:purchaseLink'; +-- DELETE FROM sys_element WHERE code = 'material_list:purchaseLink'; +-- ALTER TABLE material_base DROP COLUMN IF EXISTS purchase_link; +-- COMMIT;