116 lines
2.8 KiB
Markdown
116 lines
2.8 KiB
Markdown
# 🚀 炼妖壶项目迁移计划
|
|
|
|
## 🎯 目标
|
|
|
|
从混乱的当前项目状态迁移到干净、安全、可维护的新项目结构。
|
|
|
|
## 📍 迁移路径
|
|
|
|
```
|
|
当前位置: /home/ben/cauldron (混乱状态)
|
|
目标位置: /home/ben/liurenchaxin (全新开始)
|
|
```
|
|
|
|
## 📋 迁移步骤
|
|
|
|
### 阶段1: 文档准备 ✅
|
|
- [x] 创建需求规范
|
|
- [x] 制定迁移计划
|
|
- [ ] 完善设计文档
|
|
- [ ] 创建任务清单
|
|
|
|
### 阶段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%
|
|
|
|
---
|
|
|
|
**准备好开始迁移了吗？让我们带着这些文档，前往新的开始！** 🚀 |