# 仓库地图

| 路径 | 用途 | 提交策略 |
|---|---|---|
| `V4.8.md` | 当前开发总纲 | 必须提交 |
| `backend/` | 后端 API | 必须提交源码、测试和配置样例 |
| `admin/` | 后台管理端 | 必须提交源码，不提交构建产物 |
| `miniapp/` | 微信原生小程序 | 必须提交源码，不提交本地缓存 |
| `database/` | 数据库迁移和种子 | 必须提交脱敏 SQL |
| `deploy/` | 部署版本和说明 | 必须提交 |
| `deploy/nginx/` | API 域名 Nginx 模板 | 必须提交模板，不提交证书 |
| `deploy/certbot/` | API 域名证书签发和续期命令说明 | 必须提交命令说明，不提交证书或账户信息 |
| `deploy/emqx/` | EMQX 安装说明、ACL 模板和授权模板 | 必须提交模板，不提交设备账号、密码或运行数据 |
| `scripts/` | 检查、部署和运维脚本 | 必须提交 |
| `docs/` | 状态、日志、变更和验收记录 | 必须提交 |
| `docs/reference-page-map.md` | 旧小程序页面脱敏地图 | 必须提交 |
| `docs/db-schema-inventory.md` | 旧 SQL 表结构脱敏清单 | 必须提交 |
| `docs/reference-api-inventory.md` | 旧接口路径类别和迁移方向 | 必须提交 |
| `参考/` | 只读参考资料 | 经脱敏审计后提交；大文件按清单处理 |

## 边界

- 单一 Git 根：`D:\qipai`
- 固定远端：`ssh://git@git.txyundm.cn:2222/panda/qipai.git`
- 生产目录：`/opt/apps`
- 默认分支：`main`