后端骨架已就绪 · 当前阶段仅包含架构与「村民档案」模块示范
本次交付的是可插拔架构骨架，不包含业务界面。 管理后台、村民端 H5、数据大屏等前端将按《全量功能清单》逐模块实现。 后端接口已按统一规范就绪，前端可直接对接。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/villagers | 分页列表（支持排序、筛选、关键字搜索） |
| GET | /api/v1/villagers/stat | 统计指标 |
| GET | /api/v1/villagers/{id} | 详情 |
| POST | /api/v1/villagers | 新增 |
| PUT | /api/v1/villagers/{id} | 修改 |
| DELETE | /api/v1/villagers/{id} | 删除（进回收站） |
| POST | /api/v1/villagers/{id}/restore | 从回收站恢复 |
| GET | /api/ext/villagers/summary | 对外接口（需 X-Api-Key） |
| 组件 | 默认实现 | 可切换 |
|---|---|---|
| 缓存 | 内存 LRU | redis |
| 队列 | 内存 channel | redis / rabbitmq（待实现） |
| 数据库 | PostgreSQL | mysql / dm / kingbase（方言已就绪） |
| 文件存储 | 本地磁盘 | oss / cos / minio（待实现） |
| AI 能力 | mock（测试） | deepseek / xiaomi / 本地大模型 |
| 加密 | AES-256-GCM | SM4 国密（已预留） |