# 微信小程序

**Repository Path**: 6c/small-app

## Basic Information

- **Project Name**: 微信小程序
- **Description**: 软件模版商品交易与积分激励平台。
用户可购买模版、通过分享与打卡获取下载积分，
用于兑换或下载模版资源。

- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 模版商城 (Template Mall)

这是一个功能完备的**全栈电商解决方案**，包含面向商家的 **Vue3 管理后台**、面向用户的 **微信小程序** 以及高性能的 **Go API 服务**。该项目旨在提供一个开箱即用的模板商城系统，支持模板商品展示、在线交易、用户积分体系及裂变分享等功能。

## ✨ 核心功能

### 📱 微信小程序端
*   **首页与浏览**：展示精选模板，支持多主题切换。
*   **模板市场**：按分类浏览模板商品，查看详情及用户评价。
*   **交易系统**：支持模板购买、微信支付及订单管理。
*   **用户体系**：个人中心、收货地址管理（集成于个人信息中）。
*   **积分经济**：每日签到获取积分，查看积分流水与余额。
*   **社交分享**：分享模板记录追踪与统计分析。

### 🖥️ 管理后台 (Admin)
*   **数据概览**：实时显示用户、订单、积分等核心数据统计。
*   **用户管理**：查看用户列表、详情及积分账户状态。
*   **商品管理**：模板的增删改查、上下架管理、分类与标签管理。
*   **订单中心**：订单列表、详情查看、关闭订单及退款处理。
*   **内容运营**：公告发布管理、评论审核管理。
*   **系统配置**：网站基本配置、主题色配置管理。

### ⚙️ 后端 API (Server)
*   **RESTful API**：采用 Go + Gin 框架构建的高性能接口。
*   **双重认证机制**：支持管理员 JWT 认证及小程序用户 JWT 认证。
*   **数据持久化**：基于 GORM 连接 MySQL 8，提供完整的数据模型。
*   **业务逻辑**：集成了订单、支付（模拟）、积分、分享、签到等核心业务逻辑。

## 🛠 技术栈概览

| 模块 | 技术栈 | 特点 |
| :--- | :--- | :--- |
| **小程序** | 原生微信小程序 | 轻量级，无需额外编译工具链 |
| **管理后台** | Vue 3 + Vite + Tailwind CSS | 现代化前端工程化，组件化开发 |
| **后端服务** | Go + Gin + Gorm | 高并发、高性能、类型安全 |
| **数据库** | MySQL 8 | 成熟稳定的关系型数据库 |

## 📂 项目结构

```text
.
├── .gitee/               # Gitee 平台相关的 Issue/PR 模板
├── admin/                # 管理后台前端项目 (Vue 3)
├── docs/                 # 数据库设计文档与脚本
│   └── database/         
├── miniprogram/          # 微信小程序前端项目
├── server/               # 后端 API 服务项目 (Go)
└── LICENSE               # 许可证文件
```

## 🚀 快速启动指南

### 1. 环境准备
确保开发环境已安装：
*   **Go** (>= 1.18)
*   **Node.js** (>= 16)
*   **MySQL** (>= 8.0)
*   **微信开发者工具** (用于运行小程序)

### 2. 数据库初始化
使用 `docs/database/schema-mysql8.sql` 文件在 MySQL 中创建数据库并导入表结构。

### 3. 启动后端服务 (Server)

```bash
cd server

# 1. 复制环境变量配置
cp env.example .env

# 2. 编辑 .env，配置数据库连接 (DSN) 等信息

# 3. 启动服务
go run cmd/server/main.go
```
服务默认运行在 `http://localhost:8080`。

### 4. 启动管理后台 (Admin)

```bash
cd admin

# 1. 安装依赖
npm install

# 2. 启动开发服务器
npm run dev
```
访问 `http://localhost:5173` (或终端显示的端口)。

### 5. 运行微信小程序
使用微信开发者工具打开根目录下的 `miniprogram/` 文件夹。
**注意**：请修改 `miniprogram/config/index.js` 中的 `BASE_URL` 配置，使其指向你的本地或远程 API 地址。

## 📖 详细文档

*   **后端接口文档**：请查阅 `server/README.md`，包含详细的 API 列表、请求参数、响应格式及鉴权规则。
*   **管理后台文档**：请查阅 `admin/README.md`。
*   **小程序开发文档**：请查阅 `miniprogram/README.md`。

## 🤝 贡献

欢迎通过提交 Pull Request 或 Issue 来参与项目贡献。

## 📄 开源协议

本项目基于 [MIT License](LICENSE) 开源。