主题
Mall 商城系统 — 产品需求文档索引
版本：v3.1 ｜ 最后更新：2026-07 ｜ 文档状态：持续迭代中 技术栈：Spring Boot 3.5 + Vue 3 + MySQL 8.0 + Redis + MongoDB
1. 文档概述
本文档体系覆盖 Mall 商城系统的完整产品需求，分为前台（Portal） 和后台（Admin） 两大部分，共 19 份独立模块 PRD。每份 PRD 独立可读，包含完整的页面设计、字段规则、业务逻辑、状态流转、接口设计和数据模型，可直接用于开发。
术语说明
| 术语 | 说明 |
|---|---|
| SPU | Standard Product Unit，标准产品单元（如 iPhone 14） |
| SKU | Stock Keeping Unit，库存量单位（如 iPhone 14 黑色 128G） |
| Phase 1 | MVP 阶段，核心交易链路，已全部实现 |
| Phase 2 | 扩展阶段，多规格/促销/内容/会员体系，已全部完成 |
2. 前台模块（Portal）— 9 份
面向 C 端会员用户，运行在 mall-portal 服务（端口 8085），前端通过 /papi 代理转发。
| 编号 | 文件 | 模块 | 核心功能 | 状态 |
|---|---|---|---|---|
| 01 | 01-portal-homepage.md | 首页门户 | 轮播广告、分类导航、新品/热门/品牌推荐 | Phase 1 已实现 + Phase 2 推荐配置化 |
| 02 | 02-portal-recommendation.md | 商品推荐 | 品牌推荐、新品推荐、人气推荐、专题推荐 | Phase 1 硬编码 + Phase 2 可配置 |
| 03 | 03-portal-search.md | 商品搜索 | 搜索框、排序筛选、分类聚合 | Phase 1 MySQL LIKE；ES 待接入 |
| 04 | 04-portal-product.md | 商品展示 | 商品详情、规格选择、SKU、加购 | Phase 1 单规格 + Phase 2 多规格+评论 |
| 05 | 05-portal-cart.md | 购物车 | 购物车列表、数量调整、选中结算 | Phase 1 已实现 + Phase 2 多规格兼容 |
| 06 | 06-portal-order.md | 订单流程 | 确认订单、提交支付、订单列表/详情、物流 | Phase 1 已实现 |
| 07 | 07-portal-member.md | 会员中心 | 注册登录、个人信息、收货地址、收藏、积分 | Phase 1 基础 + Phase 2 完整体系 |
| 08 | 08-portal-aftersale.md | 客户服务 | 退货申请、退货列表、退货详情、退款进度 | Phase 1 已实现 |
| 09 | 09-portal-help.md | 帮助中心 | 帮助分类、帮助文章、举报入口 | Phase 1 已实现 |
前台页面现状：
mall-admin-web/src/views/portal/下共 20 个页面路由（公开 8 个：首页/注册/分类/搜索/商品详情/品牌/专题/帮助；需登录 12 个：购物车/确认订单/支付/订单列表/订单详情/售后/个人中心/地址/改密/收藏/浏览历史/优惠券）。
3. 后台模块（Admin）— 10 份
面向 B 端管理员/运营人员，运行在 mall-admin 服务（端口 8080），API 前缀 /api。
| 编号 | 文件 | 模块 | 核心功能 | 状态 |
|---|---|---|---|---|
| 10 | 10-admin-product.md | 商品管理 | 分类/品牌/属性/商品 CRUD/运费模板/审核/回收站 | Phase 1 已实现 + Phase 2 多规格 |
| 11 | 11-admin-order.md | 订单管理 | 订单列表/详情/发货/退货审核/操作日志 | Phase 1 已实现 |
| 12 | 12-admin-member.md | 会员管理 | 会员列表/详情/等级管理/积分管理/成长值 | Phase 1 基础 + Phase 2 完整体系 |
| 13 | 13-admin-promotion.md | 促销管理 | 秒杀活动、优惠券、满减促销 | ✅ 已完成 |
| 14 | 14-admin-operations.md | 运营管理 | 广告/品牌推荐/新品推荐/人气推荐配置 | Phase 1 基础 + Phase 2 完善 |
| 15 | 15-admin-content.md | 内容管理 | 专题管理、优选主题、帮助管理、话题管理 | Phase 1 帮助已实现 + Phase 2 专题/优选 |
| 16 | 16-admin-statistics.md | 统计报表 | 仪表盘、销售/商品/会员统计 | Phase 1 基础仪表盘；完整报表待开发 |
| 17 | 17-admin-finance.md | 财务管理 | 支付流水、退款管理、对账、财务报表 | 🔲 待开发 |
| 18 | 18-admin-permission.md | 权限管理 | 登录、管理员、角色、菜单、资源、操作日志 | Phase 1 已实现 + Phase 2 审计日志 |
| 19 | 19-admin-settings.md | 设置 | 订单设置、积分设置、运费模板、系统配置 | Phase 1 已实现 |
4. 通用规范
| 文件 | 说明 |
|---|---|
| mall_api_spec.md | API 接口规范：统一响应格式、状态码、认证方式、分页约定 |
| mall_data_dictionary.md | 核心数据模型：按业务域描述核心实体及关联关系 |
5. 数据库表与模块映射
数据库脚本 docs/sql/mall.sql 按前缀划分五个业务域（表数量以 docs/dev/context.md 第 3.1 节为准）。
| 前缀 | 模块 | 主要表 |
|---|---|---|
cms_ | 内容管理 | help, help_category, member_report, subject, subject_category, subject_comment, subject_product_relation, topic, topic_category, topic_comment, preference_area, preference_area_product_relation |
oms_ | 订单管理 | order, order_item, order_operate_history, order_return_apply, order_return_reason, order_setting, cart_item, company_address |
pms_ | 商品管理 | product, brand, product_category, product_attribute, product_attribute_category, product_attribute_value, product_category_attribute_relation, sku_stock, member_price, comment, comment_replay, feight_template, album, album_pic, product_ladder, product_full_reduction, product_vertify_record, product_operate_log |
sms_ | 营销管理 | home_advertise, home_brand, home_new_product, home_recommend_product, home_recommend_subject, flash_promotion, flash_promotion_session, flash_promotion_product_relation, flash_promotion_log, coupon, coupon_history, coupon_product_relation, coupon_product_category_relation |
ums_ | 用户管理 | member, member_level, member_receive_address, member_login_log, member_tag, member_task, member_rule_setting, member_statistics_info, member_member_tag_relation, member_product_category_relation, member_status_log, growth_change_history, integration_change_history, integration_consume_setting, admin, admin_login_log, admin_role_relation, admin_permission_log, role, menu, resource, resource_category, role_menu_relation, role_resource_relation |
注意：
ums_member_product_collection（商品收藏）不存在于 MySQL，收藏与浏览历史使用 MongoDB 存储。
6. 开发阶段
| 阶段 | 范围 | 状态 |
|---|---|---|
| Phase 1 | MVP 核心交易链路：权限/商品/订单/购物/帮助/退货 | ✅ 全部完成 |
| Phase 2-1 | 多规格商品（SPU/SKU 模型） | ✅ 已完成 |
| Phase 2-2 | 促销活动（秒杀 + 优惠券 + 满减） | ✅ 已完成 |
| Phase 2-3 | 内容管理（专题 + 优选 + 话题 + 帮助 + 举报） | ✅ 已完成 |
| Phase 2-4 | 会员体系（等级 + 积分 + 成长值 + 自动升降级） | ✅ 已完成 |
| Phase 2-5 | 前台增强（评论 + 收藏 + 浏览历史） | ✅ 已完成 |
| Phase 3+ | ES 搜索 / 微信支付 / 数据分析 / 多商户 / 移动端 / 第三方登录 | 🔲 待开发 |
7. 关键原则
- 已实现功能：基于实际代码和数据库表编写，标注 ✅ 已实现
- 待开发功能：基于已有数据库表和扩展需求编写，标注 🔲 待开发
- 接口设计：已实现的列出实际端点，待开发的基于现有模式设计
- 数据模型：引用实际表名和字段，不新增表（除非标注需要新建）
- 每份 PRD 独立可读：包含完整上下文，开发者无需跨文件查阅