Neo
b25308c3f4
## P1 数据库基础 - zqyy_app: 创建 auth/biz schema、FDW 连接 etl_feiqiu - etl_feiqiu: 创建 app schema RLS 视图、商品库存预警表 - 清理 assistant_abolish 残留数据 ## P2 ETL/DWS 扩展 - 新增 DWS 助教订单贡献度表 (dws.assistant_order_contribution) - 新增 assistant_order_contribution_task 任务及 RLS 视图 - member_consumption 增加充值字段、assistant_daily 增加处罚字段 - 更新 ODS/DWD/DWS 任务文档及业务规则文档 - 更新 consistency_checker、flow_runner、task_registry 等核心模块 ## P3 小程序鉴权系统 - 新增 xcx_auth 路由/schema（微信登录 + JWT） - 新增 wechat/role/matching/application 服务层 - zqyy_app 鉴权表迁移 + 角色权限种子数据 - auth/dependencies.py 支持小程序 JWT 鉴权 ## 文档与审计 - 新增 DOCUMENTATION-MAP 文档导航 - 新增 7 份 BD_Manual 数据库变更文档 - 更新 DDL 基线快照（etl_feiqiu 6 schema + zqyy_app auth） - 新增全栈集成审计记录、部署检查清单更新 - 新增 BACKLOG 路线图、FDW→Core 迁移计划 ## Kiro 工程化 - 新增 5 个 Spec（P1/P2/P3/全栈集成/核心业务） - 新增审计自动化脚本（agent_on_stop/build_audit_context/compliance_prescan） - 新增 6 个 Hook（合规检查/会话日志/提交审计等） - 新增 doc-map steering 文件 ## 运维与测试 - 新增 ops 脚本：迁移验证/API 健康检查/ETL 监控/集成报告 - 新增属性测试：test_dws_contribution / test_auth_system - 清理过期 export 报告文件 - 更新 .gitignore 排除规则
3.8 KiB
3.8 KiB
BD Manual: goodsStockWarningInfo（库存预警信息）
变更概述
- 日期：2026-02-24
- 触发：一致性检查报告发现 API 独有嵌套字段
goodsStockWarningInfo未映射到 ODS/DWD - 迁移脚本：
db/etl_feiqiu/migrations/2026-02-24__add_goods_stock_warning_info.sql
字段来源
API 端点 /TenantGoods/GetGoodsInventoryList 返回的 store_goods_master 记录中包含嵌套对象：
{
"goodsStockWarningInfo": {
"tenant_goods_id": 0, // 冗余，已有同名顶层字段
"site_goods_id": 0, // 冗余，对应顶层 id
"sales_day": 0.0, // → warning_sales_day
"warning_day_max": 0, // → warning_day_max
"warning_day_min": 0 // → warning_day_min
}
}
仅提取 3 个有效字段，冗余 ID 不重复收录。
新增字段
| 层 | 表 | 列名 | 类型 | 说明 |
|---|---|---|---|---|
| ODS | ods.store_goods_master |
warning_sales_day |
NUMERIC(18,2) | 库存预警参考的日均销量 |
| ODS | ods.store_goods_master |
warning_day_max |
INTEGER | 预警天数上限 |
| ODS | ods.store_goods_master |
warning_day_min |
INTEGER | 预警天数下限 |
| DWD | dwd.dim_store_goods_ex |
warning_sales_day |
NUMERIC(18,2) | 同 ODS，直接映射 |
| DWD | dwd.dim_store_goods_ex |
warning_day_max |
INTEGER | 同 ODS，直接映射 |
| DWD | dwd.dim_store_goods_ex |
warning_day_min |
INTEGER | 同 ODS，直接映射 |
数据流
API goodsStockWarningInfo (嵌套 JSON)
↓ _merge_record_layers 扁平化（_STOCK_WARNING_FIELD_MAP）
ODS ods.store_goods_master (warning_sales_day / warning_day_max / warning_day_min)
↓ DWD FACT_MAPPINGS 直接映射
DWD dwd.dim_store_goods_ex (同名列)
代码变更
| 文件 | 变更 |
|---|---|
apps/etl/connectors/feiqiu/tasks/ods/ods_tasks.py |
_merge_record_layers 增加 goodsStockWarningInfo 扁平化逻辑 |
apps/etl/connectors/feiqiu/tasks/dwd/dwd_load_task.py |
FACT_MAPPINGS["dwd.dim_store_goods_ex"] 增加 3 个映射 |
db/_archived/ddl_baseline_2026-02-22/db/etl_feiqiu/schemas/ods.sql |
baseline 同步 |
db/_archived/ddl_baseline_2026-02-22/db/etl_feiqiu/schemas/dwd.sql |
baseline 同步 |
兼容性
- 后端 API：无影响（后端不直接读取 ODS/DWD 层这些字段）
- 小程序：无影响
- ETL：ODS schema-aware 插入自动识别新列；DWD 通过 FACT_MAPPINGS 映射
- 管理后台：如需展示库存预警信息，可从
dwd.dim_store_goods_ex读取
回滚策略
ALTER TABLE ods.store_goods_master
DROP COLUMN IF EXISTS warning_sales_day,
DROP COLUMN IF EXISTS warning_day_max,
DROP COLUMN IF EXISTS warning_day_min;
ALTER TABLE dwd.dim_store_goods_ex
DROP COLUMN IF EXISTS warning_sales_day,
DROP COLUMN IF EXISTS warning_day_max,
DROP COLUMN IF EXISTS warning_day_min;
验证 SQL
-- 1. 确认 ODS 新列存在
SELECT column_name, data_type FROM information_schema.columns
WHERE table_schema = 'ods' AND table_name = 'store_goods_master'
AND column_name IN ('warning_sales_day', 'warning_day_max', 'warning_day_min')
ORDER BY column_name;
-- 预期：3 行
-- 2. 确认 DWD 新列存在
SELECT column_name, data_type FROM information_schema.columns
WHERE table_schema = 'dwd' AND table_name = 'dim_store_goods_ex'
AND column_name IN ('warning_sales_day', 'warning_day_max', 'warning_day_min')
ORDER BY column_name;
-- 预期：3 行
-- 3. 确认注释已设置
SELECT c.column_name, pgd.description
FROM information_schema.columns c
JOIN pg_catalog.pg_statio_all_tables st ON st.schemaname = c.table_schema AND st.relname = c.table_name
JOIN pg_catalog.pg_description pgd ON pgd.objoid = st.relid AND pgd.objsubid = c.ordinal_position
WHERE c.table_schema = 'ods' AND c.table_name = 'store_goods_master'
AND c.column_name LIKE 'warning_%';
-- 预期：3 行，description 非空