caoxiaozhu 54356ba81a refactor(server): scene 注册表骨架 + 统一门控管道设计文档
Phase 1 P1.1-P1.2:为后端门控收口提供声明式场景注册基础设施。

- 新建 scenes/ 目录:gate_rules(GateRule/SceneRoute 枚举)、scene_descriptor(SceneDescriptor dataclass)、scene_registry(SceneRegistry 单例)
- 3 个场景迁入 descriptor:expense_application / reimbursement / query_travel_standard
- __init__.py 的 bootstrap_scenes 在 import 时注册 + 运行时绑定 handler/builder/executor(解决循环 import)
- 查询场景 priority=50 优先于 MODEL_ONLY 场景,确保规则匹配先于 LLM
- 落地 UNIFIED_GATE_PIPELINE.md 架构文档:目标架构 / 验收标准(接入 O(1))/ 3 阶段迁移路径
- 76 passed,scene 注册表未破坏现有代码;与 intent_registry 暂时并存,P1.3-P1.8 会统一迁移
2026-06-25 15:09:16 +08:00

X-Financial

项目结构已按前后端拆开:

  • web/:前端工程(当前 Vue + Vite 项目)
  • server/:后端工程目录
  • docs/:方案和阶段文档
  • UI/:界面参考稿
  • document/:业务文档

根目录统一环境变量:

  • .env
  • .env.example

这里集中维护:

  • 前端启动端口
  • 后端启动端口
  • PostgreSQL 连接参数
  • DATABASE_URL
  • REDIS_URL

从根目录统一启动:

./start.sh

可选模式:

./start.sh web
./start.sh server
./start.sh all

根目录 start.sh 是统一编排入口;前端和后端的子启动脚本分别是 web/web_start.shserver/server_start.sh

Docker Compose 运行方式见 docker/README.md

  • docker-compose.yml只启动主应用容器适合复用已有数据库、ONLYOFFICE 等外部依赖。
  • docker-compose.full.yml启动主应用、PostgreSQL、Qdrant、ONLYOFFICE 的完整本地开发栈。

手动进入前端目录:

cd web
npm run dev
Description
影子财务系统
Readme 106 MiB
Languages
JavaScript 44.9%
Python 42.9%
Vue 5.8%
CSS 4.7%
HTML 1.2%
Other 0.5%