feat: finish phase 4 portal review fixes

progress.md

@@ -845,3 +845,29 @@
 - 变更：统一新增 T-505 后的下一步口径：因任务看板规则要求领取第一个 `TODO` 且依赖均 `DONE` 的任务，T-505 作为 Phase 4 用户端审核优化先于 T-401 执行；同步更新 `README.md`、`docs/00-ai-start-here.md`、`docs/current-state.md`、`docs/project-brief.md`、`docs/project-onepager.md`、`docs/06-tasks.md`、`docs/phase-4-review.md` 与本执行流水。
 - 验证：文档口径修正，无代码变更；执行 `git diff --check`。
 - 下一步：领取 T-505 Phase 4 用户端审核优化。
+
+## 2026-07-03 T-505 Phase 4 用户端审核优化
+
+- 状态：DONE
+- 变更：
+  - `apps/portal/static/portal/vendor/`：新增本地自托管 `bootstrap/bootstrap.min.css` 与 `qrcode/qrcode.js`，并随附许可证文件；`base.html` / `recharge.html` 改用 `{% static %}`，移除 jsdelivr 运行时依赖。
+  - `apps/portal/views.py`：新增 `paginate_records()`，充值记录与消费记录从固定 `[:50]` 切片改为 Django `Paginator` 分页。
+  - `apps/portal/templates/portal/includes/pagination.html`：新增分页片段；充值记录 / 消费记录页展示总数、每页数量、当前页和上一页 / 下一页。
+  - `apps/portal/tests.py`：新增本地静态资源断言、无 CDN 断言，以及充值记录 / 消费记录各 >50 条分页测试。
+  - `docs/06-tasks.md`：T-505 标记 DONE；P3 后续项登记到 T-403 或 Backlog：生产邮件配置、API Key 数量治理、充值下单频控、邮箱确认自动登录 / raw key session 策略复核、allauth W036 已知警告。
+  - 同步更新 `README.md`、`docs/00-ai-start-here.md`、`docs/03-tech-stack.md`、`docs/04-architecture.md`、`docs/api.md`、`docs/routes.md`、`docs/current-state.md`、`docs/project-brief.md`、`docs/project-onepager.md`。
+- 验证：
+  - `./init.ps1`：开工前通过；收尾通过。
+  - `py -3.12 -m py_compile apps\portal\views.py apps\portal\tests.py`：通过。
+  - `py -3.12 manage.py check`：通过，0 issues。
+  - `py -3.12 manage.py findstatic portal/vendor/bootstrap/bootstrap.min.css portal/vendor/qrcode/qrcode.js --verbosity 1`：通过，均找到本地 static 文件。
+  - `py -3.12 manage.py makemigrations --check --dry-run`：通过，No changes detected。
+  - `py -3.12 -m compileall apps config`：通过。
+  - `rg -n "cdn\.jsdelivr|jsdelivr|qrcode@1\.5\.4" apps\portal\templates apps\portal\static`：无命中。
+  - `py -3.12 manage.py test apps.portal --noinput --keepdb --verbosity 2`：通过，21 tests OK。
+  - `py -3.12 manage.py test apps.portal.tests.PortalAccountFlowTests.test_recharge_records_paginate_more_than_page_size apps.portal.tests.PortalAccountFlowTests.test_usage_records_paginate_more_than_page_size --noinput --keepdb --verbosity 2`：通过，2 tests OK。
+  - 尝试 `py -3.12 manage.py test apps.users apps.portal apps.api --noinput --keepdb --verbosity 2`：未取得单次全绿；第一次在 `setUpClass` 前远程 MySQL 超时，第二次跑过 users + portal + 多数 API 后 MySQL 出现 `OperationalError 2003/2013` / 连接重置，已通过用例无断言失败。
+  - 尝试 `py -3.12 manage.py test apps.api --noinput --keepdb --verbosity 2`：未取得单次全绿；36 个 API 测试已运行，多数通过，`BalanceApiTests.setUpClass` 因远程 MySQL `Packet sequence number wrong` 中断。`Test-NetConnection 43.128.3.240 -Port 3306` 后续显示端口可达，判断为远程 MySQL 间歇稳定性问题。
+- 阻塞：T-505 功能无阻塞；完整大套件单次全绿仍受远程 MySQL 连接稳定性影响。
+- 决策：T-505 仅处理审核报告 P2；P3 不在本轮实现，已登记到 T-403 或 Backlog。
+- 下一步：领取 T-401 运营后台完善。