# Charmo

**Repository Path**: vebin/charmo

## Basic Information

- **Project Name**: Charmo
- **Description**: 参考途虎养车、京东养车、天猫养车的连锁店汽车保养系统，基于 uniapp 与 Spring Boot、vue、typescript、MySQL、Redis 等构建，以微信小程序方式向移动端用户。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Charmo - 汽车服务小程序与管理系统

Charmo 是一个完整的汽车后市场服务解决方案，包含移动端小程序、管理后台和后端服务。

## 项目简介

Charmo 是一个汽车美容保养服务平台，采用微前端架构设计，包含：

- **移动端小程序** (`apps/mobile`) - 用户端小程序，支持微信小程序和 H5
- **管理后台** (`apps/admin`) - 商家管理系统，用于门店和服务管理
- **后端服务** (`apps/server`) - Java Spring Boot API 服务

## 技术栈

### 移动端 (Mobile)
- UniApp (Vue 3 + TypeScript)
- Vite 构建工具
- 支持微信小程序、H5 多端发布

### 管理后台 (Admin)
- Vue 3 + TypeScript
- Vite 构建工具
- Tailwind CSS
- Vue Router + Pinia

### 后端服务 (Server)
- Java 11 + Spring Boot
- MyBatis Plus
- MySQL + Redis
- JWT 认证
- Spring Security

## 功能特性

### 用户端 (移动小程序)
- 🔍 服务搜索与浏览
- 🏪 门店查询与预约
- 🚗 车辆管理
- 📦 订单管理
- ❤️ 收藏功能
- 📚 汽车百科
- 👤 个人中心

### 商家端 (管理后台)
- 📊 数据统计仪表盘
- 🏪 门店管理
- 🔧 服务项目管理
- 📋 订单管理
- 📝 技师管理
- 📰 内容管理

## 项目结构

```
charmo/
├── apps/
│   ├── admin/          # 管理后台 (Vue 3)
│   │   ├── src/
│   │   │   ├── api/       # API 接口
│   │   │   ├── components/# 组件
│   │   │   ├── views/     # 页面视图
│   │   │   ├── router/    # 路由配置
│   │   │   └── utils/     # 工具函数
│   │   └── Dockerfile
│   │
│   ├── mobile/         # 移动端小程序 (UniApp)
│   │   ├── src/
│   │   │   ├── api/       # API 接口
│   │   │   ├── pages/     # 页面
│   │   │   ├── utils/     # 工具函数
│   │   │   └── static/    # 静态资源
│   │   └── Dockerfile
│   │
│   └── server/         # 后端服务 (Spring Boot)
│       └── src/main/java/com/autocarehub/server/
│           ├── controller/   # 控制器
│           ├── service/      # 业务服务
│           ├── mapper/       # 数据访问
│           ├── entity/       # 实体类
│           ├── dto/          # 数据传输对象
│           ├── security/     # 安全认证
│           └── config/       # 配置类
│
└── pnpm-workspace.yaml # PNPM 工作空间配置
```

## 快速开始

### 前置要求

- Node.js 18+
- Java 11+
- Maven 3.9+
- MySQL 8.0+
- Redis 6.0+

### 安装依赖

```bash
# 安装 pnpm (如未安装)
npm install -g pnpm

# 安装项目依赖
pnpm install
```

### 开发模式

```bash
# 启动管理后台 (端口: 5173)
pnpm run dev:admin

# 启动移动端 H5 (端口: 5174)
pnpm run dev:mobile

# 启动后端服务 (端口: 8001)
cd apps/server
mvn spring-boot:run
```

### 构建部署

```bash
# 构建管理后台
pnpm run build:admin

# 构建移动端
pnpm run build:mobile
pnpm run build:mobile:mp-weixin  # 微信小程序

# 构建后端
cd apps/server
mvn clean package
docker build -t charmo/server:latest -f apps/server/Dockerfile .
```

## API 文档

### 认证接口
- `POST /api/auth/register` - 用户注册
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/refresh` - 刷新令牌
- `POST /api/auth/password/reset-ticket` - 获取密码重置票据
- `POST /api/auth/password/reset` - 重置密码

### 服务接口
- `GET /api/services` - 获取服务列表
- `GET /api/services/{serviceCode}` - 服务详情
- `GET /api/services/{serviceCode}/stores` - 支持门店列表

### 门店接口
- `GET /api/stores` - 门店列表
- `GET /api/stores/{storeCode}` - 门店详情
- `GET /api/stores/{storeCode}/appointment-capacity` - 预约容量

### 订单接口
- `POST /api/orders/preview` - 订单预览
- `POST /api/orders` - 创建订单
- `GET /api/orders` - 订单列表
- `GET /api/orders/{orderId}` - 订单详情

### 管理后台接口
- `GET /api/admin/dashboard` - 仪表盘数据
- `GET /api/admin/stores` - 门店管理
- `GET /api/admin/services` - 服务管理
- `GET /api/admin/orders` - 订单管理

## 默认账号

系统首次启动会自动创建管理员账号：

- 用户名：admin
- 手机号：13800138000
- 密码：admin123

## 贡献指南

欢迎提交 Issue 和 Pull Request。

## 许可证

本项目仅供学习交流使用。