test(M01-B): 验证脱敏旧库迁移兼容

This commit is contained in:
Codex
2026-06-18 10:06:26 +08:00
parent 5117ae27d6
commit 1192dcb6b2
13 changed files with 5512 additions and 41 deletions
+21 -18
View File
@@ -1,10 +1,10 @@
# 自助棋牌室系统
本仓库是 `panda/qipai.git` 的单一 Monorepo 工作区。Windows 固定开发路径为 `D:\qipai`,当前权威开发总纲为 [`V5.2.md`](./V5.2.md)。详细功能、模块顺序、验收标准和 Codex 纪律以总纲及 `docs/` 为准。
本仓库是 `panda/qipai.git` 的单一 Monorepo 工作区。Windows 固定开发路径为 `D:\qipai`,当前权威开发总纲为 [`V5.3.md`](./V5.3.md)。详细功能、模块顺序、验收标准和 Codex 纪律以总纲及 `docs/` 为准。
## 固定约束
- 当前权威总纲:`V5.2.md`
- 当前权威总纲:`V5.3.md`
- 固定远端:`ssh://git@git.txyundm.cn:2222/panda/qipai.git`
- 默认分支:`main`
- 生产 API`https://api.txyundm.cn`
@@ -13,9 +13,8 @@
- 后台 Web`https://api.txyundm.cn/admin/`
- 正式 MQTT Broker`101.42.38.246:1883`
- 生产系统:Ubuntu Server 24.04 x86-64/amd64,无桌面、无 Docker、无微信云开发
- 后端运行时:Node.js 20+、npm 10+
- 部署入口:Ubuntu 执行 `sudo bash /opt/apps/setup.sh`
- 开发流程:Windows 本地开发与测试 → 完成一个模块 → 更新文档 → commitSSH push `origin/main`
- 开发流程:Windows 本地开发与测试 → 按 M00→M10 固定队列连续编码 → 每个子阶段测试/commit/SSH push/远端校验 → 自动进入下一子阶段
## 目录
@@ -36,7 +35,7 @@
| 用途 | 位置 |
|---|---|
| 项目入口 | `D:\qipai\README.md` |
| 当前总纲 | `D:\qipai\V5.2.md` |
| 当前总纲 | `D:\qipai\V5.3.md` |
| 完整配置索引 | `D:\qipai\docs\configuration.md` |
| 仓库目录映射 | `D:\qipai\docs\repository-map.md` |
| 后端开发配置 | `D:\qipai\backend\.env.development` |
@@ -100,31 +99,35 @@ WSL 已验证:EMQX `5.8.9`、MQTTX CLI `1.13.0`、EMQX 服务 `active (running
| Ubuntu 生产 | MQTT | `101.42.38.246:1883` | 待配置 | 待配置 | 禁止复用 WSL 凭据 |
| Ubuntu 生产 | MySQL | `127.0.0.1:3306` | 待配置 | 待配置 | 配置后写入 `/etc/qipai/qipai.secrets` 并同步更新本表 |
## Codex 工程优先纪律
- 默认流程:读取必要文档 → 选择一个未完成子阶段 → 先修改工程文件 → 测试 → 增量更新既有文档 → commit → push。
- 除用户明确要求只更新文档外,普通开发提交必须包含后端、后台、小程序、迁移、测试、脚本或部署配置中的实质工程变化。
- 只修改 Markdown 不得把模块标记为 `DONE`,不得增加功能完成数
- 禁止连续两个纯文档提交;同一模块子阶段只保留一份开发日志,补丁追加到原日志
- `docs/current-baseline.md` 使用 `audited_commit` 做增量核验,禁止每次重新生成全量审计
- 详细门禁见 `V5.2.md``0.0 工程编码优先与反文档循环硬门禁`
## 持续开发规则
- 唯一模块顺序:`M00 → M01 → M02 → … → M10`,模块内按 `A → B → C → …`
- `docs/module-status.md` 顶部的 `execution_cursor` 是唯一续接游标;Codex 不重新规划、不从 M00 重来
- 一个 commit 只完成一个子阶段;同一次 Codex 会话可连续完成多个相邻子阶段
- 每个子阶段必须完成工程编码、真实测试、增量文档、commit、push,并验证 `HEAD == origin/main`
- 完成一个子阶段后,在会话资源允许时自动继续下一子阶段,不询问“是否继续”。
- 纯 Markdown 变更不计业务进度;V5.3 文档提交后的下一次普通开发必须产生工程增量。
- 当前游标、最近工程提交和下一工程目标以 `docs/module-status.md``docs/current-baseline.md` 为准,不在 README 中猜测。
## 当前进度
项目已开发部分模块;具体完成度不得从 README 猜测,必须以现有代码、测试、数据库迁移、Git 历史以及 `docs/current-baseline.md``docs/module-status.md``docs/feature-status.md` 为准。
项目已开发部分模块;从 V4.8 切换到 V5.0 后仅新增少量内容。具体完成度不得从 README 猜测,必须以现有代码、测试、数据库迁移、Git 历史以及 `docs/current-baseline.md``docs/module-status.md``docs/feature-status.md` 为准。
- 最近工程提交:`8749a44 test(M01-B): 验证MySQL迁移往返`
- 下一工程目标:以 `docs/current-baseline.md``next_engineering_target` 为准,当前为 M01-B 脱敏旧库结构副本迁移与兼容读取验证。
- 开发纪律:普通“继续开发”必须产生工程文件变化、测试、commit 和 push;只改 Markdown 不计入模块进度
- 当前执行游标:`M01-C`
- 最近工程提交:`8749a44`;本轮完成 M01-B 脱敏旧库副本迁移与兼容读取验证。
- 下一工程目标:MySQL outbox、任务表和 PM2 worker 轻量异步任务基础
## 版本递进
- **V4.8**:固定 `D:\qipai``参考/`、Monorepo、Windows/WSL 协作和模块完成即推送。
- **V5.0**:固化 WSL EMQX 5.8.9、MQTTX CLI 1.13.0 和已有代码续接规则。
- **V5.1**:同步 README,明确全部配置位置、明文凭据登记和 README 随总纲递进规则。
- **V5.2**:增加工程编码优先、禁止文档循环、基线增量核验和工程证据门禁
- **V5.2**:增加工程编码优先、文档循环、增量审计和工程完成证据
- **V5.3**:增加固定模块队列、执行游标、会话内自动推进、可中断恢复和跨模块回归检查点。
## Codex 入口
```text
请阅读 V5.2.md,按当前进度继续开发。
请阅读 V5.3.md,按当前进度继续开发。
```