liurenchaxin/docs/guides/MIGRATION_PLAN.md

🚀 炼妖壶项目迁移计划

🎯 目标

从混乱的当前项目状态迁移到干净、安全、可维护的新项目结构。

📍 迁移路径

当前位置: /home/ben/cauldron (混乱状态)
目标位置: /home/ben/liurenchaxin (全新开始)

📋 迁移步骤

阶段1: 文档准备 ✅

• 创建需求规范
• 制定迁移计划
• 完善设计文档
• 创建任务清单

阶段2: 环境准备

• 创建新项目目录
• 设置虚拟环境
• 配置Doppler (干净的配置)
• 建立Git仓库

阶段3: 核心功能迁移

• 迁移稷下学宫AI辩论系统
• 迁移Streamlit主界面
• 迁移数据库连接模块
• 迁移API集成代码

阶段4: 安全加固

• 实施密钥管理最佳实践
• 配置GitGuardian检查
• 设置pre-commit hooks
• 建立安全扫描流程

阶段5: 测试验证

• 功能测试
• 安全测试
• 性能测试
• 部署测试

🔒 安全原则

1. 零密钥原则 - 代码中绝不包含任何密钥
2. 环境变量优先 - 所有配置通过环境变量
3. Doppler集中管理 - 统一的密钥管理
4. 自动化检查 - 提交前自动安全扫描

📁 新项目结构

liurenchaxin/
├── app/                    # 应用入口
│   ├── streamlit_app.py   # 主界面
│   └── components/        # UI组件
├── src/                   # 核心代码
│   ├── jixia/            # 稷下学宫系统
│   ├── database/         # 数据库模块
│   └── api/              # API集成
├── config/               # 配置管理
│   └── settings.py # Doppler配置
├── tests/                # 测试代码
├── docs/                 # 文档
├── scripts/              # 工具脚本
└── .kiro/               # Kiro配置
    └── specs/           # 规范文档

🚫 不迁移的内容

• 历史实验代码
• 重复的功能实现
• 过时的依赖
• 混乱的配置文件
• 包含密钥的文件
• 无用的调试脚本

✅ 迁移检查清单

功能验证

• AI辩论系统正常工作
• Streamlit界面完整显示
• 数据库连接成功
• API调用正常
• 配置加载正确

安全验证

• GitGuardian扫描通过
• 无硬编码密钥
• Doppler配置正确
• 环境变量隔离
• 访问权限合理

质量验证

• 代码风格一致
• 文档完整
• 测试覆盖充分
• 性能满足要求
• 部署流程顺畅

🎉 成功标准

迁移成功的标志：

1. 新项目通过所有安全扫描
2. 核心功能100%可用
3. 启动时间 < 30秒
4. 代码质量 A级
5. 文档完整度 > 90%

---

准备好开始迁移了吗？让我们带着这些文档，前往新的开始！ 🚀