chore: v1 整理 — 清理历史文件、DDL 合并、文档归档
- 清理 1155 个已删除的历史文件(废弃 prompt_logs、tmp、旧 ops 脚本) - export/ 数据文件从 git 移除(已在 .gitignore) - demo-miniprogram 从 tmp/ 移入 apps/,添加 CLAUDE.md 注解 - DDL 合并:完整 schema 定义填充到 db/*/schemas/(从 docs/database/ddl/ 复制) - 39 个 v1 迁移脚本归档到 db/_archived/migrations_v1_merged/ - 4 个迁移变更类 BD_Manual 文档归档到 docs/database/_archived/ - .gitignore 补充 .vite/ 和 apps/*.zip - settings.json 添加 effortLevel 默认配置 - scripts/ops/ 新增运维脚本入库 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
83
docs/database/_archived/BD_manual_fdw_finance_area.md
Normal file
83
docs/database/_archived/BD_manual_fdw_finance_area.md
Normal file
@@ -0,0 +1,83 @@
|
||||
# BD_Manual:FDW 财务区域查询映射(fdw_finance_area)
|
||||
|
||||
> 目标库:后端通过 `get_etl_readonly_connection(site_id)` 直连 ETL 库
|
||||
> 关联 SPEC:board-finance-dws-area-refactor
|
||||
> 日期:2026-03-28
|
||||
|
||||
---
|
||||
|
||||
## 1. 变更说明
|
||||
|
||||
### 新增 RLS 视图(ETL 库 app Schema 自动导出)
|
||||
|
||||
本次新增的两张 DWS 表各有一个 RLS 视图,后端通过直连 ETL 库的 `app.v_*` 视图访问(与 RNS1.2 以来的模式一致,不使用 `fdw_etl.*` 外部表)。
|
||||
|
||||
| 视图 | 源表 | 用途 |
|
||||
|------|------|------|
|
||||
| `dws.v_dws_finance_area_daily` | `dws.dws_finance_area_daily` | 区域日粒度财务数据(overview/revenue 板块) |
|
||||
| `dws.v_dws_finance_board_cache` | `dws.dws_finance_board_cache` | 已完成周期缓存(overview 8 项指标) |
|
||||
|
||||
### 后端查询函数
|
||||
|
||||
| 函数 | 视图 | 用途 |
|
||||
|------|------|------|
|
||||
| `get_finance_overview_area()` | `v_dws_finance_area_daily` | 按 area_code 聚合 overview 8 项指标 |
|
||||
| `get_finance_revenue_area()` | `v_dws_finance_area_daily` | 按 area_code 聚合 revenue 板块数据 |
|
||||
| `get_finance_board_cache()` | `v_dws_finance_board_cache` | 查询缓存 |
|
||||
| `set_finance_board_cache()` | `dws.dws_finance_board_cache` | 写入/更新缓存 |
|
||||
|
||||
### RLS 隔离
|
||||
|
||||
所有查询通过 `SET LOCAL app.current_site_id = :site_id` 设置门店隔离参数,RLS 视图的 `WHERE site_id = current_setting('app.current_site_id')::bigint` 自动过滤。
|
||||
|
||||
---
|
||||
|
||||
## 2. 兼容性影响
|
||||
|
||||
| 组件 | 影响 |
|
||||
|------|------|
|
||||
| ETL 任务 | 无影响。FDW 配置不修改 ETL 库 |
|
||||
| 后端 API | `fdw_queries.py` 新增 4 个函数,`board_service.py` 改为调用新函数 |
|
||||
| 小程序 | 无直接影响(API 签名不变) |
|
||||
| 现有 FDW 外部表 | 无影响。新视图通过直连 ETL 库访问,不经过 `fdw_etl` Schema |
|
||||
|
||||
---
|
||||
|
||||
## 3. 回滚策略
|
||||
|
||||
后端回滚:
|
||||
1. 恢复 `board_service.py` 到旧逻辑(从 `dws_finance_daily_summary` 取数)
|
||||
2. 移除 `fdw_queries.py` 中的 4 个新函数
|
||||
|
||||
数据库回滚:
|
||||
```sql
|
||||
DROP VIEW IF EXISTS dws.v_dws_finance_board_cache;
|
||||
DROP TABLE IF EXISTS dws.dws_finance_board_cache;
|
||||
DROP VIEW IF EXISTS dws.v_dws_finance_area_daily;
|
||||
DROP TABLE IF EXISTS dws.dws_finance_area_daily;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 验证 SQL
|
||||
|
||||
```sql
|
||||
-- 1. 验证 RLS 视图可访问(需先设置 site_id)
|
||||
SET LOCAL app.current_site_id = '1';
|
||||
SELECT COUNT(*) FROM dws.v_dws_finance_area_daily;
|
||||
|
||||
-- 2. 验证缓存视图可访问
|
||||
SET LOCAL app.current_site_id = '1';
|
||||
SELECT COUNT(*) FROM dws.v_dws_finance_board_cache;
|
||||
|
||||
-- 3. 验证 app_reader 角色有 SELECT 权限
|
||||
SELECT has_table_privilege('app_reader', 'dws.v_dws_finance_area_daily', 'SELECT') AS daily_ok,
|
||||
has_table_privilege('app_reader', 'dws.v_dws_finance_board_cache', 'SELECT') AS cache_ok;
|
||||
|
||||
-- 4. 验证区域日粒度数据完整性(每天 9 行)
|
||||
SET LOCAL app.current_site_id = '1';
|
||||
SELECT stat_date, COUNT(*) AS cnt
|
||||
FROM dws.v_dws_finance_area_daily
|
||||
GROUP BY stat_date
|
||||
HAVING COUNT(*) != 9;
|
||||
```
|
||||
Reference in New Issue
Block a user