架构

核心价值: 一人维护全栈，最大的风险是"只有你自己懂的代码"。工程实践让 AI 可以接手你的代码，也让你 6 个月后还能看懂自己写的东西。 3.1 架构决策：简单 > 完美 一人公司的架构原则 原则 1：现在付出的复杂度，未来由你独自维护 技术选型 维护成本 适用场景 单体 FastAPI 低 < 10 万用户 微服务 极高 > 50 人团队 K8s (K3s) 中 需要横向扩展时 无状态函数 (Lambda) 低，但有上限 流量极不稳定 PostgreSQL 低 几乎所有场景 Market Vault 的选择理由： FastAPI 单体 → 1 个容器，1 人可维护 PostgreSQL → 不引入 MongoDB/ElasticSearch，SQL 足够 Redis 纯缓存 → 不用作消息队列（目前规模不需要） Bunny CDN → 不自建存储，运营成本外包 3.2 代码分层：让 AI 在正确的层工作 标准 FastAPI 分层（Market Vault 模式） app/ ├── api/v1/ ← 路由层：只做参数验证 │ └── snapshots.py ├── services/ ← 业务逻辑：所有 DB 写入/查询 │ └── snapshot_service.py ├── models/ ← SQLAlchemy ORM 模型 │ └── snapshot.py ├── schemas/ ← Pydantic 请求/响应 schema │ └── snapshot.py └── core/ ← 横切关注点（安全、限流、CDN） ├── security.py └── limits.py 3.3 数据库：正确使用 SQLAlchemy 2 (async) 关键模式 正确的 async ORM 查询： ...