# api-server

**Repository Path**: tang_jian1997/api-server

## Basic Information

- **Project Name**: api-server
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-25
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AItraining

这是北京东方金信科技股份有限公司用于员工 `AI Coding` 培训的脚手架项目。

`AI Agent` 可以根据 [doc/README.md](D:/work/codex/aitraining/doc/README.md:1) 及其子目录中的需求、设计和规范，直接生成 Demo 项目代码。

## 目录说明

- `doc/`：存放项目文档、开发规范和用于培训的目录结构说明
  - `项目文档总结.md`：项目文档结构和关键要点总结
- `code/`：存放项目代码
- 后端代码：/code/server/
- 前端代码：/code/web/
- Python 脚本：/code/python/

## 启动命令

### 后端服务（Spring Boot，端口 8080）

**方式一：直接启动（推荐，适合开发调试）**

```bash
cd code/server/app
mvn spring-boot:run
```

**方式二：install 启动（先编译所有模块再运行）**

```bash
mvn -f d:/pythonCode/api-server/code/server/pom.xml clean install -DskipTests
mvn -f d:/pythonCode/api-server/code/server/app/pom.xml spring-boot:run
```

**重启后端服务（先关闭 8080 端口应用，再启动）**

```bash
# Windows（PowerShell）
$pid = (Get-NetTCPConnection -LocalPort 8080 -ErrorAction SilentlyContinue).OwningProcess
if ($pid) { Stop-Process -Id $pid -Force; Write-Host "已关闭端口 8080 的进程 (PID: $pid)" }
cd code/server/app
mvn spring-boot:run

# Linux / macOS
kill $(lsof -t -i:8080) 2>/dev/null
cd code/server/app
mvn spring-boot:run
```

### 前端服务（Vue 3 + Vite，端口 3000）

```bash
powershell -Command "Set-Location 'd:\pythonCode\api-server\code\web'; npm run dev"
```

## 使用方式

1. 先阅读 [doc/01-AI入口.md](D:/work/codex/aitraining/doc/01-AI入口.md:1)
2. 按顺序阅读 `doc` 下的需求、架构、功能、测试、参考和规范文档
3. 基于 `doc` 中的内容生成或完善 `code/` 下的项目代码

## 适用场景

- 学员基于文档手工完成 Demo 项目开发
- AI 基于文档自动生成或协助完善 Demo 项目

## AI提示词

- 用户管理新增100条以上的测试数据，生成sql文件，并通过run_sql.py执行
- 将生成测试数据的sql文件保存到对应目录，并按规则命令
- 根据已有菜单结构生成菜单管理的数据，生成对应的sql文件保存到对应目录，并按规则命令，最后通过run_sql.py执行