# 管理端需求文档

## 1. 页面结构
- **VIP 系统**：含价格配置、充值记录与会员列表三块；价格修改需立即生效并同步到前端 `VIP_PRICE` 显示；列表支持手机号模糊检索。
- **公告管理**：支持公告的新增、编辑、发布、下线、置顶，字段包括标题、内容、标签、有效期、生效状态。
- **咨询回复**：列出店铺咨询，管理员可单次回复并标记已解决。
- **用户管理**：展示用户基本信息，支持编辑、启停（黑名单）。
- **用户配件管理**：适配用户提交的配件数据，允许管理员编辑品牌/型号/规格与图片链接。
- **供应商管理**：列表检索、创建、编辑供应商信息，含欠款字段展示。
- **主数据字典**：主单位、主类别维护入口，仅平台管理员可用。

## 2. 认证约束
- 所有接口通过 `AdminAuthInterceptor` 鉴权：优先 Bearer Token，其次 `X-Admin-Id`/`X-User-Id`。
- 请求必须携带 `X-Shop-Id`，缺省取 1；多租户数据严格隔离。
- 登录功能正在开发中，当前临时通过本地存储写入管理员 ID。

## 3. 功能约束
- 禁止硬编码配置值，价格、库存等需从后端接口读取。
- 上传图片统一调用 `/api/attachments`，返回的 `url` 需落库或直接引用。
- 所有列表接口支持分页（默认 `page=1&size=20`）；前端需预留分页扩展点。
- 删除功能未启用，均以启停或逻辑状态位代替。

## 4. 未完成功能
- 管理端登录页与权限粒度控制尚未上线。
- 配件审核流仅完成基础编辑，驳回/通过流程待接入。
- 公告板目前缺少多语言与富文本支持。