constitution.md
1.55 KB
mlaj 宪法
核心原则
用户需求为中心
- 以用户需求为中心,优先实现最小可用闭环,避免过度设计
修改尽量小且可回滚
- 修改应尽量小且可回滚,避免大范围重构
风格一致与复用优先
- 保持现有代码风格与目录结构一致,优先复用已有工具与组件
生产代码完毕后不要重启服务
- 生产代码完毕后不要重启服务
操作完成后不要自动打开预览
- 操作完成后不要自动打开预览
技术与工程约束
- 依赖管理使用 pnpm
- 构建工具使用 Vite
- 前端使用 Vue3(优先 setup 语法糖)
- 移动端 UI 优先使用 Vant
- 样式使用 Less;如果项目已引入 TailwindCSS,布局优先用 Tailwind 类名,细节用 Less 补充
- 路由使用 vue-router
- 状态管理使用 pinia(如项目已接入)
- 不引入不必要的新库;如必须新增依赖,需要在方案中说明原因与替代方案
接口与数据约束
- 所有网络请求返回对象结构必须为 { code, data, msg }
- code=1 表示成功,其他值表示失败;失败时保持 msg 可读
资源与链接约束
- 若图片域名为 cdn.ipadbiz.cn,需要自动追加 ?imageMogr2/thumbnail/200x/strip/quality/70
治理与管理
- 本宪法优先级高于临时约定与个人习惯;出现冲突时以本宪法为准
- 宪法变更应同步更新版本/日期信息,并确保对现有工程约束的兼容性
版本: [CONSTITUTION_VERSION] | 批准: [RATIFICATION_DATE] | 最后修订: [LAST_AMENDED_DATE]