feat: P1-P3 全栈集成 — 数据库基础 + DWS 扩展 + 小程序鉴权 + 工程化体系

## 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 排除规则

docs/database/BD_Manual_goods_stock_warning_info.md

@@ -0,0 +1,102 @@
+# 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` 记录中包含嵌套对象：
+
+```json
+{
+  "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` 读取
+
+## 回滚策略
+
+```sql
+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
+
+```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 非空
+```