# test-tiny

**Repository Path**: jason559/test-tiny

## Basic Information

- **Project Name**: test-tiny
- **Description**: `​TinyPro 前后端项目`
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-10
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TinyPro 前后端项目

基于 TinyPro 的中后台管理系统脚手架，包含完整的前后端代码。

## 项目结构

```
test-tiny/
├── springboot/          # 后端 Java 项目
│   ├── src/             # 源代码
│   ├── docs/            # 后端开发文档
│   └── pom.xml          # Maven 配置
│
├── web/                 # 前端 Vue 项目
│   ├── src/             # 源代码
│   ├── docs-tutorial/   # 前端讲解文档（适合Java程序员）
│   ├── docs-dev/        # 前端开发参考文档
│   └── package.json     # npm 配置
│
└── README.md            # 项目说明
```

## 技术栈

### 后端
- Java 17
- Spring Boot 3.x
- Spring Security + JWT
- Spring Data JPA
- MySQL + Redis

### 前端
- Vue 3.5
- TypeScript 5.1
- Vite 6.1
- Pinia 2.1
- TinyVue 3.29

## 快速开始

### 后端启动

```bash
cd springboot

# 配置数据库（修改 application.properties）
# 创建 MySQL 数据库

# 启动项目
mvn spring-boot:run
```

### 前端启动

```bash
cd web

# 安装依赖
npm install

# 启动开发服务器
npm run start
```

### 访问地址

- 前端：http://localhost:3031
- 后端：http://localhost:9527

### 默认账号

- 邮箱：admin@no-reply.com
- 密码：admin

## 文档说明

### 后端文档（springboot/docs/）

| 文件 | 内容 |
|------|------|
| 01-项目概览与目录结构.md | 项目整体介绍 |
| 02-配置文件详解.md | 配置文件说明 |
| 03-认证与权限系统.md | JWT认证流程 |
| 04-数据库实体与API接口.md | 数据库设计 |
| 05-二次开发指南-新增模块.md | 新增模块步骤 |
| 06-异常处理与国际化.md | 异常处理机制 |
| 07-数据初始化.md | 数据初始化流程 |

### 前端讲解文档（web/docs-tutorial/）

适合 Java 程序员学习前端开发。

| 文件 | 内容 |
|------|------|
| 01-前端项目概览（Java程序员视角）.md | 项目整体介绍 |
| 02-配置文件详解.md | 配置文件说明 |
| 03-核心概念讲解.md | Vue 核心概念 |
| 04-路由系统详解.md | 路由配置与守卫 |
| 05-状态管理与API调用.md | Pinia 与 Axios |
| 06-典型模块详解-登录模块.md | 登录流程分析 |

### 前端开发文档（web/docs-dev/）

供开发时参考的技术文档。

| 文件 | 内容 |
|------|------|
| 01-项目技术参考.md | 技术栈与目录结构 |
| 02-API接口定义参考.md | API 定义规范 |
| 03-Store状态管理参考.md | Store 定义规范 |
| 04-路由配置参考.md | 路由配置规范 |
| 05-组件开发参考.md | 组件开发模板 |
| 06-二次开发指南-新增模块.md | 新增模块完整步骤 |

## 开发指南

### 新增模块流程

1. **后端**：创建 Entity → Repository → Service → Controller
2. **前端**：创建 API → Store → Router → Views
3. 参考 `web/docs-dev/06-二次开发指南-新增模块.md`

### 代码提交规范

```bash
# 拉取最新代码
git pull

# 添加修改
git add .

# 提交（描述清晰）
git commit -m "feat: 新增部门管理模块"

# 推送
git push
```

## 许可证

MIT License