# WDGMS

**Repository Path**: n3746/WDGMS

## Basic Information

- **Project Name**: WDGMS
- **Description**: 无冬商城是一个专为游戏玩家设计的道具交易平台，提供账号注册、账号登录、账号积分系统、账号称号系统、游戏道具购买、每日签到、幸运抽奖、十连抽奖、会员礼包、活动报名、打卡奖励、活动竞猜等功能。该平台采用现代化的前端设计，提供流畅的用户体验，并配备后台管理系统，用于管理用户账号、道具库存、活动信息、用户积分和用户称号等。
- **Primary Language**: NodeJS
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://docs.qq.com/aio/DSENSV0dWWmF0WVBS
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 无冬商城 - 游戏道具交易平台

## 项目简介
无冬商城是一个专为游戏玩家设计的道具交易平台，提供账号注册、账号登录、账号积分系统、账号称号系统、游戏道具购买、每日签到、幸运抽奖、十连抽奖、会员礼包、活动报名、打卡奖励、活动竞猜等功能。该平台采用现代化的前端设计，提供流畅的用户体验，并配备后台管理系统，用于管理用户账号、道具库存、活动信息、用户积分和用户称号等。

该项目持续维护中，并且可商用。
意见反馈交流Q群：662823555
我的邮箱：593251280@qq.com

## 功能特性

### 核心功能模块
1. **用户系统**
   - 用户注册与登录
   - 个人信息管理
   - 账户安全设置

2. **积分与称号系统**
   - 积分累积与消费
   - 称号授予与管理
   - 积分历史记录

3. **道具交易系统**
   - 道具展示与搜索
   - 购物车功能
   - 订单管理

4. **抽奖系统**
   - 单次抽奖
   - 十连抽奖
   - 抽奖历史记录

5. **会员系统**
   - 会员等级管理
   - 专属礼包领取

6. **社交与活动系统**
   - 每日签到
   - 活动报名
   - 打卡任务
   - 玩家摆摊

7. **其他功能**
   - 充值中心
   - 最新公告
   - 三国小游戏服务（基于指令的策略游戏，包含随机事件生成和AI军师建议）

## 技术栈

### 前端技术
- **框架**: Vue.js 3 (Composition API)
- **状态管理**: Pinia
- **UI组件库**: Element Plus
- **样式框架**: Tailwind CSS
- **路由管理**: Vue Router
- **构建工具**: Vite
- **HTTP客户端**: Axios
- **工具库**: VueUse

### 后端技术
- **框架**: Express.js
- **语言**: TypeScript
- **数据库**: SQLite3
- **安全**: JWT, bcryptjs, Helmet
- **跨域支持**: CORS
- **环境配置**: dotenv

## 目录结构
```
wdshop/
├── backend/          # 后端服务
│   ├── src/          # 源代码
│   │   ├── controllers/  # 控制器
│   │   ├── models/       # 数据模型
│   │   ├── routes/       # 路由
│   │   ├── middleware/   # 中间件
│   │   └── utils/        # 工具函数
│   ├── dist/         # 编译后的代码
│   └── database.sqlite  # SQLite数据库文件
├── web/              # 前端应用
│   ├── src/          # 源代码
│   │   ├── views/        # 页面组件
│   │   ├── components/   # 可复用组件
│   │   ├── stores/       # 状态管理
│   │   ├── router/       # 路由配置
│   │   ├── api/          # API接口封装
│   │   └── utils/        # 工具函数
│   └── dist/         # 构建后的代码
├── docs/             # 文档
└── games/            # 游戏模块
    └── sg/           # 三国小游戏
```

## 开发环境搭建

### 前端环境
1. 安装依赖:
   ```bash
   cd web
   npm install
   ```

2. 启动开发服务器:
   ```bash
   npm run dev
   ```

3. 构建生产版本:
   ```bash
   npm run build
   ```

### 后端环境
1. 安装依赖:
   ```bash
   cd backend
   npm install
   ```

2. 启动开发服务器:
   ```bash
   npm run dev
   ```

3. 构建生产版本:
   ```bash
   npm run build
   ```

## 运行说明
1. 同时启动前后端服务
2. 前端默认运行在 `http://localhost:8081`
3. 后端API默认运行在 `http://localhost:3000`
4. 通过浏览器访问前端地址即可使用无冬商城

## 打包版本
项目已成功打包为独立的可执行文件，包含前后端程序：

1. 后端程序：`backend\wdshop-backend.exe`
2. 前端程序：`web\wdshop-frontend.exe`
3. 一键启动脚本：`start-app.bat`

详细信息请查看：
- [打包说明](README_PACKAGED.md)
- [版本信息](VERSION.md)
- [打包完成报告](PACKAGING_SUMMARY.md)

## API文档
后端API遵循RESTful设计规范，主要接口包括：
- 用户认证接口
- 积分与称号管理接口
- 道具交易接口
- 抽奖系统接口
- 会员系统接口
- 社交与活动接口

详细接口文档请参考后端控制器代码和功能设计文档。

## 数据库设计
项目采用SQLite3作为数据库，主要数据表包括：
- 用户表(users)
- 积分表(points)
- 称号表(titles)
- 道具表(items)
- 订单表(orders)
- 抽奖记录表(draw_history)
- 活动表(events)
- 签到表(checkins)

## 安全设计
- 使用JWT进行用户身份验证
- 密码采用bcrypt加密存储
- 实现登录失败次数限制
- 敏感数据传输使用HTTPS加密
- 防止SQL注入和XSS攻击

## 性能优化
- 前端使用Vite构建工具，支持代码分割和懒加载
- 后端实现数据库查询优化和连接池管理
- 图片资源压缩与懒加载
- 浏览器缓存机制利用

### 启动方式
- 1、启动后端服务： pnpm dev 
- 2、启动前端服务： npm run dev 
- 3、访问前端应用： http://localhost:8080/