feat: add billing core models

progress.md

@@ -402,3 +402,31 @@
 - 阻塞：无代码阻塞。真实图片同步耗时仍未验证，已登记到 T-302/T-403；需要真实 `AI_KEY_ENCRYPTION_KEY`、AiModel/ModelAlias 与上游 key 后执行。
 - 决策：对外 `parameters` 不是任意直通上游，而是 provider 白名单安全参数；服务端固定字段优先，计费仍以能力别名/分辨率为准。未生效的全局 AI timeout 环境变量删除，避免运维误以为可通过 env 调整。
 - 下一步：领取 T-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 模型。
+
+## 2026-07-02 T-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 模型
+
+- 状态：DONE
+- 变更：
+  - `apps/users/models.py`：新增 `UserWallet`（一用户一钱包，`points_balance >= 0` DB 约束）与 `ApiKey`（`key_hash` SHA-256、`key_prefix`、active/revoked 状态、`create_for_user()` 只在创建时返回明文）。
+  - `apps/billing/models.py`：新增 `CallRecord`（user/api_key/operation/alias/model_used/result_ref/result_summary/status/latency，不含 provider raw/base64 字段）与 `PointsLedger`（recharge/consume/adjust/refund，非零 delta、`balance_after >= 0`，手工调整需 reason）。
+  - 新增迁移：`users.0003_apikey_userwallet`、`billing.0001_initial`，并已应用到当前 MySQL。
+  - `apps/users/admin.py`：注册 `UserWallet` / `ApiKey`，钱包余额只读，API Key 只显示 prefix 和 hash 摘要，不回显明文。
+  - `apps/billing/admin.py`：注册 `PointsLedger` / `CallRecord` 只读 admin，用于检索对账。
+  - `apps/billing/tests.py`：覆盖钱包非负约束、API Key 哈希与匹配、调用记录不含 raw 字段、流水约束与 admin 注册。
+  - 同步更新 `README.md`、`docs/00-ai-start-here.md`、`docs/04-architecture.md`、`docs/06-tasks.md`、`docs/api.md`、`docs/routes.md`、`docs/current-state.md`、`docs/project-brief.md`。
+- 验证：
+  - `./init.ps1`：通过，依赖同步与基础检查正常。
+  - `py -3.12 manage.py test apps.billing --noinput --keepdb`：通过，6 tests OK。
+  - `py -3.12 manage.py makemigrations --check`：通过，No changes detected。
+  - `py -3.12 manage.py migrate`：通过，应用 `users.0003_apikey_userwallet` / `billing.0001_initial`。
+  - `py -3.12 manage.py test apps.users apps.billing --noinput --keepdb`：通过，8 tests OK。
+  - `py -3.12 manage.py showmigrations users billing`：通过，`users.0001/0002/0003` 与 `billing.0001` 均为 `[X]`。
+  - `py -3.12 manage.py check`：通过，0 issues。
+  - `py -3.12 manage.py test --noinput --keepdb`：通过，34 tests OK。
+  - `py -3.12 -m compileall apps`：通过。
+  - `git diff --check`：通过，仅 Windows CRLF 提示。
+- 阻塞：无。
+- 决策：
+  - `UserWallet` / `ApiKey` 放在 `apps.users`，`PointsLedger` / `CallRecord` 放在 `apps.billing`；T-201 只建数据结构，不实现扣点服务、计费规则、充值订单或 API 鉴权。
+  - `PointsLedger.ref_order_id` 在 RechargeOrder 模型落地前先保留为索引化数值引用，充值任务落地时再正式关联或补迁移。
+- 下一步：领取 T-202 PricingRule / ExchangeRate 模型 + 计费计算。