chore: 文档与 IDE 配置整理

- .kiro/specs/ → docs/specs/（41 个历史需求 spec 迁移，移除 .config.kiro）
- CLAUDE.md 三层拆分：根文件精简 + apps/backend/CLAUDE.md + .claude/commands/
- 新增 /spec-close、/pre-change 两个工作流命令
- DDL 基线刷新（从测试库重新导出 11 个文件，dws 35→38 表，biz 18→21 表）
- BD_Manual → BD_manual 命名统一（48 个文件）
- 修复 3 处文档与数据库不一致（auth.users.status 默认值、scheduled_tasks 字段、RLS 视图数）
- 新增 BD_manual_public_rbac_tables.md（public schema 8 张 RBAC/工作流表）
- 合并 biz.trigger_jobs 文档（10→12 字段，归档独立文档）
- docs/database/README.md 索引更新

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/database/ddl/fdw_reverse.sql

@@ -0,0 +1,86 @@
+-- =============================================================================
+-- FDW 反向映射配置（生产环境）— 在 etl_feiqiu 数据库中执行
+-- 用途：通过 postgres_fdw 将 zqyy_app.member_retention_clue 只读映射到 etl_feiqiu，
+--       使 ETL DWS 任务无需直接连接业务库即可读取维客线索数据。
+-- 方向：etl_feiqiu → zqyy_app（与 setup_fdw.sql 的 zqyy_app → etl_feiqiu 方向相反）
+-- 前提：zqyy_app 数据库已部署 member_retention_clue 表
+-- 测试环境版本：setup_fdw_reverse_test.sql（指向 test_zqyy_app）
+-- CHANGE 2026-02-26 | member_birthday_manual → member_retention_clue（维客线索重构）
+-- =============================================================================
+
+-- -----------------------------------------------------------------------------
+-- 1. 安装 postgres_fdw 扩展（如已安装则跳过）
+-- -----------------------------------------------------------------------------
+CREATE EXTENSION IF NOT EXISTS postgres_fdw;
+
+-- -----------------------------------------------------------------------------
+-- 2. 创建外部服务器（指向 zqyy_app 业务库）
+--    部署时按实际环境替换 host / port
+-- -----------------------------------------------------------------------------
+CREATE SERVER IF NOT EXISTS zqyy_app_server
+    FOREIGN DATA WRAPPER postgres_fdw
+    OPTIONS (host 'localhost', dbname 'zqyy_app', port '5432');
+
+-- -----------------------------------------------------------------------------
+-- 3. 创建用户映射（只读角色）
+-- -----------------------------------------------------------------------------
+CREATE USER MAPPING IF NOT EXISTS FOR etl_user
+    SERVER zqyy_app_server
+    OPTIONS (user 'app_reader', password '***');
+
+-- -----------------------------------------------------------------------------
+-- 4. 创建目标 schema（存放来自业务库的外部表）
+-- -----------------------------------------------------------------------------
+CREATE SCHEMA IF NOT EXISTS fdw_app;
+
+-- -----------------------------------------------------------------------------
+-- 5. 创建外部表：member_retention_clue
+--    映射 zqyy_app.public.member_retention_clue，ETL 侧只读
+-- -----------------------------------------------------------------------------
+CREATE FOREIGN TABLE IF NOT EXISTS fdw_app.member_retention_clue (
+    id                       BIGINT,
+    member_id                BIGINT,
+    category                 VARCHAR(20),
+    summary                  VARCHAR(200),
+    detail                   TEXT,
+    recorded_by_assistant_id BIGINT,
+    recorded_by_name         VARCHAR(50),
+    recorded_at              TIMESTAMPTZ,
+    site_id                  BIGINT
+) SERVER zqyy_app_server
+  OPTIONS (schema_name 'public', table_name 'member_retention_clue');
+
+-- -----------------------------------------------------------------------------
+-- 6. 授权：允许 etl_user 访问 fdw_app schema 及其外部表
+-- -----------------------------------------------------------------------------
+GRANT USAGE ON SCHEMA fdw_app TO etl_user;
+GRANT SELECT ON ALL TABLES IN SCHEMA fdw_app TO etl_user;
+ALTER DEFAULT PRIVILEGES IN SCHEMA fdw_app GRANT SELECT ON TABLES TO etl_user;
+
+
+-- =============================================================================
+-- 回滚脚本（按逆序执行）
+-- =============================================================================
+-- ALTER DEFAULT PRIVILEGES IN SCHEMA fdw_app REVOKE SELECT ON TABLES FROM etl_user;
+-- REVOKE SELECT ON ALL TABLES IN SCHEMA fdw_app FROM etl_user;
+-- REVOKE USAGE ON SCHEMA fdw_app FROM etl_user;
+-- DROP FOREIGN TABLE IF EXISTS fdw_app.member_retention_clue;
+-- DROP SCHEMA IF EXISTS fdw_app CASCADE;
+-- DROP USER MAPPING IF EXISTS FOR etl_user SERVER zqyy_app_server;
+-- DROP SERVER IF EXISTS zqyy_app_server CASCADE;
+
+
+-- =============================================================================
+-- 验证 SQL
+-- =============================================================================
+-- 1. 确认外部服务器存在
+-- SELECT srvname, srvoptions FROM pg_foreign_server
+--  WHERE srvname = 'zqyy_app_server';
+
+-- 2. 确认外部表列结构完整（9 列）
+-- SELECT column_name, data_type FROM information_schema.columns
+--  WHERE table_schema = 'fdw_app' AND table_name = 'member_retention_clue'
+--  ORDER BY ordinal_position;
+
+-- 3. 确认外部表可读取
+-- SELECT COUNT(*) FROM fdw_app.member_retention_clue;