wwjcloud-nest-v1/tools-v1/README.md

# Tools v1（针对 wwjcloud-nest-v1）

该目录为 `wwjcloud-nest-v1` 代码库的工程化工具与模板集合，提供：
- 快速启动指南（AI 恢复模块本地验证）
- apps/api 生产环境 `.env` 示例模板
- 与核心文档的交叉引用，便于团队上手与上线

## 目录
- `QUICK-START.md`：AI 恢复模块快速启动与验证
- `env/apps-api.production.example`：apps/api 生产环境示例 `.env`
- `php-tools/`：PHP → NestJS 迁移工具集（生成器与协调器）

## 适用范围
- 仅适配 `wwjcloud-nest-v1/apps/api`
- 与项目文档：`docs/AI-RECOVERY-DEV.md`、`docs/CONFIG_SETUP.md`、`docs/DEVELOPMENT-GUIDE.md`、`docs/PRODUCTION-DEPLOYMENT.md` 一致

## 快速链接
- AI 开发指南：`docs/AI-RECOVERY-DEV.md`
- 配置指南：`docs/CONFIG_SETUP.md`
- 开发指南：`docs/DEVELOPMENT-GUIDE.md`
- 生产部署：`docs/PRODUCTION-DEPLOYMENT.md`


## 脚本列表（从 tools/ 迁移）
- `scripts/php-file-discovery.js`
- `scripts/quality-assurance.js`
- `scripts/test-dict-fix.js`
- `scripts/test-fixes.js`
- `scripts/test-incremental.js`

### 使用示例
```bash
# 运行质量保障脚本
node tools-v1/scripts/quality-assurance.js

# 运行 PHP 文件发现
node tools-v1/scripts/php-file-discovery.js

# 运行迁移协调器（别名脚本，固定 scripts 路径）
node tools-v1/scripts/migration-coordinator.js

# Dry-run 预览迁移计划（别名脚本）
DRY_RUN=true node tools-v1/scripts/migration-coordinator.js

# 直接运行迁移协调器（主文件位于 php-tools）
node tools-v1/php-tools/migration-coordinator.js

# Dry-run 预览迁移计划（主文件）
DRY_RUN=true node tools-v1/php-tools/migration-coordinator.js

# 快速质量检查
node tools-v1/php-tools/generators/quality-gate.js quick
```