用途:为后端系统与数据库设计提供结构化方法,产出可落地的架构与数据设计,并可用于软著或论文材料。
主要能力:模块划分(接口层/业务层/数据层)、职责边界与数据流转图;技术选型参考 FastAPI、Django REST、Spring Boot 的分层与配置;非功能性考虑性能(缓存/索引/分页)、可扩展与可观测。数据库方面支持 ER 图(实体、关系、基数)、表结构与约束、范式与反范式权衡、索引选型(B-Tree、GIN、BRIN、GiST、Hash)、迁移(Alembic、Prisma)与 ORM 防 N+1。接口方面遵循 RESTful/OpenAPI 3.x,含资源命名、状态码、版本化、schema 复用与错误码、分页约定。安全与运维涵盖认证授权、行级安全(RLS)、Redis 缓存策略、分级日志、统一异常、输入校验与限流、密钥管理,以及 Docker、K8s、Nginx、CI 部署要点。
使用方式:可用 scripts/er_diagram.py 将 YAML/JSON 表结构转为 Mermaid erDiagram,命令为 python scripts/er_diagram.py --in schema.yaml;迁移用 alembic revision --autogenerate 后人工审核,再 alembic upgrade head;生产建索引用 CREATE INDEX CONCURRENTLY,上线前用 EXPLAIN ANALYZE 验证。起手骨架见 templates/(schema.sql、openapi.yaml、rls_policy.sql、ci.yml)。
适用场景:科研系统、管理系统、数据分析/可视化平台、竞赛作品与软著项目。
限制:具体工具端点、语法与已知问题需查阅 references.md;网络暴露服务若无鉴权必须主动提示;资料未提供价格、平台与效果信息。