Files
xiaocai/DEV.md
wangxiaogang c7f29aa7a7 feat: 小菜记账 v1.0 - 完整功能实现
核心功能:
- 记账CRUD(支出/收入/分类/备注/日期)
- 统计分析(概览/分类占比/每日趋势)
- 预算管理(按月设置/进度条/超支提醒)
- 数据导出CSV

安全与认证:
- HMAC-SHA256签名token认证
- 用户数据隔离
- 输入验证与错误处理
- CORS配置

前端优化:
- 骨架屏加载
- 账单按日期分组
- 预算页面重构(快捷预设+Numpad)
- SvgIcon组件(H5+微信双端适配)
- 下拉刷新

后端优化:
- 共享日期工具函数
- 数据库连接池优化
- 健康检查端点
- 优雅关闭处理

技术栈:
- 前端:Uni-app (Vue 3 + Pinia)
- 后端:Node.js + Express + MySQL
2026-05-29 16:14:15 +08:00

1.8 KiB
Raw Blame History

通用原则

  • 优先保持现有代码风格与架构模式,不要无理由重构。
  • 任何功能或修复变更,需确保现有测试通过,必要时补充新测试。
  • 所有输出(代码、注释、文档、提交信息)默认使用简体中文,专有名词或技术术语可保留英文。

编码规范

文件与编码

  • 所有文件必须保持 UTF-8编码。
  • 修改包含中文的文件时,不得造成中文注释、中文文案、错误提示乱码。
  • 如果发现文件已有乱码,不要擅自猜测业务含义,应标记出来让人工确认。

测试要求

  • 新增功能必须编写对应的单元测试或集成测试。
  • 修复 Bug 时,先添加能复现问题的测试用例,再修复。
  • 测试覆盖率不应低于当前项目基线(若未设置,尽量保持 ≥80%)。
  • 测试命名清晰,能描述场景,如 should return error when user not found。

注释与文档

注释要求

  • 保留已有的重要注释如文件头说明、JSDoc、业务解释
  • 新增复杂逻辑、公共 API、关键算法时必须补充简洁的中文注释,解释“为什么这么做”而非“做了什么”。
  • 不要为了注释而注释,避免冗余的废话(例如 i++; // 自增 i)。
  • 多行 JSDoc/文档注释保持可读性,不要压缩成单行

Never 规则

  • Never 修改 dist/ 目录
  • Never 使用内联样式,除非需要动态计算
  • Never 在渲染路径中执行耗时操作
  • Never 在列表渲染中省略 key 属性
  • Never 修改 lock 文件
  • Never 使用 git stash
  • Never 切换分支
  • Never 过度封装,保持代码简洁明了

Requirements

  • 代码提交前检查代码,包括但不限于代码格式、注释、测试覆盖率等。