# 云璞官网维护说明

## 项目属性

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

## 修改约束

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

## 发布约束

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