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]