软件王国建造记

【用户故事】
作为「懒得记账的上班族」，我想要「3 秒记一笔账」，
以便「月末不用翻账单回忆钱花哪了」。

【MVP 范围】v1.0 只做三件事
1. 记录一笔收支（金额 + 分类 + 备注）
2. 看本月汇总（总收入 / 总支出 / 结余）
3. 数据本地保存，不做云同步（v2.0 再做）

【明确不做】登录注册、多人协作、报表图表、AI 分析……

【优先级】P0：记一笔、看汇总 | P1：编辑/删除 | P2：多账本

┌────────────────────────┐
│  轻记账            ＋记账 │   ← 右上角大大的「＋」
├────────────────────────┤
│  本月结余  ¥1,284.50      │
│  收入 ¥3,200   支出 ¥1,915  │
├────────────────────────┤
│  🍜 早餐      -12.00  今天 │
│  🚇 地铁      -4.00   今天 │
│  ☕ 咖啡      -28.00  昨天 │
│  ……                     │
├────────────────────────┤
│  首页   明细   我的         │   ← 底部 Tab 导航

POST /api/v1/records          # 记一笔账
{
  "type": "expense",          // income | expense
  "amount": 28,
  "category": "餐饮",
  "note": "和同事午饭"
}
→ 200 {
  "id": "rec_20260909_001",
  "message": "记好啦！"
}

GET /api/v1/records/summary?month=2026-09   # 本月汇总
→ 200 {
  "income": 3200.00,
  "expense": 1915.50,
  "balance": 1284.50
}

CREATE TABLE records (
  id         BIGINT PRIMARY KEY AUTO_INCREMENT,
  user_id    BIGINT      NOT NULL,        -- 谁记的账
  type       ENUM('income','expense') NOT NULL,
  amount     DECIMAL(10,2) NOT NULL,      -- 金额用 DECIMAL，别用 FLOAT！
  category   VARCHAR(32) NOT NULL,        -- 分类
  note       VARCHAR(200) DEFAULT '',
  created_at DATETIME NOT NULL DEFAULT NOW(),
  INDEX idx_user_month (user_id, created_at)  -- 按用户+时间查得飞快
);

$ git checkout -b feature/record-expense     # 从主分支拉出功能分支
$ git add . && git commit -m "feat: 记一笔支出"
$ git push origin feature/record-expense
$ git checkout main
$ git merge feature/record-expense            # 评审通过后合入主分支

# 规范的分支策略
# main      = 生产环境，永远可发布
# develop   = 开发主干
# feature/* = 功能分支
# hotfix/*  = 线上紧急修复

用例ID  场景            步骤                    预期结果            实际结果
TC-01  记一笔正常支出   金额28→选餐饮→保存    列表出现-28.00       ✅ 通过
TC-02  金额为0          输入0→保存            提示"金额须大于0"    ✅ 通过
TC-03  金额超长         输入99999999999999    提示"金额超出范围"    ❌ 失败
TC-04  小数精度         输入0.1→保存          显示0.10             ❌ 失败(显示0.0999…)
TC-05  连续快速点保存   1秒内点5次            只新增1条            ❌ 失败(新增5条!)

【Bug 等级】
P0 阻断：不能登录，必须马上修
P1 严重：记错账了，数据不对
P2 一般：界面错位、提示不友好
P3 轻微：文案错别字，攒着修

# .gitlab-ci.yml / GitHub Actions 一类的流水线配置
stages: [build, test, deploy]

build:
  stage: build
  script:
    - docker build -t ledger-app:$CI_COMMIT_SHA .   # 打包成镜像

test:
  stage: test
  script:
    - pytest tests/ -v                              # 自动跑全部测试

deploy:
  stage: deploy
  script:
    - kubectl set image deploy/ledger ledger-app=ledger-app:$CI_COMMIT_SHA
    # K8s 滚动更新：老版本一批批替换成新版本，用户无感知

【P1 告警】ledger-prod
 指标: 接口 /api/v1/records 5xx 错误率 12.4% (阈值 1%)
 时间: 2026-09-09 03:17
 影响: 用户记账失败，预计影响 800 用户
 值班: @小哲(新人，第一次被叫醒)  @老周

【排查三板斧】
1. 看监控大盘：内存、CPU、数据库连接数
2. 看日志：搜 error / exception / 慢查询
3. 判断：代码问题 → 回滚；容量问题 → 扩容；数据问题 → 找 DBA

-- 埋点：App 里每个关键动作上报一条日志
-- 事件：app_open（打开）、record_click（记一笔）、record_save（保存成功）

-- 漏斗：1000 人打开 → 450 人点记一笔 → 只有 120 人保存成功？
SELECT
  COUNT(DISTINCT CASE WHEN ev='app_open'     THEN uid END) AS 打开,
  COUNT(DISTINCT CASE WHEN ev='record_click' THEN uid END) AS 点了记一笔,
  COUNT(DISTINCT CASE WHEN ev='record_save'  THEN uid END) AS 保存成功
FROM events WHERE dt = '2026-09-09';
-- 结果：1000 → 450 → 120：450 人点了记一笔却只有 120 人保存成功
-- 结论：保存环节有问题！一查——分类选择页面太复杂，用户被劝退了

实验：记账按钮文案
  A 组：「记一笔」   点击率 3.2%
  B 组：「＋ 记一下」 点击率 5.8%   ← 胜出！
决定：全量切到 B，预计月记账笔数 +15%

实验纪律：
  一次只改一个变量 | 样本量要够 | 跑够时间再下结论 | 别拍脑袋

轻记账 Roadmap —— 2026 Q4
├─ v3.3（10月） 稳定性：修复 12 个遗留 Bug · 启动速度优化
├─ v4.0（11月） 云同步：多设备同步（用户呼声最高的需求！）
│               └ 需要新增：账号体系、后端存储、数据迁移
├─ v4.2（12月） AI 助手：拍照记账（接大模型 OCR）
└─ 长期         多账本 · 家庭共享 · 预算管理 · 导出报表

【版本迭代纪律】
  每版只做 1-2 个大需求 + 一批小优化
  线上问题永远优先于新功能
  发版后看数据验证，不行就回滚/调整