85 lines
4.1 KiB
Markdown
85 lines
4.1 KiB
Markdown
# 总台管理基础能力（当前已完成）
|
||
|
||
## 访问入口
|
||
- 登录页：`/admin/login`
|
||
- 总台仪表盘：`/admin`
|
||
- 站点管理：`/admin/merchants`
|
||
- 商品巡检：`/admin/products`
|
||
- 订单监控：`/admin/orders`
|
||
- 系统配置：`/admin/settings/system`
|
||
- 渠道配置：`/admin/settings/channels`
|
||
|
||
## 当前定位
|
||
当前 `/admin` 已明确为 **总台管理（Platform Ops）**，面向平台运营方：
|
||
- 管理站点
|
||
- 查看总台视角的订单 / 商品 / 用户规模
|
||
- 承接全局系统配置与渠道配置骨架
|
||
- 为后续拆分站点后台、商家后台做边界准备
|
||
|
||
## 当前能力
|
||
- 总台管理登录（Session）
|
||
- 登录态校验中间件 `admin.auth`
|
||
- 总台统一布局模板与导航分组
|
||
- 总台仪表盘与总台定位说明
|
||
- 站点管理列表 + 新增站点
|
||
- 商品巡检列表 + 新增 / 更新 / 删除
|
||
- 订单监控列表 + 状态更新 + 详情页
|
||
- 系统配置页面已接入数据库读取（`system_configs`）
|
||
- 渠道配置页面已接入数据库读取（`channel_configs`）
|
||
- 支付配置基线已落库并在渠道配置页展示（`payment_configs`）
|
||
- Session 中已记录 `admin_role` / `admin_merchant_id` / `admin_merchant_id` / `admin_scope`，其中商家后台优先使用 `admin_merchant_id`，为后续总台 / 站点 / 商家三层后台边界做准备
|
||
|
||
## 演示账号
|
||
### 总台管理
|
||
- 邮箱：`platform.admin@demo.local`
|
||
- 密码：`Platform@123456`
|
||
- 作用域：总台管理员（`merchant_id = null`）
|
||
|
||
### 站点后台
|
||
- 邮箱：`merchant.admin@demo.local`
|
||
- 密码：`Merchant@123456`
|
||
- 作用域：站点管理员（当前绑定 `merchant_id = 1`，第一阶段复用 Merchant 承接）
|
||
|
||
### 商家后台
|
||
- 邮箱：`merchant.admin@demo.local`
|
||
- 密码：`Merchant@123456`
|
||
- 作用域：商家管理员（当前绑定 `merchant_id = 1`）
|
||
|
||
> 生产环境需要补独立权限体系、菜单权限控制、配置落库、操作审计，以及更细粒度的管理员角色权限。
|
||
|
||
## 当前三层后台边界
|
||
### 总台管理（`/admin`）
|
||
- 管站点
|
||
- 看总台视角订单 / 商品 / 用户规模
|
||
- 管系统配置、渠道配置、支付配置
|
||
- 仅允许 `merchant_id = null` 的总台管理员登录
|
||
- 面向平台运营方
|
||
|
||
### 站点后台（`/site-admin`）
|
||
- 当前先展示绑定站点范围内的数据
|
||
- 第一阶段继续复用 `Merchant / merchants / merchant_id` 作为站点承接层
|
||
- 已具备站点商品、站点订单的最小筛选与导出入口
|
||
- 仅允许绑定商家的管理员登录，并映射为站点作用域
|
||
- 面向站点运营人员
|
||
|
||
### 商家后台（`/merchant-admin`）
|
||
- 只展示当前登录商家的数据
|
||
- 当前商家后台会使用 `admin_merchant_id` 作为登录态中的商家作用域标识，并在数据查询时继续映射到底层 `merchant_id` 过滤：仪表盘、商品列表、订单列表、订单详情、订单状态更新、商品新增
|
||
- 仅允许绑定商家的管理员登录
|
||
- 面向商家运营人员
|
||
|
||
## 当前代码层封装进展
|
||
- `Admin` 模型已补充商家语义方法：`merchant()`、`merchantId()`、`isPlatformAdmin()`、`isMerchantAdmin()`
|
||
- 商家后台已新增 `ResolvesMerchantContext` trait，用于统一解析 `merchantId()`、`merchant()`、`merchantAdmin()`
|
||
- 站点后台已新增 `ResolvesSiteContext` trait，用于统一解析 `siteId()`、`site()`、`siteAdmin()`
|
||
- 商家后台控制器已开始改用封装后的商家上下文，而不直接在每个控制器里重复读取 session
|
||
- `Product` / `Order` / `User` 模型已新增 `forMerchant($merchantId)` scope，商家侧与站点侧查询开始用统一 scope 收口
|
||
- 商家后台已补充商品编辑 / 删除，以及商家用户列表页 `/merchant-admin/users`
|
||
|
||
## 下一步建议
|
||
1. 继续把站点后台从最小筛选 / 导出推进到更贴近运营流程的汇总与异常提示
|
||
2. 为总台站点管理到站点后台补更顺滑的链路设计（例如后续单独设计站点管理员体系或安全代入方案）
|
||
3. 给商家后台继续补订单筛选、商品分类、用户详情等经营能力
|
||
4. 给总台配置、渠道配置、支付配置补编辑能力与审计
|
||
5. 继续补齐 merchant 语义收口后的配置编辑、审计与权限细化
|