docs: 重构方案 v2 更新 P4 状态（地基+标杆完成，铺开中）

重构方案-v2.md

@@ -354,7 +354,7 @@ from src.core.database import db                # 统一 db 单例
 | **P1 工具链** | pyproject.toml / requirements-dev.txt / .flake8 / .pre-commit / Makefile / pytest 骨架 | 现有代码 `flake8` 通过（或登记存量告警）；`pytest` 空跑通过。**已登记存量告警：154 条（F401×111 / E402×36 / 其余 7）；pytest 5 passed** | 低 |
 | **P2 core+common** | 建 `src/core/` `src/common/`；extensions/utils 打 shim；模型聚合器建 `src/models_registry.py` | 已验收：22 模型表全量识别且 DB 全部存在；src/ flake8 零告警；pytest 5 passed；应用启动；/login 表单校验与 /user/page 鉴权拦截冒烟正常。**基线修复**：application/models + middleware 原被嵌套 `.gitignore`（`*`）误排除，已补入。**登记既有缺陷**：① `flask db` CLI 因 .env 的 FLASK_VERSION 与 --version 冲突报错（Makefile 已加 FLASK_SKIP_DOTENV 规避）；② 本机 Redis 未设密码但 REDIS_AUTH=True，/captcha 报 AUTH 错误（环境问题，非重构） | 高（依赖面最大，已完成） |
 | **P3 模块搬迁** | 按 §2.5 顺序逐组迁移 23 个模块（models→forms→services→views），每批打 shim + 验证 | 已验收：22 模型→19 模块 models.py；23 表单→schema.py；29 服务→service.py（含 executor/scheduler_service/mail_service/sms_service）；26 视图→router.py（login+index 合并入 auth）。应用启动、25 蓝图无重复注册（views/__init__.py 已加去重）、pytest 5 passed、接口冒烟（登录校验/鉴权 401）正常 | 中（已完成） |
-| **P4 服务层改造** | 26 个服务文件改「入参数据/出参数据」；router 取参包 R；引入 base_service/base_repository + BizError | 核心服务（auth/user/role/menu）单测可写可跑；接口回归全绿 | 高（最大工作量） |
+| **P4 服务层改造** | 26 个服务文件改「入参数据/出参数据」；router 取参包 R；引入 base_service/base_repository + BizError | **P4a 地基已完成**：BizError/base_repository/base_service + 全局处理器接入。**P4b 标杆（position）已完成**：服务函数入参数据/出参数据、raise BizError、repository 层、7 个单测（无需 DB 可测）。**待铺开**：其余 ~25 个服务按 position 范式批量改造 + 单测 | 高（P4a/P4b 已完成，铺开中） |
 | **P5 DI 注入** | core/permission.py + op_log 接口化；app 工厂注入 menu 服务 | `grep -r "from application" src/core/` 为空；权限/日志行为与现状一致 | 中 |
 | **P6 API v1** | routes/v1.py + `/api/v1`；白名单/内部调用/前端前缀同步 | 全部接口路径 `curl /api/v1/...` 通过；`/login` 白名单放行 | 中 |
 | **P7 切尾** | 删除 application/extensions/utils；`src/wsgi.py`；gunicorn.conf 指向 src.wsgi；更新 CLAUDE.md | `gunicorn -c gunicorn.conf.py src.wsgi:app` 启动；全量回归 | 高 |