# 计算机软件著作权登记 - 申请信息

## 一、软件基本信息

| 项目 | 内容 |
|------|------|
| **软件全称** | LiteMall 轻商城系统 |
| **软件简称** | LiteMall 轻商城 |
| **版本号** | V1.0 |
| **开发完成日期** | 2026-05-28 |
| **首次发表日期** | 未发表 |
| **软件分类** | 应用软件-电子商务软件 |
| **编程语言** | JavaScript (Node.js) |
| **代码行数** | 约 6,746 行 |
| **模块数量** | 19个API路由模块 + 2个前端SPA应用 |
| **数据库表** | 30张 |
| **API接口** | 85个 |

---

## 二、软件功能描述

### 2.1 商品管理模块
支持商品的全生命周期管理，包括商品添加、编辑、删除、上下架操作。商品支持多规格SKU管理（如颜色、尺寸等），可设置售价、原价、成本价、库存、销量等属性。支持新品、热销、推荐标签标记，具备分类关联功能。提供商品详情HTML编辑器、SEO关键词设置、商品复制和批量库存更新。搜索功能支持按名称、分类、状态筛选，分页展示。

### 2.2 订单管理模块
实现订单全流程管理，从用户下单到支付、发货、收货、完成、关闭的完整状态流转。支持订单号自动生成（DD+日期+随机码），每笔订单记录完整的操作日志。提供退款售后功能，用户可申请退款（仅退款/退货退款/换货），管理员审核通过或驳回。包含超时订单自动取消机制（30分钟未支付自动关闭并归还库存）。支持快递公司选择、发货管理。

### 2.3 会员体系模块
设计多级会员等级制度（普通→白银→黄金→钻石），不同等级享有不同折扣（10折→9折→85折→8折）。支持会员等级自定义（名称、经验值门槛、折扣率）。提供付费会员套餐（月卡/季卡/年卡/永久），购买后自动升级等级、增加经验值并赠送优惠券。记录会员购买历史和会员有效期。

### 2.4 用户账户管理模块
用户注册登录采用手机号+密码方式，密码使用bcrypt加密存储。支持JWT Token认证（7天有效期）。用户可管理收货地址（多地址、默认地址设置）、修改个人信息（昵称、头像）、修改密码。记录用户收藏商品、搜索历史。提供通知消息管理，未读消息标记。

### 2.5 购物车模块
支持商品加入购物车、数量增减、删除、清空操作。购物车项记录商品规格信息（SKU）、选中状态。支持全选/取消全选、批量结算功能。购物车数据与用户账号关联，跨设备同步。

### 2.6 分销体系模块
实现三级分销模式，上级可获取下线消费佣金（一级5%、二级2%、三级1%）。分销商等级（普通→高级→金牌）根据团队人数和销售业绩自动升级。提供佣金统计（今日/本月/累计）、佣金记录查询。支持提现申请（微信/支付宝/银行卡）、管理员审核、冻结余额管理。自动生成邀请链接。

### 2.7 营销工具模块
**优惠券系统**：支持满减券、折扣券、代金券三种类型，可设置发放总量、每人限领、有效期。用户可领取、查看我的优惠券。

**限时秒杀**：支持定时上架商品秒杀活动，设置秒杀价格、库存、每人限购数量。

**拼团购买**：支持多人团购活动，设置拼团价格、最低成团人数、活动时间。

### 2.8 AI客服模块
构建知识库系统，管理员可预设问答对（分类、问题、答案、关键词、权重），用户提问时自动匹配最相关问题并回复。支持多轮对话、会话记录保存。可开启/关闭AI客服，配置欢迎语、未匹配时兜底回复、转人工提示。

### 2.9 数据统计模块
提供多维度数据统计：销售趋势（按日/周/月）、热销商品TOP榜、用户增长趋势、会员统计、订单状态分布。支持订单数据、用户数据、商品数据的CSV导出功能。提供库存预警（商品库存低于阈值高亮提示）。

### 2.10 系统管理模块
**站点配置**：自定义站点名称、LOGO、联系方式、ICP备案号。

**支付配置**：可视化配置微信支付（APPID、商户号、API密钥）和支付宝（APPID、私钥、公钥）。

**轮播图管理**：管理首页轮播广告图片和链接。

**CMS页面管理**：编辑关于我们、隐私政策、服务条款等页面内容。

**运费模板**：按件数/按重量/包邮规则配置。

**管理员管理**：创建/禁用/删除子管理员，支持角色权限（运营/财务/客服）。

**数据备份**：手动备份和自动备份管理，备份文件列表和恢复功能。

**运行日志**：查看和清除服务端运行日志。

**登录日志**：记录所有用户登录尝试（成功/失败、IP、设备信息）。

**操作日志**：记录管理员关键操作（商品增删改、订单处理等）。

**模块开关**：独立开启/关闭会员体系、分销、AI客服、支付、售后、优惠券、秒杀、拼团等8大模块。

**测试/正式模式**：一键切换运营模式，测试模式使用模拟支付。

### 2.11 前端展示模块
**管理后台（PC端）**：基于Vue 3 + Element Plus的单页应用，包含仪表盘、商品管理、订单管理、会员管理、分销管理、营销工具、AI客服、数据统计、系统设置等完整管理界面。

**移动端（H5端）**：基于Vue 3 + Vant 4的单页应用，包含商品浏览、分类搜索、购物车、下单支付、订单管理、会员中心、分销推广、AI客服等用户端功能。

---

## 三、技术特点

### 3.1 后端技术特点

1. **Node.js + Express架构**：采用Express作为Web框架，中间件模式实现请求处理链，代码结构清晰，易于扩展和维护。

2. **SQLite数据库**：使用better-sqlite3同步数据库驱动，无需独立安装数据库服务，数据库文件即存即用，部署极为简便。WAL模式提升并发读写性能。

3. **RESTful API设计**：遵循RESTful风格设计API接口，统一返回格式（code/message/data），标准化分页查询。

4. **JWT Token认证**：使用JSON Web Token进行无状态认证，支持管理员和普通用户双角色鉴权。

5. **安全防护机制**：
   - 请求参数清洗（防SQL/XSS注入）
   - API限流（express-rate-limit）
   - 密码bcrypt哈希存储
   - Helmet安全头
   - CORS跨域保护
   - 登录频率限制

6. **事务处理**：关键业务（订单创建、退款、积分变动）使用数据库事务保证数据一致性。

7. **定时任务**：内置定时任务自动处理超时未支付订单，归还库存。

8. **模块化路由**：16个独立路由模块按业务领域划分，代码复用性高。

### 3.2 前端技术特点

1. **Vue 3 + Composition API**：使用Vue 3组合式API（setup语法）编写组件逻辑，响应式数据管理。

2. **Element Plus UI框架**：管理后台使用Element Plus组件库，提供丰富的表格、表单、弹窗、导航组件。

3. **Vant 4 UI框架**：移动端使用Vant 4组件库，适配移动端触摸操作，接近原生App体验。

4. **CDN引入**：前后端均通过CDN引入Vue/组件库，无需构建打包工具，部署简单。

5. **SPA单页应用**：前端采用单页应用架构，路由切换无需页面刷新，用户体验流畅。

6. **ECharts图表**：管理后台集成ECharts实现销售趋势图、商品排行榜等数据可视化。

7. **响应式布局**：管理后台支持桌面端和移动端响应式切换。

8. **Axios请求封装**：统一封装HTTP请求，自动携带Token认证头，集中处理错误响应。

---

## 四、开发环境

| 项目 | 版本/名称 |
|------|-----------|
| 操作系统 | Ubuntu 22.04 / macOS / Windows 10+ |
| 运行时 | Node.js v22.22.2 (LTS) |
| 包管理器 | npm 10+ |
| 数据库 | SQLite 3 (better-sqlite3) |
| 后端框架 | Express.js 4 |
| 管理前端框架 | Vue 3.5 + Element Plus 2.14 |
| 移动端框架 | Vue 3.5 + Vant 4 |
| 图表库 | ECharts 5 |
| HTTP客户端 | Axios |
| 认证方案 | JWT (jsonwebtoken) |
| 密码加密 | bcryptjs |
| 图片验证码 | svg-captcha |
| 文件上传 | multer |
| 安全头 | helmet |
| 开发工具 | VS Code / WebStorm |
| 版本管理 | Git |

---

## 五、硬件环境要求

### 5.1 服务器端（生产环境）

| 项目 | 最低配置 | 推荐配置 |
|------|---------|---------|
| CPU | 1核 | 2核及以上 |
| 内存 | 1GB | 2GB及以上 |
| 硬盘 | 20GB | 50GB及以上（SSD优先） |
| 带宽 | 1Mbps | 5Mbps及以上 |
| 操作系统 | Ubuntu 20.04 / CentOS 7+ | Ubuntu 22.04 |

### 5.2 服务器端（开发/测试环境）

| 项目 | 配置 |
|------|------|
| CPU | 1核及以上 |
| 内存 | 512MB及以上 |
| 硬盘 | 10GB及以上 |
| 操作系统 | Windows 10+/macOS/Linux |

### 5.3 客户端

| 项目 | 管理后台 | 移动端 |
|------|---------|--------|
| 浏览器 | Chrome 90+, Edge 90+, Firefox 90+ | 现代手机浏览器（微信内置浏览器、Chrome、Safari） |
| 屏幕 | 1024×768及以上 | 320×568及以上 |
| 网络 | 宽带/4G/5G | 4G/5G/WiFi |

---

## 六、软件架构说明

### 6.1 整体架构

```
┌─────────────────────────────────────────────────────────┐
│                    客户端层 Client                        │
│  ┌────────────────────┐  ┌──────────────────────────┐   │
│  │  管理后台 (PC端)    │  │  移动端H5 (手机浏览器)    │   │
│  │  Vue3+ElementPlus  │  │  Vue3+Vant4              │   │
│  │  admin/index.html  │  │  mobile/index.html       │   │
│  └────────┬───────────┘  └───────────┬──────────────┘   │
└───────────┼──────────────────────────┼───────────────────┘
            │        HTTP/HTTPS        │
            └────────────┬─────────────┘
                         │
┌────────────────────────┴────────────────────────────────┐
│                   API服务层 (Express)                     │
│                                                         │
│  ┌────────────┐  ┌──────────────┐  ┌───────────────┐   │
│  │  中间件层   │  │  路由层      │  │  工具层        │   │
│  │  auth.js   │  │  routes/    │  │  db.js        │   │
│  │  security  │  │  16个模块    │  │  response.js  │   │
│  └────────────┘  └──────────────┘  └───────────────┘   │
│                         │                               │
│              ┌──────────┴──────────┐                    │
│              │    SQLite 数据库     │                    │
│              │  (better-sqlite3)   │                    │
│              │  30张业务数据表      │                    │
│              └─────────────────────┘                    │
└─────────────────────────────────────────────────────────┘
```

### 6.2 后端分层架构

```
server/src/
├── app.js                  # 应用入口：中间件注册、路由挂载、静态文件服务、定时任务
├── init-db.js              # 数据库初始化：建表、种子数据、默认配置
├── middleware/
│   ├── auth.js             # 认证中间件：authUser（用户认证）、authAdmin（管理员认证）、optionalAuth（可选认证）
│   └── security.js         # 安全中间件：登录限流、参数清洗、权限校验、密码强度检查
├── routes/                 # 路由层（Controller层）
│   ├── admin.js            # 管理后台路由：登录、仪表盘、商品CRUD、订单管理、会员管理、分销管理、营销管理
│   ├── user.js             # 用户路由：注册登录、个人信息、地址管理、收藏、通知
│   ├── product.js          # 商品路由：列表、详情、热销、新品、推荐、分类查询
│   ├── cart.js             # 购物车路由：列表、添加、修改数量、删除、选中切换
│   ├── order.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               # 数据库工具：query/get/run/all/transaction 封装
│   └── response.js         # 响应工具：success/fail/page 统一响应格式
```

### 6.3 数据库ER关系

```
users ──1:N──> user_addresses
users ──1:N──> orders
users ──1:N──> carts
users ──1:N──> user_favorites
users ──1:N──> user_coupons
users ──N:1──> user_levels
users ──1:N──> user_memberships
users ──1:N──> distribution_records
users ──1:N──> withdraw_requests
users ──1:N──> chat_conversations

products ──1:N──> product_skus
products ──1:N──> product_specs
products ──1:N──> product_images
products ──N:1──> categories
products ──1:N──> order_items
products ──1:N──> product_reviews

orders ──1:N──> order_items
orders ──1:N──> order_logs
orders ──1:N──> payment_records
orders ──1:N──> refunds

coupons ──1:N──> user_coupons
membership_plans ──1:N──> user_memberships
```

### 6.4 请求处理流程

```
客户端请求
    │
    ▼
Helmet (安全头设置)
    │
    ▼
CORS (跨域处理)
    │
    ▼
JSON Body解析
    │
    ▼
Rate Limiter (API限流)
    │
    ▼
SanitizeRequest (参数清洗)
    │
    ▼
JWT Auth (Token认证 / 可选)
    │
    ▼
Router (业务路由处理)
    │
    ▼
DB Query (数据库操作)
    │
    ▼
Response (统一JSON响应)
```

### 6.5 部署架构

```
                         ┌─────────────┐
                         │   用户浏览器   │
                         └──────┬──────┘
                                │
                           HTTPS/HTTP
                                │
                      ┌─────────┴─────────┐
                      │   Nginx 反向代理    │
                      │  (域名+SSL+负载)   │
                      └─────────┬─────────┘
                                │
                      ┌─────────┴─────────┐
                      │  Node.js 应用服务   │
                      │  (端口3001)       │
                      └─────────┬─────────┘
                                │
                      ┌─────────┴─────────┐
                      │  SQLite 数据库文件  │
                      │  litemall.db      │
                      └───────────────────┘
```

---

## 七、申请人信息

| 项目 | 内容 |
|------|------|
| 申请人名称 | [待填写] |
| 申请人类别 | [待填写] |
| 联系地址 | [待填写] |
| 联系人 | [待填写] |
| 电话 | [待填写] |
| 邮箱 | [待填写] |

---

## 八、提交材料清单

| 序号 | 材料名称 | 文件 | 状态 |
|------|---------|------|------|
| 1 | 源代码（前30页+后30页）- 后端 | `source-backend.txt` | ✅ 已就绪 |
| 2 | 源代码（前30页+后30页）- 前端 | `source-frontend.txt` | ✅ 已就绪 |
| 3 | 用户操作手册（替代说明书） | `docs/02-管理员手册.md` | ✅ 已就绪 |
| 4 | 身份证明文件 | 需申请人自行提供 | ⬜ 待准备 |
| 5 | 软件著作权登记申请表 | 在线填写（ccopyright.com.cn） | ⬜ 待填写 |

---

## 九、申请流程

1. 访问 [中国版权保护中心](https://www.ccopyright.com.cn) 注册账号
2. 在线填写软件著作权登记申请表（参考以上信息）
3. 上传源代码文档（`source-backend.txt` + `source-frontend.txt`）
4. 上传用户操作手册（将 `管理员手册.md` 转为PDF）
5. 上传身份证明文件（营业执照或个人身份证）
6. 提交审核
   - 普通申请：免费，审核周期30-60工作日
   - 加急申请：付费，审核周期5-15工作日
7. 审核通过后下载电子证书
