# 权限、物流及系统基础设施全量集成报告

## 摘要
本次对 Admin 侧进行了大规模的基础设施补齐与核心管理模块重构。完成了权限管理（Auth/RBAC）、物流设置（Delivery Staff/Stations）、系统通用配置（ml_system_configs）以及数据概览（Statistic）与系统维护（Maintain）模块的端到端数据库接入。彻底解决了这些模块此前长期存在的 Mock 问题。

## 动机
虽然商城的业务模块（商品、订单等）已基本闭环，但支撑系统运行的“底座”模块（权限控制、系统开关、物流资源等）仍处于静态模拟阶段。为了实现生产级的管理后台，必须建立统一的配置存储体系、完善的权限分配机制以及真实的物流资源管理。

## 影响范围
- **核心底座**：系统配置读写、全站聚合统计。
- **权限安全**：角色管理、菜单权限树配置、管理员分配。
- **物流资源**：配送员库、提货点/核销点管理。
- **应用配置**：公众号、小程序、APP 及 PC 端参数持久化。

## 变更清单

### 1. 数据库资产 (SQL)
- **Schema (10_schema)**:
  - `admin/ml_system_configs_v1.sql`: 统一配置表。
  - `user/ak_auth_system_v1.sql`: 角色、权限、关联表 (RBAC)。
  - `delivery/ak_delivery_system_v1.sql`: 配送员、提货点表。
- **RLS (20_rls)**:
  - `admin/ml_system_configs_rls_v1.sql`
  - `auth/ak_auth_rls_v1.sql`
  - `delivery/ak_delivery_rls_v1.sql`
- **RPC (30_rpc)**:
  - **Admin**: `rpc_admin_system_config_get/save`, `rpc_admin_get_overall_stats`, `rpc_admin_get_system_info`。
  - **Auth**: `rpc_admin_get_admin_list`, `rpc_admin_get_role_list/save/delete`, `rpc_admin_get_permission_list/save/delete`。
  - **Delivery**: 配送员管理 (list/save/delete)、提货点管理 (list/save/delete)。

### 2. 前端服务层 (UTS)
- `services/admin/systemConfigService.uts` (新增)
- `services/admin/authService.uts` (新增)
- `services/admin/deliveryService.uts` (新增)
- `services/admin/maintainService.uts` (新增)

### 3. UI 页面重构 (去 Mock)
- **权限类**: `auth/admin.uvue`, `auth/role.uvue`, `auth/permission.uvue`。
- **物流类**: `delivery/staff.uvue`, `delivery/station.uvue`。
- **配置类**: `setting/system/config.uvue`, `app/wechat/config.uvue`, `app/routine/config.uvue`, `app/mobile/config.uvue`, `app/pc/config.uvue`。
- **综合类**: `statistic/index.uvue`, `maintain/sys/info.uvue`。

## 兼容性与风险
- **数据迁移**：启用 RLS 后，需确保管理员用户在 `ak_users` 中的 `role` 字段准确设置为 `admin`，否则将无法调用管理端 RPC。
- **逻辑依赖**：配送员和提货点管理依赖于 `ml_orders` 等核心表已存在。

## 回滚方案
1. 数据库：依次 DROP 刚才创建的 20 余个 RPC 函数及 5 张核心业务表。
2. 代码：通过 `git checkout` 恢复重构的 10 余个页面文件及 Service 目录。

## 验证方式
1. **统计验证**：进入“数据概览”，确认销售额、用户数等指标非 0 且与数据库一致。
2. **配置验证**：在“系统设置”修改网站名称并提交，刷新页面确认数据持久化。
3. **权限验证**：在“角色管理”添加新身份，确认能在“管理员管理”中进行分配。
4. **物流验证**：添加配送员后，确认列表分页展示正确且支持实时状态切换。

## 关联规范
- 遵循 `AGENT_PROJECT_SPEC.md` 规范。
- 对齐项目统一的角色鉴权与 RPC 分层口径。