Files
Agent-n8n/.serena/memories/08_项目维护和更新原则.md
Yep_Q c579dae90a feat: 完成化工订单班图片处理和项目记忆重组
详细说明:
- 化工订单班图片已标准化处理(8个图片,文件名与alt text完全一致)
- 完成环保、财经商贸订单班的图片重命名工作
- 重组项目记忆文件,按照功能模块编号(00-09)
- 删除旧的分散记忆文件,统一到新的编号体系
- 添加终端模拟文件:chemical.ts, environmental.ts, finance.ts
- 清理web_result冗余文件(food react-app等)
- 新增playwright截图记录和记忆文档
- 影响模块:订单班文档资料、项目记忆系统、终端模拟系统
2025-10-04 00:34:44 +08:00

3.3 KiB
Raw Permalink Blame History

项目维护和更新原则

核心原则

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. 版本控制建议

对于重大架构变更:

  1. 在记忆文件中保留历史版本说明
  2. 记录迁移路径
  3. 标注废弃的功能或方法

7. 记忆文件命名规范

  • 00-09基础和索引类
  • 10-19架构和系统类
  • 20-29功能模块类
  • 30-39订单班相关
  • 40-49问题和优化类
  • 90-99临时和实验性

8. 记忆更新检查清单

更新前检查:

  • 代码已测试通过
  • 影响范围已评估
  • 相关记忆已识别
  • 更新内容准备完整

更新后验证:

  • 主记忆已更新
  • 关联记忆已同步
  • 更新记录已添加
  • 版本信息已标注

特别提醒

Web Result 项目特别注意事项:

  1. 路由变更:必须同步更新 routes.yaml 说明
  2. 新订单班:必须更新订单班清单和实现方式
  3. 样式系统CSS 框架或动画系统变更需详细记录
  4. 性能优化:记录优化前后的对比和方法
  5. 部署配置:端口、路径等变更立即更新

记忆系统维护责任:

核心原则:代码变更与文档同步是项目可维护性的基础。 每次修改 web_result 或其他核心系统后,必须第一时间更新 Serena 记忆。


创建时间2024年12月 最后更新2024年12月 维护等级:最高优先级