cmhub/docs/current-state.md

# 蠖灘燕螳樒鴫迥ｶ諤�

> 譛ｬ譁�弍蜿ｯ隕�尠逧�ｽ灘燕蠢ｫ辣ｧ�瑚ｮｰ蠖穂ｻ｣遐∽ｸ惹ｻｻ蜉｡逵区攸逧�鴫螳樒憾諤�ｼ悟ｸｮ蜉ｩ AI coding agent 驕ｿ蜈榊宵逵玖ｮ｡蛻定€悟ｿｽ逡･莉灘ｺ鍋鴫迥ｶ縲�
> 蜴�彰謇ｧ陦梧ｵ∵ｰｴ霑ｽ蜉�蛻ｰ [`../progress.md`](../progress.md)�御ｸ崎ｦ∝惠譛ｬ譁�㍾螟咲ｻｴ謚､螳梧紛謇ｧ陦梧律蠢励€�

## 閨瑚ｴ｣霎ｹ逡�

- [`06-tasks.md`](06-tasks.md)�壻ｻｻ蜉｡逵区攸�檎ｻｴ謚､莉ｻ蜉｡迥ｶ諤√€∽ｾ晁ｵ門柱鬪梧噺隕∫せ縲�
- [`../progress.md`](../progress.md)�壽鴬陦梧ｵ∵ｰｴ�悟宵霑ｽ蜉�隶ｰ蠖墓ｯ剰ｽｮ謇ｧ陦後€�ｪ瑚ｯ√€�仆蝪槫柱蜀ｳ遲悶€�
- `current-state.md`�壼ｽ灘燕蠢ｫ辣ｧ�悟庄隕�尠譖ｴ譁ｰ蠖灘燕逶ｮ蠖輔€∝ｽ灘燕蜻ｽ莉､縲∝ｷｲ螳梧�鞫倩ｦ∝柱荳倶ｸ€豁･縲�

## 蠖灘燕蠢ｫ辣ｧ

- 譌･譛滂ｼ�2026-07-03
- 髦ｶ谿ｵ�啀hase 5 蜷主床荳主書蟶�ｼ娜hase 3 蟇ｹ螟� API 荳主�蛟ｼ蟾ｲ螳梧�蛻ｰ T-306�訓hase 4 逕ｨ謌ｷ遶ｯ T-501 豕ｨ蜀� / 逋ｻ蠖包ｼ�llauth�峨€ゝ-502 API Key 閾ｪ蜉ｩ邂｡逅�｡ｵ縲ゝ-503 荳ｪ莠ｺ荳ｭ蠢� / 隶ｰ蠖暮｡ｵ荳� T-504 蜈�€ｼ鬘ｵ蟾ｲ螳梧��御ｸ倶ｸ€豁･ T-401 霑占是蜷主床螳悟埋
- 謚€譛ｯ譬茨ｼ夂ｳｻ扈� Python 3.12.3 + Django 5.2.15 + DRF 3.16.1 + django-allauth 65.18.0 + PyMySQL 1.1.3 + cryptography 46.0.7 + requests 2.34.2 + django-admin�娥ySQL 8.4 蟾ｲ謗･蜈･ settings�悟ｹｶ謾ｯ謖� `MYSQL_CONNECT_TIMEOUT` / `MYSQL_READ_TIMEOUT` / `MYSQL_WRITE_TIMEOUT`�帷畑謌ｷ遶ｯ蟾ｲ逕ｨ Django 讓｡譚ｿ SSR + Bootstrap + allauth 關ｽ蝨ｰ豕ｨ蜀檎匳蠖包ｼ幄ｯｦ隗� `03-tech-stack.md`
- 逕滉ｺｧ莉｣遐�ｼ壼ｷｲ譛画怙蟆� Django 蟾･遞矩ｪｨ譫ｶ�啻manage.py`縲～config/`�婬-002 蟾ｲ蛻帛ｻｺ `apps/users|portal|billing|ai|api`�婬-003 蟾ｲ謚願�螳壻ｹ� `User` 豕ｨ蜀瑚ｿ� django-admin�婬-004 蟾ｲ螳梧� email 蜚ｯ荳€諤ｧ縲（nit 迚域悽譁ｭ險€縲∥pp 鬘ｺ蠎上€～.env.example` 荳� `pyproject.toml`�婬-101 蟾ｲ譁ｰ蠅� `apps/ai/providers/`��rovider 謗･蜿｣縲∵ｳｨ蜀瑚｡ｨ縲…hat/gemini/images/images_edits 騾る�蝎ｨ�会ｼ婬-102 蟾ｲ譁ｰ蠅� `AiModel` / `ModelAlias`縲：ernet 蜉�蟇�ｯ�徴蟄伜お縲∝悪蜷崎ｧ｣譫舌€∥dmin 驟咲ｽｮ鬘ｵ縲～import_ai_models` 蟇ｼ蜈･蜻ｽ莉､�婬-103 蟾ｲ譁ｰ蠅� `AiConfigAuditLog` 螳｡隶｡陦ｨ縲∥dmin 蜿ｪ隸ｻ鬘ｵ髱｢蜥悟錘蜿ｰ菫晏ｭ�/蛻�髯､螳｡隶｡ hook�婬-104/T-105 蟾ｲ螳梧�蠖募宛 title/image smoke 荳主ｮ｡譬ｸ菫ｮ陦･�婬-201 蟾ｲ譁ｰ蠅� `UserWallet` / `ApiKey`縲～PointsLedger` / `CallRecord`縲∝ｯｹ蠎� admin 荳手ｿ∫ｧｻ�婬-202 蟾ｲ譁ｰ蠅� `PricingRule` / `ExchangeRate`縲～apps.billing.pricing` 隶｡雍ｹ隶｡邂怜�謨ｰ縲∥dmin 驟咲ｽｮ鬘ｵ荳手ｿ∫ｧｻ�婬-203 蟾ｲ譁ｰ蠅� `apps.billing.services`�悟ｮ樒鴫蟷ｶ蜿大ｮ牙�鬚�殴縲∵�蜉溽｡ｮ隶､荳主ｹらｭ牙､ｱ雍･騾€轤ｹ�婬-204 蟾ｲ譁ｰ蠅� `billing.0003_pointsledger_unique_ledger_change_type_per_call`�檎畑 MySQL 蜿ｯ關ｽ蝨ｰ逧� `ref_call + change_type` 螟榊粋蜚ｯ荳€郤ｦ譚溷�蠎暮亟驥榊､� refund�婬-301 蟾ｲ譁ｰ蠅� `apps.api.authentication.ApiKeyAuthentication` 荳� `ExternalApiView`�婬-302 蟾ｲ譁ｰ蠅樒函謌先磁蜿｣郛匁賜縲∝ｺ丞�蛹門勣縲∝崟迚�悽蝨ｰ蟄伜お蜥� `/api/v1/generate/title|image` 霍ｯ逕ｱ�婬-303 蟾ｲ譁ｰ蠅� `apps.billing.services.get_balance_snapshot()` 荳� `/api/v1/balance` 菴咎｢晄衍隸｢謗･蜿｣�婬-304 蟾ｲ譁ｰ蠅� `RechargeOrder`縲∝�蛟ｼ蝗櫁ｰ�ｪ檎ｭｾ騾る�蝎ｨ縲∝ｹらｭ牙�雍ｦ譛榊苅縲∝ｾｮ菫｡/謾ｯ莉伜ｮ晏屓隹�ｷｯ逕ｱ荳手ｿ∫ｧｻ `billing.0004_rechargeorder_and_more`�婬-305 蟾ｲ譁ｰ蠅� `create_recharge_order()`縲∝ｾｮ菫｡/謾ｯ莉伜ｮ晄沖遐∽ｸ句黒 mock/SDK 蜈･蜿｣縲～/api/v1/recharge/create` 荳� `/api/v1/recharge/status`�婬-306 蟾ｲ譁ｰ蠅� `apps.api.throttles`縲～apps.api.exceptions`縲～REST_FRAMEWORK` 螳牙�鮟倩ｮ､隶､隸√€∫函謌�/隶､隸∝､ｱ雍･髯先ｵ√€～image_url` SSRF 髦ｲ謚､荳主桃蠎泌､ｧ蟆丈ｸ企剞縲∝�蛟ｼ蜊慕ｬ秘≡鬚昜ｸ企剞�婬-501 蟾ｲ謗･蜈･ allauth�梧眠蠅� portal 霍ｯ逕ｱ縲∵ｳｨ蜀碁€る�蝎ｨ縲∫匳蠖�/豕ｨ蜀�/逋ｻ蜃ｺ讓｡譚ｿ蜥梧怙蟆� dashboard�梧ｳｨ蜀梧�蜉溷�蟒ｺ 0 轤ｹ髓ｱ蛹�ｸ比ｸ榊�襍�轤ｹ豬∵ｰｴ�婬-502 蟾ｲ譁ｰ蠅� `/apikeys`縲、PI Key 蛻帛ｻｺ陦ｨ蜊輔€∝�陦ｨ鬘ｵ蜥悟唖髯､�亥衰髞€�牙勘菴懶ｼ檎函謌仙錘譏取枚蜿ｪ譏ｾ遉ｺ荳€谺｡�悟�陦ｨ蜿ｪ譏ｾ遉ｺ prefix�婬-503 蟾ｲ謇ｩ螻� `/dashboard` 荳ｺ荳ｪ莠ｺ荳ｭ蠢�ｱ�€ｻ�悟ｹｶ譁ｰ蠅� `/records/recharge` 蜈�€ｼ隶ｰ蠖穂ｸ� `/records/usage` 豸郁ｴｹ隶ｰ蠖包ｼ悟宵隸ｻ螻慕､ｺ蠖灘燕逕ｨ謌ｷ謨ｰ謐ｮ�婬-504 蟾ｲ譁ｰ蠅� `/recharge` 鬘ｵ髱｢縲～RechargeCreateForm`縲∝�蛟ｼ蟇ｼ闊ｪ蜈･蜿｣蜥瑚ｽｮ隸｢閼壽悽�碁｡ｵ髱｢蛻帛ｻｺ pending 隶｢蜊輔€∝ｱ慕､ｺ莠檎ｻｴ遐∫･ｨ謐ｮ縲∬ｽｮ隸｢ `/api/v1/recharge/status`�瑚ｮ｢蜊� paid 蜷主姐譁ｰ菴咎｢�
- 豬玖ｯ包ｼ啜-504 蟾ｲ鬪瑚ｯ�ｼ啻./init.ps1` 蠑€蟾･蜑埼€夊ｿ�ｼ嫣py -3.12 -m py_compile apps\portal\forms.py apps\portal\views.py apps\portal\urls.py apps\portal\tests.py` 騾夊ｿ�ｼ嫣py -3.12 manage.py check` 騾夊ｿ�ｼ嫣py -3.12 manage.py makemigrations --check --dry-run` 譌�蜿伜喧�嫣py -3.12 -m compileall apps config` 騾夊ｿ�ｼ嫣py -3.12 manage.py test apps.portal --noinput --keepdb --verbosity 2` 騾夊ｿ�ｼ�19 tests OK�会ｼ嫣py -3.12 manage.py test apps.users apps.portal apps.api --noinput --keepdb --verbosity 2` 騾夊ｿ�ｼ�60 tests OK�会ｼ嫣./init.ps1` 謾ｶ蟆ｾ騾夊ｿ�ｼ嫣git diff --check` 騾夊ｿ�ｼ井ｻ� Windows CRLF 謠千､ｺ�峨€よｵ玖ｯ�/霑∫ｧｻ髦ｶ谿ｵ莉肴怏 allauth `account.EmailAddress` 譚｡莉ｶ蜚ｯ荳€郤ｦ譚溷惠 MySQL 荳贋ｸ榊庄蛻帛ｻｺ逧� `models.W036` 隴ｦ蜻奇ｼ帶悽鬘ｹ逶ｮ逕ｨ謌ｷ雍ｦ譛ｬ蜚ｯ荳€諤ｧ逕ｱ `user.email` 蜚ｯ荳€郤ｦ譚滓価諡�€�
- 謨ｰ謐ｮ�哂I 荳頑ｸｸ隹�畑荳取ｨ｡蝙矩�鄂ｮ蜿り€� `D:\chengma\cmbot`��src/services/ai_text_service.py`縲～ai_image_service.py`縲～config/ai_models.json`�会ｼ帷悄螳� `ai_models.json` 荳肴署莠､�碁怙騾夊ｿ� `import_ai_models` 蜻ｽ莉､蜉�蟇�ｯｼ蜈･
- 譬�㊥蜷ｯ蜉ｨ霍ｯ蠕�ｼ啗indows 逕ｨ `./init.ps1`�婉nix/WSL 逕ｨ `./init.sh`
- 譬�㊥鬪瑚ｯ∬ｷｯ蠕�ｼ啗indows 逕ｨ `py -3.12 manage.py check` / `py -3.12 manage.py test`
- 隶ｾ隶｡蝓ｺ郤ｿ��**閾ｪ蜉ｩ逕ｨ謌ｷ遶ｯ + 蟇ｹ螟� API + 霑占是蜷主床**荳牙粋荳€蜊穂ｽ難ｼ帷畑謌ｷ讓｡蝙� `User`(auth)/`UserWallet`(轤ｹ謨ｰ�碁煤 wallet 謇｣轤ｹ)/`ApiKey`(1:N�悟嶋蟶悟ｭ伜お)�帛ｯｹ螟紋ｸ､謗･蜿｣ + **閭ｽ蜉帛悪蜷� + Provider 騾る�蝎ｨ**�亥庄謠呈渠萓帛ｺ泌膚�会ｼ幄�蜉ｩ謇ｫ遐∝�蛟ｼ�帶ｳｨ蜀御ｸ埼€∫せ謨ｰ縲りｯｦ隗� `04-architecture.md` 荳� 2026-06-29 / 2026-07-01 逧� `progress.md` 蜀ｳ遲�
- 驟咲ｽｮ蝓ｺ郤ｿ�夊ｿ占｡檎識蠅�序驥城寔荳ｭ隗� `docs/env.md`�帷悄螳槫ｯ�徴/謾ｯ莉伜�隸∽ｸ榊ｾ怜�蜈･莉｣遐∵�譁�｡｣譬ｷ萓九€Ｂllauth 驍ｮ邂ｱ鬪瑚ｯ∝書菫｡逕ｱ `DJANGO_EMAIL_BACKEND` / `DJANGO_DEFAULT_FROM_EMAIL` 謗ｧ蛻ｶ�梧悽蝨ｰ鮟倩ｮ､ console backend�檎函莠ｧ髴€驟咲ｽｮ逵溷ｮ樣ぐ莉ｶ譛榊苅縲ょ�蛟ｼ隶｢蜊募惠蛻帛ｻｺ譌ｶ髞∝ｮ壽ｱ�紫荳朱｢�ｮ｡轤ｹ謨ｰ�悟屓隹��雍ｦ菴ｿ逕ｨ隶｢蜊募€ｼ�御ｸ肴潔譁ｰ豎�紫驥咲ｮ励€よ髪莉伜屓隹�ｸ惹ｸ句黒逕ｱ `PAYMENT_CALLBACK_MODE` 謗ｧ蛻ｶ�壽悽蝨ｰ/豬玖ｯ募庄逕ｨ HMAC `mock`�檎函莠ｧ蠎比ｸｺ `sdk`�帑ｺ檎ｻｴ遐∵悽蝨ｰ譛画譜譛滓署遉ｺ逕ｱ `PAYMENT_QR_EXPIRES_MINUTES` 謗ｧ蛻ｶ縲５-306 襍ｷ蟇ｹ螟� API 螳牙�驟咲ｽｮ蛹�性 `API_GENERATE_THROTTLE_RATE`縲～API_AUTH_FAILURE_THROTTLE_RATE`縲～IMAGE_URL_MAX_BYTES`縲～IMAGE_URL_MAX_REDIRECTS`縲～IMAGE_URL_CONNECT_TIMEOUT_SECONDS`縲～IMAGE_URL_READ_TIMEOUT_SECONDS`縲～RECHARGE_MAX_AMOUNT_CNY`縲�
- 蠖灘燕 blocker�啜-306 荳顔ｺｿ蜑� SSRF 鬟朱勦蟾ｲ菫ｮ螟搾ｼ幄ｿ懃ｨ� MySQL 霑樊磁莉榊庄閭ｽ蠕域�謌夜龍豁�ｶ�慮�悟ｮ梧紛豬玖ｯ暮怙鬚�蕗霎�柄譌ｶ髣ｴ蟷ｶ莨伜�逕ｨ `--keepdb` 荳ｲ陦瑚ｷ代€ょｾｮ菫｡/謾ｯ莉伜ｮ晉悄螳槫膚謌ｷ蟇�徴/隸∽ｹｦ荳守函莠ｧ SDK 萓晁ｵ紋ｻ榊ｾ�署萓�/螳芽｣�ｼ帷悄螳� AI 荳頑ｸｸ smoke 髴€隕∝�驟咲ｽｮ `AI_KEY_ENCRYPTION_KEY` 蟷ｶ蟇ｼ蜈･ AiModel/ModelAlias縲ょ崟迚�酔豁･逵溷ｮ櫁€玲慮鬟朱勦莉肴悴騾€�悟ｷｲ逋ｻ隶ｰ蛻ｰ T-403縲�

## 蠖灘燕逶ｮ蠖戊ｦ∫せ

| 霍ｯ蠕� | 迥ｶ諤� | 隸ｴ譏� |
| --- | --- | --- |
| `docs/` | 蟾ｲ譛� | 蜈ｨ螂� harness 譁�｡｣ |
| `AGENTS.md` / `CLAUDE.md` | 蟾ｲ譛� | 莉灘ｺ鍋ｺｧ蜈･蜿｣ |
| `progress.md` | 蟾ｲ譛� | 謇ｧ陦梧ｵ∵ｰｴ�悟ｷｲ隶ｰ蠖募､夊ｽｮ譁�｡｣蜀ｳ遲厄ｼ帛錘扈ｭ莉ｻ蜉｡扈ｧ扈ｭ霑ｽ蜉� |
| `init.sh` / `init.ps1` | 蟾ｲ譛� | 蜷ｯ蜉ｨ鬪瑚ｯ∝�蜿｣�悟ｷｲ蝗ｺ螳夂ｳｻ扈� Python 3.12 蜻ｽ莉､�悟ｹｶ譬｡鬪瑚ｧ｣驥雁勣迚域悽 `>=3.12,<3.14` |
| `requirements.txt` / `pyproject.toml` | 蟾ｲ譛� | `requirements.txt` 邂｡霑占｡御ｾ晁ｵ厄ｼ嫣pyproject.toml` 關ｽ蝨ｰ `requires-python`�婬-101 譁ｰ蠅� `requests`�婬-102 菴ｿ逕ｨ譌｢譛� `cryptography` 蛛� Fernet 蜉�蟇�ｼ婬-501 譁ｰ蠅� `django-allauth` |
| `config/`��jango 蟾･遞具ｼ� | 蟾ｲ譛� | T-001 蛻帛ｻｺ�悟性 settings / urls / wsgi / asgi |
| `apps/`��sers/portal/billing/ai/api�� | 蟾ｲ譛� | T-002 蛻帛ｻｺ�嫣apps/users` 蟾ｲ螳壻ｹ芽�螳壻ｹ� `User`�婬-003 蟾ｲ豕ｨ蜀� admin 荳� admin smoke test�婬-004 蟾ｲ扈� `User.email` 蜉�蜚ｯ荳€郤ｦ譚滂ｼ婬-101 蟾ｲ譁ｰ蠅� `apps/ai/providers`�婬-102 蟾ｲ譁ｰ蠅� `apps/ai/security.py`縲～aliases.py`縲～importers.py`縲［anagement command 荳� `ai.0001_initial` 霑∫ｧｻ�婬-103 蟾ｲ譁ｰ蠅� `apps/ai/audit.py` 荳� `ai.0002_aiconfigauditlog` 霑∫ｧｻ�婬-104/T-105 蟾ｲ譁ｰ蠅� `smoke_ai_generation` 蠖募宛 title/image smoke 蜻ｽ莉､�婬-201 蟾ｲ蝨ｨ users 關ｽ `UserWallet` / `ApiKey`�悟惠 billing 關ｽ `PointsLedger` / `CallRecord`�婬-202 蟾ｲ蝨ｨ billing 關ｽ `PricingRule` / `ExchangeRate` 荳� `pricing.py`�婬-203/T-303/T-304/T-305 蟾ｲ蝨ｨ `apps/billing/services.py` 關ｽ謇｣轤ｹ/騾€轤ｹ縲∽ｽ咎｢晏ｿｫ辣ｧ縲∝�蛟ｼ蜈･雍ｦ荳主�蛟ｼ荳句黒�婬-304/T-305 蟾ｲ蝨ｨ `apps/billing/payment_gateways.py` 關ｽ蝗櫁ｰ�ｪ檎ｭｾ縲［ock 荳句黒荳� SDK 蜈･蜿｣�婬-301~T-306 蟾ｲ蝨ｨ api 關ｽ驩ｴ譚�€∫函謌先磁蜿｣郛匁賜縲∝ｺ丞�蛹門勣縲∝崟迚�ｭ伜お縲∽ｽ咎｢晄衍隸｢縲∝�蛟ｼ蝗櫁ｰ�€∝�蛟ｼ荳句黒/迥ｶ諤∵衍隸｢縲～image_url` SSRF 髦ｲ謚､縲∫函謌�/隶､隸�剞豬∽ｸ守ｻ滉ｸ€ 429 髞呵ｯｯ蜩榊ｺ費ｼ婬-501 蟾ｲ蝨ｨ portal 關ｽ allauth 豕ｨ蜀�/逋ｻ蠖�/逋ｻ蜃ｺ霍ｯ逕ｱ縲∵ｨ｡譚ｿ縲∥dapter 荳� dashboard�婬-502 蟾ｲ蝨ｨ portal 關ｽ `/apikeys`縲、PI Key 蛻帛ｻｺ陦ｨ蜊輔€∝�陦ｨ讓｡譚ｿ荳主唖髯､�亥衰髞€�牙勘菴懶ｼ婬-503 蟾ｲ蝨ｨ portal 關ｽ荳ｪ莠ｺ荳ｭ蠢�ｱ�€ｻ縲∝�蛟ｼ隶ｰ蠖募柱豸郁ｴｹ隶ｰ蠖暮｡ｵ�婬-504 蟾ｲ蝨ｨ portal 關ｽ `/recharge` 蜈�€ｼ鬘ｵ縲∝�蛟ｼ陦ｨ蜊輔€∽ｺ檎ｻｴ遐∫･ｨ謐ｮ螻慕､ｺ蜥檎憾諤∬ｽｮ隸｢ |
| `manage.py` | 蟾ｲ譛� | T-001 蛻帛ｻｺ |
| `tests/` | 蠕�ｻｺ | 髫丞推莉ｻ蜉｡陦･蜈� |

## 莉ｻ蜉｡逵区攸迥ｶ諤�

莉ｻ蜉｡迥ｶ諤∽ｻ･ [`06-tasks.md`](06-tasks.md) 荳ｺ蜃�ｼ悟紙蜿ｲ謇ｧ陦瑚ｮｰ蠖戊ｧ� [`../progress.md`](../progress.md)縲�

- 蟾ｲ螳梧��啜-001 蛻晏ｧ句喧 Django + DRF 鬘ｹ逶ｮ鬪ｨ譫ｶ�婬-002 蟒ｺ遶� apps 逶ｮ蠖輔€∬�螳壻ｹ� User 荳朱�鄂ｮ�婬-003 謗･騾� django-admin 荳取怙蟆乗ｵ玖ｯ包ｼ婬-004 Phase 0 鬪ｨ譫ｶ螳｡譬ｸ菫ｮ陦･�婬-101 Provider 騾る�蝎ｨ螻� + 遘ｻ讀� cmbot 隹�畑�婬-102 AiModel + ModelAlias 讓｡蝙� + 蛻ｫ蜷崎ｧ｣譫撰ｼ婬-103 驟咲ｽｮ蜿俶峩螳｡隶｡�婬-104 霍鷹€壻ｸ€谺｡蠖募宛譬�｢倡函謌撰ｼ婬-105 Phase 1 AI 螻ょｮ｡譬ｸ菫ｮ陦･�婬-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 讓｡蝙具ｼ婬-202 PricingRule / ExchangeRate 讓｡蝙� + 隶｡雍ｹ隶｡邂暦ｼ婬-203 蟷ｶ蜿大ｮ牙�謇｣轤ｹ / 騾€轤ｹ�婬-204 Phase 2 隶｡雍ｹ譬ｸ蠢�ｮ｡譬ｸ蜉�蝗ｺ�婬-301 API Key 驩ｴ譚�ｼ婬-302 逕滓�譬�｢� / 蝗ｾ迚�磁蜿｣�婬-303 菴咎｢晄衍隸｢謗･蜿｣�婬-304 蜈�€ｼ蝗櫁ｰ�ｼ婬-305 謇ｫ遐∝�蛟ｼ荳句黒 + 霓ｮ隸｢�婬-306 Phase 3 蟇ｹ螟� API 螳牙�蜉�蝗ｺ�婬-501 豕ｨ蜀� / 逋ｻ蠖包ｼ�llauth�会ｼ婬-502 API Key 閾ｪ蜉ｩ邂｡逅�｡ｵ�婬-503 荳ｪ莠ｺ荳ｭ蠢� / 隶ｰ蠖暮｡ｵ�婬-504 蜈�€ｼ鬘ｵ�域沖遐� + 霓ｮ隸｢蛻ｰ雍ｦ�峨€�
- 豁｣蝨ｨ霑幄｡鯉ｼ壽裏縲�
- 蠖灘燕 blocker�夊ｿ懃ｨ� MySQL 霑樊磁蠖灘燕荳咲ｨｳ螳壽�蠕域��帶髪莉伜膚謌ｷ逵溷ｮ槫ｯ�徴/隸∽ｹｦ荳守函莠ｧ SDK 萓晁ｵ紋ｻ榊ｾ�署萓幢ｼ帷悄螳� AI 荳頑ｸｸ smoke 莉埼怙驟咲ｽｮ蟇�徴蜥梧ｨ｡蝙区焚謐ｮ蜷取鴬陦後€�
- 荳倶ｸ€荳ｪ蜿ｯ鬚�叙莉ｻ蜉｡��**T-401 霑占是蜷主床螳悟埋**縲�

## 蠖灘燕蜿ｯ霑占｡悟�螳ｹ

```bash
# Windows PowerShell
py -3.12 -m pip install -r requirements.txt
py -3.12 manage.py check
py -3.12 manage.py test
py -3.12 manage.py runserver
py -3.12 manage.py import_ai_models path\to\ai_models.json --create-default-aliases
py -3.12 manage.py smoke_ai_generation title --recorded
py -3.12 manage.py smoke_ai_generation image --recorded

# Unix / WSL
python3.12 -m pip install -r requirements.txt
python3.12 manage.py check
python3.12 manage.py test
python3.12 manage.py runserver
python3.12 manage.py import_ai_models path/to/ai_models.json --create-default-aliases
python3.12 manage.py smoke_ai_generation title --recorded
python3.12 manage.py smoke_ai_generation image --recorded
```

蠖灘燕蟇ｹ螟� API��

- `POST /api/v1/generate/title`
- `POST /api/v1/generate/image`
- `GET /api/v1/balance`
- `POST /api/v1/recharge/create`�育畑謌ｷ遶ｯ session + CSRF��
- `GET /api/v1/recharge/status`�育畑謌ｷ遶ｯ session��
- `POST /api/v1/recharge/callback/wechat`
- `POST /api/v1/recharge/callback/alipay`

蠖灘燕逕ｨ謌ｷ遶ｯ鬘ｵ髱｢��

- `GET/POST /signup`
- `GET/POST /login`
- `GET/POST /logout`
- `GET /dashboard`
- `GET/POST /recharge`
- `GET/POST /apikeys`
- `POST /apikeys/<id>/delete`
- `GET /records/recharge`
- `GET /records/usage`

蠖灘燕鬪ｨ譫ｶ蜿ｯ霑占｡後€５-002 蟾ｲ蝨ｨ鬥匁ｬ｡霑∫ｧｻ蜑榊�蟒ｺ閾ｪ螳壻ｹ� User�悟ｹｶ謖� `env.md` 謗･蜈･ MySQL 8.4 / utf8mb4�幄ｿ懃ｨ� MySQL 蟾ｲ螳梧� Django 蛻晏ｧ玖ｿ∫ｧｻ縲５-003 蟾ｲ謗･騾� django-admin�梧ｵ玖ｯ募庄蛻帛ｻｺ/髞€豈� `test_cmhub` 豬玖ｯ募ｺ難ｼ帛ｽ灘燕霑懃ｨ� MySQL 蟇ｹ鬚醍ｹ∝ｻｺ蠎�/髞€蠎謎ｻ榊庄閭ｽ髣ｴ豁�ｶ�慮�悟ｿ�ｦ∵慮逕ｨ `--keepdb` 荳比ｸｲ陦瑚ｷ第ｵ玖ｯ輔€５-004 蟾ｲ蠎皮畑 `users.0002_alter_user_email`�形user.email` 蟾ｲ譛牙髪荳€邏｢蠑輔€５-101 逧� AI provider 螻ょ宵蛛� HTTP 隹�畑荳主桃蠎碑ｧ｣譫撰ｼ婬-102 蟾ｲ謚� provider 霑占｡碁�鄂ｮ謗･蛻ｰ謨ｰ謐ｮ蠎� `AiModel` / `ModelAlias`�形resolve_alias()` 豈乗ｬ｡譟･蠖灘燕 active 驟咲ｽｮ蟷ｶ謖� `text` / `image` 閭ｽ蜉帶�｡鬪後€５-103 蟾ｲ陦･ `AiConfigAuditLog`�径dmin 菫晏ｭ�/蛻�髯､ `AiModel` / `ModelAlias` 譌ｶ隶ｰ蠖� actor縲∥ction縲》arget縲…hanged_fields縲…hanges縲…reated_at�悟ｯ�徴蜿ｪ隶ｰ蠖� empty/set 迥ｶ諤√€５-104/T-105 蟾ｲ逕ｨ荳ｴ譌ｶ蝗樊ｻ夐�鄂ｮ霍鷹€壼ｽ募宛譬�｢伜柱蠖募宛蝗ｾ迚�函謌舌€５-201 蟾ｲ關ｽ蝨ｰ髓ｱ蛹�€、PI Key縲∫せ謨ｰ豬∵ｰｴ蜥瑚ｰ�畑隶ｰ蠖包ｼ哂PI Key 譏取枚蜿ｪ蝨ｨ蛻帛ｻｺ helper 霑泌屓�悟ｺ灘�蜿ｪ蟄� hash/prefix�佞allRecord 蜿ｪ蟄� `result_ref`/`result_summary`�梧ｲ｡譛� provider raw 蟄玲ｮｵ縲５-202 蟾ｲ關ｽ蝨ｰ `PricingRule` / `ExchangeRate`�夊ｮ｡雍ｹ謖� `operation_type + alias + resolution` 譟･ active 隗���御ｼ伜�邊ｾ遑ｮ蛻�ｾｨ邇�ｼ悟�蝗樣€€鮟倩ｮ､莉ｷ�帷ｼｺ隗��謚� `NoPricingRuleError(code="no_pricing_rule")`�幃≡鬚晄困轤ｹ謨ｰ謖牙ｽ灘燕 active 豎�紫蜷台ｸ句叙謨ｴ縲５-203 蟾ｲ關ｽ蝨ｰ `precharge_call()` / `mark_call_success()` / `refund_call_points()`�夐｢�殴髞�蝶蛹�｡鯉ｼ御ｽ咎｢昜ｸ崎ｶｳ荳榊�隹�畑/豬∵ｰｴ�帛､ｱ雍･騾€轤ｹ髞∬ｰ�畑隶ｰ蠖募ｹｶ蟷らｭ牙� refund 豬∵ｰｴ縲５-204 蟾ｲ螳梧�螟榊粋蜚ｯ荳€郤ｦ譚溷刈蝗ｺ�悟ｹｶ蜿門ｾ嶺ｸ€谺｡螳梧紛 `manage.py test` 蜊墓ｬ｡蜈ｨ扈ｿ縲５-301 蟾ｲ關ｽ蝨ｰ `Authorization: Bearer <API_KEY>` 驩ｴ譚�ｼ壽�蜉溷錘 `request.user` 荳ｺ謇€螻樒畑謌ｷ縲～request.auth` 荳ｺ `ApiKey`�檎ｼｺ螟ｱ/譌�謨� Key 霑泌屓 401�檎畑謌ｷ謌� Key 遖∫畑霑泌屓 403�悟､夜Κ API 荳肴磁蜿� Web session縲５-302 蟾ｲ關ｽ蝨ｰ逕滓�謗･蜿｣�夊ｯｷ豎ょ悪蜷崎ｧ｣譫仙錘謖芽ｧ��隶｡雍ｹ�碁｢�殴謌仙粥謇崎ｰ�畑 Provider�梧�蜉溽｡ｮ隶､隹�畑隶ｰ蠖包ｼ形AiProviderError` / `AiCapabilityError` 遲牙､ｱ雍･霍ｯ蠕�ｼ夐€€轤ｹ�帛崟迚�ｻ捺棡菫晏ｭ伜芦譛ｬ蝨ｰ media 蟷ｶ霑泌屓 URL縲５-303 蟾ｲ關ｽ蝨ｰ菴咎｢晄衍隸｢謗･蜿｣�啻GET /api/v1/balance` 扈ｧ謇ｿ螟夜Κ API Key 驩ｴ譚�ｼ瑚ｯｻ蜿� billing 菴咎｢晏ｿｫ辣ｧ蟷ｶ霑泌屓 `user` 荳� `points_balance`�梧ｵ玖ｯ戊ｦ�尠菴咎｢昜ｸ取ｵ∵ｰｴ邏ｯ蜉�荳€閾ｴ縲５-304 蟾ｲ關ｽ蝨ｰ蜈�€ｼ蝗櫁ｰ�ｼ啻RechargeOrder` 菫晏ｭ倅ｸ句黒髞∝ｮ夂噪驥鷹｢�/豎�紫/轤ｹ謨ｰ�悟ｾｮ菫｡/謾ｯ莉伜ｮ晏屓隹��鬪檎ｭｾ蜀肴潔隶｢蜊募ｹらｭ牙�雍ｦ�碁㍾螟榊屓隹�ｸ埼㍾螟榊刈轤ｹ�碁≡鬚昜ｸ堺ｸ€閾ｴ荳榊�雍ｦ�帑ｸｻ蜉ｨ譟･蜊募�蠎募庄隹�畑 `query_and_apply_recharge_payment(order_no, query_func)` 螟咲畑蜷御ｸ€蜈･雍ｦ霍ｯ蠕�€５-305 蟾ｲ關ｽ蝨ｰ謇ｫ遐∽ｸ句黒荳手ｽｮ隸｢�夂畑謌ｷ遶ｯ session 逋ｻ蠖募錘蜿ｯ `POST /api/v1/recharge/create` 蛻帛ｻｺ pending 隶｢蜊募ｹｶ諡ｿ蛻ｰ mock/SDK 莠檎ｻｴ遐∫･ｨ謐ｮ�形GET /api/v1/recharge/status` 蜿ｪ霑泌屓譛ｬ莠ｺ隶｢蜊募ｹｶ蝨ｨ pending 譌ｶ蟆晁ｯ穂ｸｻ蜉ｨ譟･蜊戊｡･蜈･雍ｦ�妁PI Key 荳崎�隹�畑霑吩ｸ､荳ｪ逕ｨ謌ｷ遶ｯ謗･蜿｣縲５-306 蟾ｲ關ｽ蝨ｰ蟇ｹ螟� API 螳牙�蜉�蝗ｺ�啻image_url` 荳玖ｽｽ蝨ｨ謇｣轤ｹ蜑榊★蜊剰ｮｮ逋ｽ蜷榊黒縲∝�鄂大慍蝮€譬｡鬪後€�㍾螳壼髄騾占ｷｳ譬｡鬪悟柱蜩榊ｺ泌､ｧ蟆丈ｸ企剞�侫RF 蜈ｨ螻€鮟倩ｮ､荳榊�髫仙ｼ丞星逕ｨ Session/Basic�帷函謌先磁蜿｣謖� Key 髯先ｵ�ｼ瑚ｮ､隸∝､ｱ雍･謖� IP 髯先ｵ�ｼ帛�蛟ｼ荳句黒譛牙黒隨秘≡鬚昜ｸ企剞縲５-501 蟾ｲ關ｽ蝨ｰ allauth 豕ｨ蜀� / 逋ｻ蠖包ｼ啻ACCOUNT_EMAIL_VERIFICATION="mandatory"`�梧ｳｨ蜀梧�蜉溷�蟒ｺ 0 轤ｹ髓ｱ蛹�€∽ｸ榊�轤ｹ謨ｰ豬∵ｰｴ�帶悴鬪瑚ｯ�ぐ邂ｱ荳崎�蟒ｺ遶狗匳蠖� session縲５-502 蟾ｲ關ｽ蝨ｰ API Key 閾ｪ蜉ｩ邂｡逅�ｼ啻/apikeys` 逋ｻ蠖戊ｮｿ髣ｮ�檎函謌仙錘螳梧紛譏取枚蜿ｪ譏ｾ遉ｺ荳€谺｡�悟�陦ｨ蜿ｪ譏ｾ遉ｺ prefix�御ｸ肴仞遉ｺ hash 謌門紙蜿ｲ譏取枚�帛唖髯､荳ｺ蜷企楳 `revoked`�悟衰髞€蜷主､夜Κ API 霑泌屓 403縲５-503 蟾ｲ關ｽ蝨ｰ荳ｪ莠ｺ荳ｭ蠢�ｸ手ｮｰ蠖暮｡ｵ�啻/dashboard` 螻慕､ｺ蜑ｩ菴咏せ謨ｰ縲∝�蛟ｼ諤ｻ鬚昴€∝�雍ｦ轤ｹ謨ｰ縲∝〝豸郁€礼せ謨ｰ蜥梧怙霑題ｮｰ蠖包ｼ嫣/records/recharge` 螻慕､ｺ蠖灘燕逕ｨ謌ｷ蜈�€ｼ隶｢蜊包ｼ嫣/records/usage` 螻慕､ｺ蠖灘燕逕ｨ謌ｷ consume/refund 轤ｹ謨ｰ豬∵ｰｴ蟷ｶ蜈ｳ閨碑ｰ�畑菫｡諱ｯ�帶園譛蛾｡ｵ髱｢蝮�宵隸ｻ荳泌宵譟･譛ｬ莠ｺ縲５-504 蟾ｲ關ｽ蝨ｰ蜈�€ｼ鬘ｵ�啻/recharge` GET 螻慕､ｺ菴咎｢昴€∝�蛟ｼ�

## 蠑€蟋狗ｼ也�∝燕譽€譟･

1. 隸ｻ莉灘ｺ鍋ｺｧ `AGENTS.md` / `CLAUDE.md`縲�
2. 隸ｻ `docs/00-ai-start-here.md`縲�
3. 隸ｻ `docs/05-coding-rules.md`�亥ｰ､蜈ｶ隨ｬ 8 闃りｵ�≡螳牙��峨€�
4. 蝨ｨ `docs/06-tasks.md` 鬚�叙隨ｬ荳€荳ｪ `TODO` 荳比ｾ晁ｵ門插 `DONE` 逧�ｻｻ蜉｡�亥ｽ灘燕荳ｺ T-401�峨€�
5. 蟆�ｯ･莉ｻ蜉｡迥ｶ諤∵隼荳ｺ `DOING`縲�

## 扈ｴ謚､隗��

莉｣遐∫憾諤∝序蛹匁慮蜷梧ｭ･譖ｴ譁ｰ譛ｬ譁�ｼ壽眠蠅�/遘ｻ蜉ｨ蜈･蜿｣譁�ｻｶ縲∝�蟋句喧譯�楔謌匁ｨ｡蝮励€∽ｻｻ蜉｡迥ｶ諤∝序蛹悶€∵眠蠅槫庄霑占｡悟多莉､縲∝書邇ｰ譁�｡｣荳惹ｻ｣遐∽ｸ堺ｸ€閾ｴ縲�

- 莉ｻ蜉｡迥ｶ諤∝序蛹門酔豁･ [`06-tasks.md`](06-tasks.md)縲�
- 豈剰ｽｮ謇ｧ陦瑚ｮｰ蠖輔€�ｪ瑚ｯ∝多莉､縲�仆蝪槭€∝�遲冶ｿｽ蜉�蛻ｰ [`../progress.md`](../progress.md)縲�
- 譛ｬ譁�ｻｶ蜿ｪ菫晉蕗蠖灘燕蠢ｫ辣ｧ�御ｸ堺ｿ晉蕗螳梧紛蜴�彰縲�