feat: chat integration, tenant admin spec, backend chat service, miniprogram updates, DEMO moved to tmp, XCX-TEST removed, migrations & docs

This commit is contained in:
Neo
2026-03-20 09:02:10 +08:00
parent 3d2e5f8165
commit beb88d5bea
388 changed files with 6436 additions and 25458 deletions

View File

@@ -1,6 +1,6 @@
# apps/backend — FastAPI 后端
为微信小程序和管理后台提供 RESTful API连接 `zqyy_app` 业务数据库,通过 FDW 只读访问 ETL 数据
为微信小程序和管理后台提供 RESTful API连接 `zqyy_app` 业务数据库,直连 `etl_feiqiu` ETL 库只读访问 `app.v_*` RLS 视图
## 技术栈
@@ -115,6 +115,8 @@ JWT 令牌分两种:
| `/api/xcx/tasks` | `xcx_tasks.py` | 小程序任务列表/详情/置顶/放弃/恢复 | JWT |
| `/api/xcx/notes` | `xcx_notes.py` | 小程序备注 CRUD | JWT |
| `/api/xcx/performance` | `xcx_performance.py` | 小程序绩效概览/明细 | JWT |
| `/api/xcx/config` | `xcx_config.py` | 小程序配置(项目类型筛选器等) | JWT |
| `/api/xcx/board` | `xcx_board.py` | 小程序三看板(助教/客户/财务) | JWT |
| `/api/admin/applications` | `admin_applications.py` | 管理端申请审核 | JWT |
| `/api/business-day` | `business_day.py` | 营业日配置查询 | JWT |
| `/api/tasks` | `tasks.py` | 任务注册表/Flow 定义/配置验证 | JWT |
@@ -126,6 +128,7 @@ JWT 令牌分两种:
| `/api/xcx-test` | `xcx_test.py` | MVP 全链路验证 | 无 |
| `/api/wx-callback` | `wx_callback.py` | 微信消息推送回调 | 签名验证 |
| `/api/retention-clue` | `member_retention_clue.py` | 维客线索 CRUD | JWT |
| `/api/xcx/chat` | `xcx_chat.py` | 小程序 CHAT 对话/消息/发送/SSE 流式 | JWT |
| `/api/ops` | `ops_panel.py` | 运维面板(服务启停/Git/系统信息) | 无 |
| `/ws/logs` | `ws/logs.py` | WebSocket 实时日志推送 | — |
| `/health` | `main.py` | 健康检查 | 无 |
@@ -149,12 +152,13 @@ JWT 令牌分两种:
| `task_manager.py` | 任务管理(置顶/放弃/状态变更) |
| `task_expiry.py` | 任务过期检查与处理 |
| `task_manager.py` | 任务管理CRUD + 列表扩展 + 详情) |
| `performance_service.py` | 绩效概览 + 明细(FDW 查询) |
| `performance_service.py` | 绩效概览 + 明细(ETL 直连查询) |
| `note_service.py` | 备注服务CRUD + 星星评分) |
| `fdw_queries.py` | FDW 查询集中封装(门店隔离 + DWD-DOC 规则 |
| `fdw_queries.py` | ETL 查询集中封装(直连 ETL 库 + 门店隔离 RLS |
| `note_reclassifier.py` | 备注重分类(召回完成后回填) |
| `recall_detector.py` | 召回完成检测ETL 数据更新触发) |
| `trigger_scheduler.py` | 触发器调度器cron/interval/event |
| `chat_service.py` | CHAT 模块业务逻辑(对话管理/消息持久化/referenceCard |
## 依赖