# demo-system

**Repository Path**: captain1230/demo-system

## Basic Information

- **Project Name**: demo-system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-15
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Demo System

Demo System 是一个前后端分离的管理系统仓库，包含：

- 前端：`apps/frontend`（Vue 2 + Element UI）
- 后端：`apps/backend`（Spring Boot 3 + MyBatis-Plus）

支持两种运行方式：

- 本地源码运行（适合开发调试）
- Docker Compose 一键部署（适合快速体验/联调）

## 目录结构

```text
demo-system/
  apps/
    frontend/                 # 前端工程
    backend/                  # 后端工程
  docs/
    conventions.md
  docker-compose.yml          # Docker 编排
```

## 环境要求

### 本地运行

- Node.js 16+
- npm 8+
- JDK 17
- Maven 3.6+
- MySQL 8.x
- Redis 6+/7+

### Docker 运行

- Docker
- Docker Compose（`docker compose`）

## 方式一：Docker 一键启动（推荐）

在仓库根目录执行：

```bash
docker compose up -d --build
```

查看状态：

```bash
docker compose ps
```

停止服务：

```bash
docker compose down
```

### Docker 部署默认端口

- 前端：`http://localhost:7001`
- 后端：`http://localhost:8080`
- API 文档：`http://localhost:8080/doc.html`
- MySQL：`127.0.0.1:3307`
- Redis：`127.0.0.1:6379`

### Docker 默认数据库信息

- 数据库：`demo_system`
- 用户名：`root`
- 密码：`12345678`

> 说明：MySQL 映射为 `3307`，用于避免本机 `3306` 被占用时冲突。

## 方式二：本地源码启动

### 1) 启动后端

```bash
cd apps/backend
mvn clean package -DskipTests
mvn spring-boot:run
```

后端地址：`http://localhost:8080`

### 2) 启动前端

```bash
cd apps/frontend
npm install
npm run dev
```

前端地址以终端输出为准（常见为 `http://localhost:7001` 或 `http://localhost:7002`）。

## 常用命令

### Docker

```bash
# 重建并启动
docker compose up -d --build

# 查看日志
docker compose logs -f

# 仅停止容器
docker compose stop

# 停止并删除容器/网络
docker compose down
```

### 后端

```bash
cd apps/backend
mvn -q -DskipTests compile
```

### 前端

```bash
cd apps/frontend
npm run build:prod
```

## 备注

- 当前仓库命名已统一为 `demo`。
- 如果遇到端口冲突，可在 `docker-compose.yml` 中调整端口映射后重新 `up`。