详细说明: - 化工订单班图片已标准化处理(8个图片,文件名与alt text完全一致) - 完成环保、财经商贸订单班的图片重命名工作 - 重组项目记忆文件,按照功能模块编号(00-09) - 删除旧的分散记忆文件,统一到新的编号体系 - 添加终端模拟文件:chemical.ts, environmental.ts, finance.ts - 清理web_result冗余文件(food react-app等) - 新增playwright截图记录和记忆文档 - 影响模块:订单班文档资料、项目记忆系统、终端模拟系统
3.3 KiB
3.3 KiB
项目维护和更新原则
核心原则
1. Web Result 项目变更同步原则
重要性:⭐⭐⭐⭐⭐
任何 web_result 项目的变更都必须立即更新到 Serena 记忆系统中,确保文档与代码保持同步。
需要更新记忆的情况:
- ✅ 新增订单班展示页面
- ✅ 修改路由配置(routes.yaml)
- ✅ 更改服务器配置(app.js, server.js)
- ✅ 调整页面结构或样式
- ✅ 添加新的 JavaScript 模块
- ✅ 修改访问端口或路径
- ✅ 更新技术栈或依赖
- ✅ 优化性能或修复问题
更新方式:
# 当 web_result 项目发生变更时
1. 完成代码修改
2. 测试功能正常
3. 立即更新 Serena 记忆:
- 更新 "07_web_result项目架构和订单班展示系统.md"
- 记录变更内容、原因和时间
2. 终端模拟系统变更同步
终端模拟系统(exhibition-demo)的变更也需要同步更新:
- 更新 "02_终端模拟开发指南.md"
- 更新 "03_订单班配置清单.md"
3. 记忆更新规范
更新格式:
## 更新记录
### [日期] - [变更类型]
**变更内容**:
- 具体修改项1
- 具体修改项2
**影响范围**:
- 影响的功能模块
- 影响的订单班
**相关文件**:
- 修改的文件路径
4. 关联记忆维护
当一个系统变更时,需要检查并更新相关联的记忆:
| 系统模块 | 主记忆文件 | 关联记忆 |
|---|---|---|
| web_result | 07_web_result项目架构 | 01_项目概述、05_运行命令 |
| 终端模拟 | 02_终端模拟开发指南 | 03_订单班配置、06_问题解决 |
| SuperDesign | 04_SuperDesign工作流 | 07_web_result项目架构 |
| 订单班配置 | 03_订单班配置清单 | 02_终端模拟、07_web_result |
5. 变更通知机制
重大变更需要在相关记忆文件顶部添加通知:
> ⚠️ **重要更新** [日期]:[简述变更内容]
> 详见更新记录章节
6. 版本控制建议
对于重大架构变更:
- 在记忆文件中保留历史版本说明
- 记录迁移路径
- 标注废弃的功能或方法
7. 记忆文件命名规范
- 00-09:基础和索引类
- 10-19:架构和系统类
- 20-29:功能模块类
- 30-39:订单班相关
- 40-49:问题和优化类
- 90-99:临时和实验性
8. 记忆更新检查清单
更新前检查:
- 代码已测试通过
- 影响范围已评估
- 相关记忆已识别
- 更新内容准备完整
更新后验证:
- 主记忆已更新
- 关联记忆已同步
- 更新记录已添加
- 版本信息已标注
特别提醒
Web Result 项目特别注意事项:
- 路由变更:必须同步更新 routes.yaml 说明
- 新订单班:必须更新订单班清单和实现方式
- 样式系统:CSS 框架或动画系统变更需详细记录
- 性能优化:记录优化前后的对比和方法
- 部署配置:端口、路径等变更立即更新
记忆系统维护责任:
核心原则:代码变更与文档同步是项目可维护性的基础。 每次修改 web_result 或其他核心系统后,必须第一时间更新 Serena 记忆。
创建时间:2024年12月 最后更新:2024年12月 维护等级:最高优先级