AGENTS.md 1.9 KB

云璞官网维护说明

项目属性

  • 本仓库是已上线运行的云璞官网项目,稳定性优先于重构、统一风格或技术升级。
  • 当前生产代码基线必须在每次发布前从线上和远端仓库重新确认,不能仅依据本地副本判断。
  • 根目录 lonyue-web/ 是当前公众官网前端;LonYue-master/lonyue-ui/ 是后台管理端;LonYue-master/lonyue-admin/ 与 LonYue-master/LonYue-business/ 是后端启动及官网业务模块。
  • LonYue-master/lonyue-web/ 是较早的前端副本,除非任务明确指定,不作为当前官网修改目标。

修改约束

  • 修改前必须先说明问题根因、候选方案、影响模块、数据库或接口兼容性、验证方式和发布顺序,再实施变更。
  • 只做用户明确要求的增量功能和 Bug 修复,不顺手重构、优化、升级依赖、格式化无关文件或调整既有业务行为。
  • 优先沿用现有数据模型、接口、组件和页面结构;确需新增字段时,保留默认值和兼容回退,避免旧数据或接口异常导致页面不可用。
  • 变更范围必须可追溯,验证聚焦于修改文件及直接关联链路;发现范围外问题只记录和报告,未经确认不处理。
  • 不在本地开发或预览时写入生产数据。后台和后端默认配置可能连接线上服务,启动前必须核对目标环境。

发布约束

  • 默认只完成本地修改和验证,不自动提交、推送或部署。
  • 发布前必须回读线上最新后端程序、前端产物、数据库结构和远端分支,合并到线上最新基线后再构建。
  • 涉及数据库字段时,先确认兼容性并执行迁移,再发布依赖新字段的后端,最后发布后台与官网前端。
  • 发布后必须回读接口并完成实际业务回归;构建成功或接口返回成功不能替代功能验收。