54356ba81a
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 会统一迁移
Server
后端已按 FastAPI + PostgreSQL + SQLAlchemy + Alembic 起好基础工程。
为什么先选 PostgreSQL
这个项目是报销、审批、员工、流程、审计记录为主，核心特点是：
- 强事务
- 多表关联明显
- 审批流和审计日志需要一致性
- 后续大概率要做复杂查询、统计和条件筛选
这类系统优先选关系型数据库更合适，PostgreSQL 是当前默认推荐。
Redis 要不要现在上
现在 不是必须。
先不把 Redis 作为启动前置，原因很直接：
- 当前第一阶段先把核心业务表、接口、权限、审批流跑通
- 如果一开始就把 Redis 绑死，会增加部署和排障复杂度
Redis 更适合后面这些场景：
- 登录态 / token 黑名单
- 热点数据缓存
- 限流
- 分布式锁
- 消息队列 / 后台任务
所以现在的策略是：
- 主数据库：
PostgreSQL - Redis：
可选能力，配置已预留，但不是必需依赖
目录
src/app/：应用代码alembic/：数据库迁移tests/：测试
启动
- 创建虚拟环境并安装依赖
cd server
python -m venv .venv
.venv\\Scripts\\activate
pip install -e .[dev]
- 在项目根目录准备环境变量
copy ..\\.env.example ..\\.env
- 启动服务
uvicorn app.main:app --reload --app-dir src
迁移
alembic upgrade head