PartsInquiry/doc/admin_requirements.md

管理端需求文档

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. 未完成功能

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