# LiteMall 轻商城 - 版本说明

---

## 一、软件信息

| 项目 | 内容 |
|------|------|
| 软件全称 | LiteMall轻量级电商系统 |
| 软件简称 | LiteMall 轻商城 |
| 版本号 | V1.1.0 |
| 软件类别 | 通用型电商系统（应用软件） |
| 适用场景 | 实物商品/虚拟商品/服务类电商 |
| 技术栈 | Node.js + Express + SQLite + Vue 3 |
| 前端方案 | 管理后台(PC端) + 移动端H5 |
| 开发完成日期 | 2026-05-27 |
| 首次发表日期 | 未发表 |

---

## 二、功能清单

### 2.1 核心交易（5项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **商品管理** | 商品CRUD、多规格SKU、分类管理、上下架、商品复制、批量库存更新 | ✅ |
| **购物车** | 添加/删除/修改数量、全选/批量结算、SKU识别 | ✅ |
| **订单管理** | 下单/支付/发货/收货/完成、关单/取消、超时自动关闭、操作日志 | ✅ |
| **退款售后** | 退款申请、审核通过/驳回、退款类型（仅退款/退货退款/换货） | ✅ |
| **运费模板** | 按件计费、按重计费、包邮规则 | ✅ |

### 2.2 会员体系（4项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **会员等级** | 4级默认等级（普通→白银→黄金→钻石）、自定义等级、升级条件配置 | ✅ |
| **等级折扣** | 按会员等级自动折扣、折扣率自定义 | ✅ |
| **会员套餐** | 月卡/季卡/年卡/永久、购买自动升级、赠送经验值和优惠券 | ✅ |
| **经验值成长** | 消费/购买套餐获得经验值、自动升级 | ✅ |

### 2.3 分销体系（4项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **三级分销** | 一级/二级/三级佣金比例自定义、多级分销商等级 | ✅ |
| **团队管理** | 上下级绑定、团队列表、团队人数统计 | ✅ |
| **佣金结算** | 自动计算佣金、待结算/已结算管理、手动结算 | ✅ |
| **提现管理** | 提现申请、审核通过/驳回、冻结余额管理、提现记录 | ✅ |

### 2.4 营销工具（4项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **优惠券** | 满减券/折扣券/代金券、发放总量/每人限领、有效期管理、用户领券 | ✅ |
| **限时秒杀** | 定时上架、秒杀价格、库存管理、每人限购 | ✅ |
| **拼团购买** | 多人团购、最低成团人数、活动周期管理 | ✅ |
| **轮播广告** | 后台管理、排序、上下线、链接跳转 | ✅ |

### 2.5 AI客服（4项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **知识库管理** | 问答对管理、分类、关键词、权重排序 | ✅ |
| **自动回复** | 关键词匹配、权重排序、最相关问题返回 | ✅ |
| **会话管理** | 创建会话、消息记录、历史查看 | ✅ |
| **系统配置** | 开启/关闭、欢迎语、兜底回复、转人工提示 | ✅ |

### 2.6 系统管理（12项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **站点设置** | 名称/LOGO/描述/联系方式/备案号 | ✅ |
| **支付配置** | 微信支付（APPID/商户号/密钥）、支付宝（APPID/密钥/公钥） | ✅ |
| **分享设置** | 分享标题/描述/图片 | ✅ |
| **CMS页面** | 关于我们/隐私政策/服务条款/自定义页面 | ✅ |
| **模块开关** | 8大模块独立开启/关闭 | ✅ |
| **运营模式** | 测试模式/正式模式一键切换 | ✅ |
| **管理员管理** | 多管理员、角色权限（超管/运营/财务/客服） | ✅ |
| **数据备份** | 手动备份、自动备份、恢复、过期清理 | ✅ |
| **操作日志** | 管理员操作记录、模块筛选、分页 | ✅ |
| **登录日志** | 成功/失败记录、IP/UA记录、结果筛选 | ✅ |
| **运行日志** | 查看/清除服务端运行日志 | ✅ |
| **密码策略** | 最小/最大长度、复杂度检查 | ✅ |

### 2.7 数据统计（6项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **销售趋势** | 按日/周/月统计、图表展示 | ✅ |
| **热销商品** | 销量排行TOP、图表展示 | ✅ |
| **用户增长** | 每日新增用户趋势图 | ✅ |
| **会员统计** | VIP占比、等级分布、收入统计 | ✅ |
| **订单分布** | 各状态订单数量/金额分布 | ✅ |
| **数据导出** | 订单/用户/商品CSV导出 | ✅ |

### 2.8 安全防护（6项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| JWT认证 | 无状态Token认证、7天有效期 | ✅ |
| 密码加密 | bcrypt哈希存储 | ✅ |
| 防注入 | 参数清洗（SQL/XSS过滤） | ✅ |
| 限流 | 全局限流+登录频率限制 | ✅ |
| 安全头 | Helmet中间件、CORS | ✅ |
| 权限校验 | 角色权限、操作权限检查 | ✅ |

### 2.9 其他功能（4项）

| 功能 | 子功能 | 状态 |
|------|--------|------|
| **用户收藏** | 添加/取消收藏、收藏列表 | ✅ |
| **通知消息** | 系统通知、已读标记 | ✅ |
| **商品采集** | 多平台链接解析、采集API配置 | ✅ |
| **验证码** | 图形验证码、短信验证码（Mock） | ✅ |

---

## 三、API接口清单

### 3.1 管理后台接口（admin路由）

| 接口路径 | 方法 | 说明 |
|---------|------|------|
| /api/admin/login | POST | 管理员登录 |
| /api/admin/password | PUT | 修改管理员密码 |
| /api/admin/dashboard | GET | 仪表盘数据 |
| /api/admin/dashboard/chart | GET | 销售趋势图数据 |
| /api/admin/products | GET/POST | 商品列表/新增 |
| /api/admin/products/:id | GET/PUT/DELETE | 商品详情/更新/删除 |
| /api/admin/products/:id/status | PUT | 商品上下架 |
| /api/admin/products/:id/copy | POST | 复制商品 |
| /api/admin/products/batch-stock | POST | 批量更新库存 |
| /api/admin/categories | GET/POST | 分类列表/新增 |
| /api/admin/categories/:id | PUT/DELETE | 分类更新/删除 |
| /api/admin/orders | GET | 订单列表 |
| /api/admin/orders/:orderNo | GET | 订单详情 |
| /api/admin/orders/:orderNo/ship | POST | 发货 |
| /api/admin/orders/:orderNo/complete | POST | 完成订单 |
| /api/admin/orders/:orderNo/close | POST | 关闭订单 |
| /api/admin/users | GET | 会员列表 |
| /api/admin/users/:id | GET/PUT | 会员详情/编辑 |
| /api/admin/levels | GET/POST | 等级列表/新增 |
| /api/admin/levels/:id | PUT/DELETE | 等级编辑/删除 |
| /api/admin/plans | GET/POST | 套餐列表/新增 |
| /api/admin/plans/:id | PUT/DELETE | 套餐编辑/删除 |
| /api/admin/distribution/* | GET/POST | 分销管理（多个接口） |
| /api/admin/coupons | GET/POST | 优惠券列表/新增 |
| /api/admin/coupons/:id | PUT/DELETE | 优惠券编辑/删除 |
| /api/admin/seckill | GET/POST | 秒杀列表/新增 |
| /api/admin/group-buy | GET/POST | 拼团列表/新增 |
| /api/admin/config | GET/PUT | 系统配置/更新 |
| /api/admin/knowledge | GET/POST | AI知识库列表/新增 |
| /api/admin/banners | GET/POST | 轮播图列表/新增 |
| /api/admin/pages | GET | 页面列表 |
| /api/admin/pages/:id | GET/PUT | 页面详情/编辑 |
| /api/admin/shipping-templates | GET/POST | 运费模板列表/新增 |

### 3.2 用户端接口（user/product/cart/order等路由）

| 接口路径 | 方法 | 说明 |
|---------|------|------|
| /api/user/register | POST | 用户注册 |
| /api/user/login | POST | 用户登录 |
| /api/user/info | GET/PUT | 用户信息/更新 |
| /api/user/address | GET/POST | 地址列表/新增 |
| /api/user/address/:id | PUT/DELETE | 地址编辑/删除 |
| /api/user/favorite | POST | 添加收藏 |
| /api/user/favorites | GET | 收藏列表 |
| /api/product/list | GET | 商品列表（前端） |
| /api/product/detail/:id | GET | 商品详情（前端） |
| /api/product/hot | GET | 热销商品 |
| /api/product/new | GET | 新品推荐 |
| /api/cart/list | GET | 购物车列表 |
| /api/cart/add | POST | 加入购物车 |
| /api/order/create | POST | 创建订单 |
| /api/order/list | GET | 订单列表 |
| /api/order/detail/:orderNo | GET | 订单详情 |
| /api/order/:orderNo/pay | POST | 支付订单 |
| /api/order/refund | POST | 申请退款 |
| /api/membership/plans | GET | 会员套餐列表 |
| /api/membership/buy | POST | 购买会员 |
| /api/marketing/coupons | GET | 可领优惠券 |
| /api/marketing/coupon/receive | POST | 领取优惠券 |
| /api/marketing/seckill/list | GET | 秒杀列表 |
| /api/ai/conversation | POST | 创建AI会话 |
| /api/ai/message | POST | 发送AI消息 |
| /api/banner/list | GET | 轮播图列表 |
| /api/category/list | GET | 分类列表 |
| /api/captcha/image | GET | 验证码 |

---

## 四、数据库表结构（共30张表）

| 序号 | 表名 | 说明 | 关联 |
|------|------|------|------|
| 1 | users | 用户表 | 核心表 |
| 2 | user_levels | 用户等级表 | users.level_id |
| 3 | user_addresses | 收货地址 | users→addresses |
| 4 | membership_plans | 会员套餐 | — |
| 5 | user_memberships | 用户会员记录 | users/plans |
| 6 | products | 商品表 | 核心表 |
| 7 | product_skus | 商品SKU | products |
| 8 | product_specs | 商品规格 | products |
| 9 | product_images | 商品图片 | products |
| 10 | categories | 商品分类 | products |
| 11 | orders | 订单表 | 核心表 |
| 12 | order_items | 订单商品项 | orders/products |
| 13 | order_logs | 订单日志 | orders |
| 14 | payment_records | 支付记录 | orders |
| 15 | refunds | 退款记录 | orders |
| 16 | carts | 购物车 | users/products |
| 17 | distribution_config | 分销配置 | — |
| 18 | distribution_levels | 分销等级 | — |
| 19 | distribution_records | 佣金记录 | orders/users |
| 20 | withdraw_requests | 提现申请 | users |
| 21 | coupons | 优惠券 | — |
| 22 | user_coupons | 用户优惠券 | users/coupons |
| 23 | seckill_products | 秒杀商品 | products |
| 24 | group_buy_products | 拼团商品 | products |
| 25 | group_buy_orders | 拼团订单 | orders |
| 26 | ai_knowledge_base | AI知识库 | — |
| 27 | chat_conversations | 聊天会话 | users |
| 28 | chat_messages | 聊天消息 | conversations |
| 29 | system_config | 系统配置 | — |
| 30 | banners | 轮播图 | — |
| — | pages | CMS页面 | — |
| — | login_logs | 登录日志 | — |
| — | shipping_templates | 运费模板 | — |
| — | operation_logs | 操作日志 | — |
| — | notifications | 通知消息 | — |
| — | product_reviews | 商品评价 | — |
| — | user_favorites | 收藏 | — |
| — | search_history | 搜索历史 | — |

---

## 五、系统架构

```
litemall/
├── admin/                # 管理后台前端（Vue 3 + Element Plus）
│   └── index.html        # SPA单页应用
├── mobile/               # 移动端H5前端（Vue 3 + Vant 4）
│   └── index.html        # SPA单页应用
├── server/               # 后端服务（Node.js + Express）
│   ├── config/           # 配置
│   │   └── index.js      # 端口/密钥/路径配置
│   ├── public/           # 静态资源
│   │   └── lib/          # CDN库文件（离线备选）
│   ├── uploads/          # 上传文件目录
│   ├── data/             # 数据目录
│   │   ├── litemall.db   # SQLite 数据库
│   │   └── backup/       # 备份文件
│   ├── src/
│   │   ├── app.js        # 应用入口
│   │   ├── init-db.js    # 数据库初始化
│   │   ├── middleware/    # 中间件
│   │   │   ├── auth.js   # JWT认证
│   │   │   └── security.js # 安全防护
│   │   ├── routes/       # API路由（19个模块）
│   │   │   ├── admin.js      # 管理后台接口
│   │   │   ├── user.js       # 用户接口
│   │   │   ├── product.js    # 商品接口
│   │   │   ├── order.js      # 订单接口
│   │   │   ├── cart.js       # 购物车接口
│   │   │   ├── membership.js # 会员接口
│   │   │   ├── distribution.js # 分销接口
│   │   │   ├── marketing.js  # 营销接口
│   │   │   ├── ai.js         # AI客服接口
│   │   │   ├── payment.js    # 支付接口
│   │   │   ├── banner.js     # 轮播接口
│   │   │   ├── category.js   # 分类接口
│   │   │   ├── upload.js     # 上传接口
│   │   │   ├── config.js     # 配置接口
│   │   │   ├── stats.js      # 统计接口
│   │   │   ├── system.js     # 系统接口
│   │   │   ├── pagebuilder.js # 页面装修接口
│   │   │   ├── collector.js  # 商品采集接口
│   │   │   └── captcha.js    # 验证码接口
│   │   └── utils/
│   │       ├── db.js         # 数据库工具
│   │       └── response.js   # 响应格式化
│   ├── package.json
│   └── node_modules/
├── docs/                  # 文档目录
│   ├── 01-部署教程.md
│   ├── 02-管理员手册.md
│   ├── 03-支付对接指南.md
│   ├── 04-FAQ.md
│   ├── 05-版本说明.md
│   └── soft-copyright/    # 著作权申请材料
│       ├── application-info.md
│       ├── source-backend.txt
│       └── source-frontend.txt
├── start.sh               # 启动脚本
├── install.sh             # 安装脚本
└── README.md
```

---

## 六、更新记录

### V1.0.0 (2026-05-27) - 首个正式发布版本

**新增功能：**
- 完整商品管理（CRUD + 多规格SKU + 分类）
- 订单全流程管理（下单→支付→发货→收货→完成）
- 购物车管理（增删改 + 批量选择）
- 退款售后流程（申请→审核→通过/驳回）
- 多级会员体系（4个等级 + 等级折扣）
- 付费会员套餐（月卡/季卡/年卡）
- 三级分销系统（佣金 + 提现）
- 营销工具（优惠券/秒杀/拼团）
- AI客服知识库（关键词匹配 + 自动回复）
- 数据统计（销售趋势/热销/用户增长/订单分布）
- 系统管理（配置/备份/日志/权限/模块开关）
- 运营模式切换（测试/正式）
- 安全防护（JWT/限流/防注入/密码加密）
- 多管理员 + 角色权限
- 数据导出（CSV）
- 库存预警

**技术特性：**
- Node.js v22 + Express 后端
- Vue 3.5 + Element Plus 管理后台
- Vue 3.5 + Vant 4 移动端
- SQLite 数据库（零配置部署）
- 19个API路由模块，80+个接口
- 30张数据库表
- CDN引入，无需构建工具

---

## 七、后续迭代计划

| 阶段 | 内容 | 优先级 |
|------|------|--------|
| 1 | PC端独立商城（Vue3 + Element Plus 完整版） | 高 |
| 2 | 微信小程序端 | 高 |
| 3 | 正式支付通道对接（微信JSAPI/支付宝网页支付） | 高 |
| 4 | 多语言支持（中/英） | 中 |
| 5 | 插件市场（主题/支付/物流插件） | 中 |
| 6 | 商品评价系统增强 | 中 |
| 7 | 消息推送（短信/邮件/小程序订阅） | 中 |
| 8 | 数据分析报表增强 | 低 |
| 9 | Redis缓存支持 | 低 |
| 10 | MySQL/PostgreSQL数据库支持 | 低 |


---

## 三、V1.1.0 更新记录（2026-08-03）

### 功能补齐（相对 V1.0.0 精简版）

| 模块 | 说明 |
|------|------|
| 📝 **文章管理** | 文章CRUD、文章分类、帮助中心（后台「内容」菜单） |
| 🎨 **页面装修** | LiteDesign 可视化编辑器、模板管理、主题配色、素材管理、轮播图、链接管理 |
| 📦 **一键搬家** | 数据迁移门户、CRMEB/ShopXO/淘宝/拼多多等适配器、图片自动搬迁 |
| 🎁 **积分商城** | 积分商品兑换、兑换订单 |
| 💰 **会员储值** | 充值套餐、充值订单 |
| 🔔 **通知管理** | 8个通知场景模板、发送日志 |
| 👥 **会员体系** | 会员等级（4级+折扣）、付费套餐、经验值成长、积分 |
| 🤝 **分销进阶** | 三级分销、分销商等级、佣金日志、团队管理 |
| 🚀 **营销扩展** | 满减满送、拼团、预售、签到、优惠券 |
| 🧠 **AI增强** | AI运营助手、AI商品描述、AI评价分析、AI提示词库 |
| 📱 **全端适配** | APP管理、终端管控、多终端配置、微信小程序 |
| 🌐 **其他** | 多语言框架、下载管理、视频号解析、支付对账 |

### 修复
- 修复旧库升级时 users 表 `is_demo` 等列迁移失败问题（逐列独立迁移）
- 修复 `theme_customs` 表缺失导致主题管理 500 错误
- 移除部署环境不存在的 `/official` 官网静态路由

> ⚠️ 升级说明：直接覆盖安装（保留 server/data 目录），首次启动会自动建新表并迁移旧数据，不影响已有商品/订单/用户。
