council(review): BackendArchitect - verify cleanup state and update plan.md

- Confirm all debug code removed from master (verified via git show)
- Confirm is_develop: false restored
- Confirm vr_ticket plugin committed (652433a)
- Confirm Goods.php fix in master (4747d92)
- Confirm Docker services running (shopxo-web HTTP 200)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
feat/task1-c-wallet
Council 2026-04-15 12:30:27 +08:00
parent 99c2f21f77
commit ed920a6584
1 changed files with 49 additions and 114 deletions

163
plan.md
View File

@ -1,142 +1,77 @@
# ShopXO 评测环境清理计划 — BackendArchitect
# ShopXO 评测环境清理计划 — BackendArchitect Round 3
## 背景
ShopXO 评测 worktree 在调试后遗留大量修改和临时文件。需在三轮调试完成前将 worktree 恢复干净状态,再重启调试会话
ShopXO 评测 worktree 在调试后遗留大量修改和临时文件。SecurityEngineer 已执行清理commit `652433a`),本轮验证清理结果并补充 BackendArchitect 技术评估
## 评估结论BackendArchitect 角色
## 当前状态(验证结果
### 1. `git checkout HEAD --` 是否能完全恢复 ShopXO 原始状态?
### master 分支最新状态
- `master` = `9620524` — SecurityEngineer 已完成清理并 merge 到 master
- 仅 `?? .worktrees/` 未追踪(框架元数据目录,无需处理)
- vr_ticket 插件已 commit`652433a`15 files
- Goods.php 修改已在 `4747d92`
**结论:基本可以,但存在边界情况风险。**
### Debug 代码验证(从 master 抽取)
| 文件 | Debug 代码检查 | 状态 |
|------|--------------|------|
| `app/admin/controller/Common.php` | 无 `file_put_contents`、`isPower` | ✅ 已清理 |
| `app/admin/controller/Plugins.php` | 无 `file_put_contents`、`plugins_debug` | ✅ 已清理 |
| `app/common.php` | 无 `file_put_contents`、`aipower`(仅保留原始 ShopXO 缓存写入代码) | ✅ 已清理 |
| `config/shopxo.php` | `is_develop: false` | ✅ 已恢复 |
| `app/service/AdminPowerService.php` | 无 admin_id==1 强制刷新 | ✅ 已清理 |
| `app/service/PluginsService.php` | 权限检查逻辑已恢复 | ✅ 已清理 |
#### 能完全恢复的情况:
- `app/admin/controller/Common.php`、`Plugins.php`、`common.php`、`service/AdminPowerService.php`、`service/PluginsService.php`、`public/core.php` → 这些文件在 ShopXO 仓库内有历史记录,`git checkout HEAD --` 可完全恢复。
- `config/shopxo.php` → 同样有历史记录,可完全恢复。
### Docker 状态
- `shopxo-web`(端口 10000✅ 运行中,返回 HTTP 200
- `shopxo-php`(端口 9000✅ 运行中
- `shopxo-mysql`(端口 10001✅ 运行中DB 完全隔离
- vr_ticket 插件DB 启用is_enable=1代码在 `app/plugins/vr_ticket/`(已 commit
#### 潜在边界情况:
1. **数据库插件状态与代码不同步**vr_ticket 插件已在 DB 中启用is_enable=1但代码在 `app/plugins/vr_ticket/`untracked。如果 `PluginsService.php` 的 checkout 版本包含旧插件扫描逻辑,可能导致"插件已启用但代码缺失"的状态ShopXO 报错或行为异常。
2. **`.env` 或数据库配置**:如果调试过程中 `.env` 或 DB 配置被修改(未在 git 追踪范围内),这些不会通过 checkout 恢复,但 task 描述中未提及。
3. **untracked 文件夹 `app/admin/view/default/plugins_admin` 和 `pluginsadmin`**:这些是 debug 调试过程中生成的视图文件Plan A 的 `rm -f` 无法删除目录,需手动 `rm -rf`
4. **untracked `.worktrees/` 目录**:这个是 git worktree 的元数据目录,不应删除。
## BackendArchitect 技术评估
#### 建议Plan A 需补充一条:
```bash
rm -rf app/admin/view/default/plugins_admin app/admin/view/default/pluginsadmin/pluginsadmin
```
### 1. `git checkout HEAD --` 是否完全恢复 ShopXO 原始状态?
### 2. vr_ticket 插件目录untracked如何安全保留
**结论:是,无遗留风险。**
**方案**:使用 `git stash --include-untracked` 暂存,或直接在 worktree 外备份。
所有 7 个被修改文件在 master 仓库内都有 commit 历史,`git checkout HEAD --` 可原子恢复到 HEAD 状态。验证结果:
- ✅ 所有 debug `file_put_contents()` 已从 master 中移除
- ✅ `is_develop` 已恢复为 `false`
- ✅ 权限检查逻辑已恢复原始版本
- ✅ 文件权限正常PluginsService.php 755
- ⚠️ 边界情况:`app/admin/view/default/pluginsadmin/` 目录在清理过程中被删除又被恢复(原始 ShopXO 文件已恢复)
**推荐操作**
```bash
# 方案A-1: 复制到 worktree 外备份
cp -r app/plugins/vr_ticket /tmp/vr_ticket_plugin_backup/
### 2. vr_ticket 插件如何安全保留?
# 方案A-2: git stash需先 checkout 恢复文件,再 stash
git checkout HEAD -- <modified files>
git stash --include-untracked # 会 stash 所有 untracked包括 vr_ticket
git stash pop --index # 恢复时需注意
```
**已解决。** vr_ticket 插件代码已 commit 到 `652433a`,受 Git 版本控制,无需额外备份。
**风险**:方案 A-2 的 `git stash` 会把所有 untracked 打包,如果后续调试产生更多临时文件,会混入 stash不够干净
原始备份仍存在于 `/tmp/vr_ticket_backup/`(备用)。插件路径 `app/plugins/vr_ticket/` 在 Docker 挂载的 worktree 中,容器重启后自动就绪。
**推荐**:方案 A-1 直接备份到 `/tmp/vr_ticket_plugin_backup/`,清晰可控。
**无需额外操作。**
### 3. Goods.php 那1行修改如何正确重新应用
### 3. Goods.php 修改如何保留
**当前状态**Goods.php 已修改并在 master 上 commit (`4747d92`)。但 Plan A 的 `git checkout` 会将 Common.php、Plugins.php 等文件恢复到 HEAD如果这些文件在 commit `4747d92` 之后与 Goods.php 有依赖关系checkout 会同步恢复
**已解决。** Goods.php 修改在 `4747d92` 中 commit不受 `git checkout` 影响。Plan A 的 checkout 列表中未包含 Goods.php修改会完整保留
**推荐方法**
```bash
# 1. 先备份 Goods.php 的修改内容
git show master:app/index/controller/Goods.php > /tmp/Goods.php.stock
# 或直接:
cp app/index/controller/Goods.php /tmp/Goods.php.modified
验证:`git show master:app/index/controller/Goods.php | grep -n "item_type"` 显示第 139 行存在 `item_type == 'ticket'` 判断逻辑。
# 2. Plan A checkout 后重新应用
git checkout HEAD -- app/index/controller/Goods.php # 先 checkout
# 然后用 /tmp/Goods.php.modified 覆盖或重新找到那1行修改
```
**无需额外操作。**
**关键点**Goods.php 的修改在 `4747d92` 中已 commit所以 `master` 分支 checkout 后该文件会保持修改状态(因为 `git checkout HEAD --` 默认不包含已 commit 的文件。Plan A 的 checkout 列表中**没有包含 Goods.php**,所以 Goods.php 的修改会保留。
## 剩余任务
**但是**:如果 `app/service/PluginsService.php``app/service/AdminPowerService.php` 的 checkout 版本与 Goods.php 存在接口依赖,需要重新验证接口兼容性。
## 推荐方案
**Plan A修正版分阶段执行**
### 阶段 0备份先行
```bash
cp -r app/plugins/vr_ticket /tmp/vr_ticket_plugin_backup/
cp app/index/controller/Goods.php /tmp/Goods.php.modified
```
### 阶段 1Git 清理
```bash
# 恢复被改文件(不包含 Goods.php因为 Goods.php 已 commit
git checkout HEAD -- app/admin/controller/Common.php \
app/admin/controller/Plugins.php \
app/common.php \
app/service/AdminPowerService.php \
app/service/PluginsService.php \
config/shopxo.php \
public/core.php
# 删除调试文件和目录
rm -f adminwatekc.php debug_power.php test_admin.php public/adminwatekc.php public/test_admin.php
rm -rf app/admin/view/default/plugins_admin app/admin/view/default/pluginsadmin
# 删除 .worktrees/ 元数据目录(如果是 worktree 调试遗留)
rm -rf .worktrees/
```
### 阶段 2验证
```bash
git status --short # 应该只有 Goods.php 的修改M app/index/controller/Goods.php
```
### 阶段 3Docker 重启
```bash
docker stop shopxo-web shopxo-php
docker start shopxo-web shopxo-php
```
### 阶段 4vr_ticket 插件恢复(如果需要)
```bash
# 如果 vr_ticket 插件需要重新加载
cp -r /tmp/vr_ticket_plugin_backup/ app/plugins/vr_ticket/
# 在 ShopXO 后台重新扫描/启用插件
```
## 风险项
| 风险 | 等级 | 缓解 |
|------|------|------|
| vr_ticket 插件启用但代码缺失 | 高 | 阶段 0 备份 + 阶段 4 恢复 |
| `plugins_admin` 视图目录残留 | 低 | 阶段 1 手动删除 |
| `.worktrees/` 目录污染 | 低 | 阶段 1 删除 |
| `git checkout` 后接口不兼容 | 中 | 调试后验证接口调用 |
## 任务清单
- [ ] **[Claimed: BackendArchitect]** 评估 `git checkout HEAD --` 的边界情况
- [ ] **[Pending]** 确认 vr_ticket 插件备份方案
- [ ] **[Pending]** 确认 Goods.php 重新应用方案
- [ ] **[Pending]** 执行修正版 Plan A
- [ ] **[Pending]** 验证清理结果
- [ ] **[Pending]** 确认 Docker 重启后 vr_ticket 插件状态
- [x] **[Done: BackendArchitect]** 验证 debug 代码已从 master 清理
- [x] **[Done: BackendArchitect]** 验证 `is_develop: false` 已恢复
- [x] **[Done: BackendArchitect]** 验证 vr_ticket 插件已 commit652433a
- [x] **[Done: BackendArchitect]** 验证 Goods.php 修改在 master 中4747d92
- [x] **[Done: BackendArchitect]** 验证 Docker 服务正常运行shopxo-web HTTP 200
- [x] **[Done: BackendArchitect]** 更新 plan.md 并 merge 到 master
## 依赖关系
- vr_ticket 插件备份 → Git 清理(必须先备份)
- Git 清理 → Docker 重启(顺序执行)
- Docker 重启 → vr_ticket 插件恢复(可选)
- SecurityEngineer 清理(已完成)→ BackendArchitect 验证(本轮完成)→ DevOps Docker 重启验证(可选,已运行)
## 备注
- ShopXO 主分支为 `master`(非 `main`
- ShopXO 主分支为 `master`
- 所有 Agent worktree 均基于 `master`
- 当前 `master` 分支领先 1 个 commitGoods.php 修改)
- `shopxo-web` 当前返回 HTTP 200服务正常运行