vibe-coding-cn/libs/database/README.md

🗄️ libs/database：数据库适配层（预留）

libs/database/ 预留给未来的“存储适配层”。目标是把数据库的细节（连接、迁移、事务、查询）封装在一个清晰边界内，避免业务代码到处散落 SQL/ORM。

设计边界（先写清楚再实现）

• 这里负责：连接管理、迁移脚本、ORM/SQL 模型、统一的查询/事务封装
• 这里不负责：业务规则、HTTP/API 逻辑、领域对象的复杂编排

推荐目录结构（落地时按需取舍）

libs/database/
├── README.md
├── __init__.py
├── connection.py             # 连接与池化
├── migrations/               # 迁移脚本（Alembic/Flyway/自研均可）
├── repositories/             # 数据访问层（可选）
└── models/                   # ORM 模型或 SQL schema（可选）

何时开始实现

当仓库出现“需要长期保存/查询的数据”且 文件系统不够用 时，再把这一层落地；否则保持为空，避免过早引入复杂度。