# mocks

**Repository Path**: seazh/mocks

## Basic Information

- **Project Name**: mocks
- **Description**: mock测试
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mock Service

基于 TypeScript 的 Mock 服务管理系统，支持前端独立开发时的接口模拟，提供用户认证、RBAC 权限控制、操作日志审计等功能。

---

## 功能特性

- **Mock API 管理**：可视化创建、编辑、测试 Mock 接口
- **动态响应**：支持延迟响应、自定义状态码
- **用户认证**：JWT Token 认证
- **RBAC 权限控制**：基于角色和权限的访问控制
- **操作日志**：完整的操作审计追溯
- **定时任务**：自动清理过期日志
- **统一接口**：全 POST 接口，JSON 参数格式

---

## 技术栈

### 后端

| 技术       | 版本    | 说明     |
| ---------- | ------- | -------- |
| Node.js    | ^24.0.0 | 运行环境 |
| TypeScript | ^5.7.0  | 开发语言 |
| Express    | ^5.0.0  | Web 框架 |
| Sequelize  | ^6.37.5 | ORM      |
| SQLite     | ^5.1.7  | 数据库   |
| JWT        | ^9.0.3  | 身份认证 |
| Winston    | ^3.19.0 | 日志     |
| node-cron  | ^4.2.1  | 定时任务 |
| Jest       | ^29.7.0 | 测试框架 |

### 前端

| 技术         | 版本    | 说明        |
| ------------ | ------- | ----------- |
| Vue 3        | ^3.5.13 | 框架        |
| TypeScript   | ^5.7.0  | 语言        |
| Vite         | ^6.0.7  | 构建工具    |
| Element Plus | ^2.9.2  | UI 组件库   |
| Pinia        | ^2.3.0  | 状态管理    |
| Axios        | ^1.7.9  | HTTP 客户端 |
| Vitest       | ^2.1.8  | 测试框架    |

---

## 目录结构

```
trae-web/
├── backend/                 # 后端服务
│   ├── src/
│   │   ├── server.ts       # 启动入口
│   │   ├── app.ts          # Express 应用
│   │   ├── config/         # 配置
│   │   ├── constants/      # 常量
│   │   ├── controllers/    # 控制器
│   │   ├── services/       # 服务层
│   │   ├── routes/         # 路由
│   │   ├── models/         # 数据模型
│   │   ├── database/       # 数据库
│   │   ├── middlewares/    # 中间件
│   │   ├── validators/     # 参数验证
│   │   ├── schedule/       # 定时任务
│   │   ├── types/          # 类型定义
│   │   └── utils/          # 工具函数
│   ├── tests/              # 测试
│   ├── logs/               # 日志文件
│   └── package.json
│
├── frontend/               # 前端管理界面
│   ├── src/
│   │   ├── main.ts         # 入口
│   │   ├── App.vue         # 根组件
│   │   ├── api/            # API 服务
│   │   ├── components/     # 组件
│   │   ├── pages/          # 页面
│   │   ├── hooks/          # 组合式函数
│   │   ├── router/         # 路由
│   │   ├── stores/         # 状态管理
│   │   ├── styles/         # 样式
│   │   ├── types/          # 类型定义
│   │   └── utils/          # 工具函数
│   └── package.json
│
├── ai-docs/                # 原始文档
│
├── ai-docs2/               # 完整文档 v4.0
│   ├── mock服务完整需求文档.md
│   ├── mock服务前端详细设计文档.md
│   ├── mock服务后端详细设计文档.md
│   ├── 系统架构文档.md
│   └── README.md
│
└── README.md
```

---

## 快速开始

### 环境要求

- Node.js >= 18.18.0（推荐 ^24.0.0）
- npm >= 9.0.0

### 安装

```bash
# 克隆项目
git clone <repository-url>
cd trae-web

# 安装后端依赖
cd backend
npm install

# 安装前端依赖
cd frontend
npm install
```

### 启动

```bash
# 后端开发模式（热重载）
cd backend
npm run dev

# 前端开发模式
cd frontend
npm run dev
```

访问 http://localhost:3000

### 默认账号

| 用户名 | 密码     | 角色   |
| ------ | -------- | ------ |
| admin  | admin123 | 管理员 |

---

## API 文档

### 接口规范

- **请求方式**：统一 POST
- **Content-Type**：application/json
- **认证方式**：Bearer Token

### 接口列表

| 模块 | 路径                      | 说明      |
| ---- | ------------------------- | --------- |
| 认证 | /auth/login, /auth/logout | 登录登出  |
| 用户 | /users/\*                 | 用户管理  |
| 角色 | /roles/\*                 | 角色管理  |
| 机构 | /depts/\*                 | 机构管理  |
| 权限 | /permissions/\*           | 权限管理  |
| 项目 | /projects/\*              | 项目管理  |
| 日志 | /oper-logs/\*             | 日志管理  |
| Mock | /mock-api/\*              | Mock 接口 |

### 响应格式

```json
{
  "code": 200,
  "msg": "success",
  "data": {},
  "timestamp": 1712900000000
}
```

---

## 数据库

### 模型 (9个)

| 模型           | 说明          |
| -------------- | ------------- |
| User           | 用户          |
| Role           | 角色          |
| Dept           | 机构          |
| Permission     | 权限          |
| Project        | 项目          |
| OperLog        | 操作日志      |
| UserRole       | 用户-角色关联 |
| RolePermission | 角色-权限关联 |
| MockApi        | Mock 接口     |

### ER 关系

```
User ◄────► Role ◄────► Permission
 │                    ▲
 │                    │
 └──────► Dept ──────┘
              │
              ▼
          Project
```

---

## 开发命令

### 后端

```bash
cd backend

# 开发模式（热重载）
npm run dev

# 构建
npm run build

# 生产运行
npm start

# 运行测试
npm run test

# 测试覆盖率
npm run test:coverage
```

### 前端

```bash
cd frontend

# 开发模式
npm run dev

# 构建
npm run build

# 预览
npm run preview

# 测试
npm run test
```

---

## 部署

### 开发环境

```bash
cd backend && npm run dev
cd frontend && npm run dev
```

### 生产环境

```bash
# 后端
cd backend
npm install --production
npm run build
npm start

# 前端
cd frontend
npm install
npm run build
# 部署 dist/ 到 Nginx
```

---

## 文档

详细文档位于 `ai-docs/` 目录：

| 文档                        | 说明           |
| --------------------------- | -------------- |
| mock服务完整需求文档.md     | 需求规格说明书 |
| mock服务前端详细设计文档.md | 前端设计说明   |
| mock服务后端详细设计文档.md | 后端设计说明   |
| 系统架构文档.md             | 系统架构说明   |

---

## License

MIT