提交 c00f8dec authored 作者: caifuming's avatar caifuming

@张钱炜 @新增数据库设计表,以及各模型任务功能

上级 99090008
version: "3.8"
services:
mysql:
image: mysql:8.0
container_name: studyweb-mysql
restart: always
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-root123}
MYSQL_DATABASE: ${MYSQL_DATABASE:-studyweb}
MYSQL_USER: ${MYSQL_USER:-studyweb}
MYSQL_PASSWORD: ${MYSQL_PASSWORD:-studyweb123}
ports:
- "5688:3306"
volumes:
- mysql_data:/var/lib/mysql
- ./config/mysql/init:/docker-entrypoint-initdb.d
- ./config/mysql/conf.d:/etc/mysql/conf.d
command: --default-authentication-plugin=mysql_native_password
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
interval: 10s
timeout: 5s
retries: 5
redis:
image: redis:7
container_name: studyweb-redis
restart: always
ports:
- "16379:6379"
volumes:
- redis_data:/data
- ./config/redis/redis.conf:/usr/local/etc/redis/redis.conf
command: redis-server /usr/local/etc/redis/redis.conf
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 10s
timeout: 5s
retries: 5
minio:
image: minio/minio:RELEASE.2024-01-16
container_name: studyweb-minio
restart: always
environment:
MINIO_ROOT_USER: ${MINIO_ROOT_USER:-minioadmin}
MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:-minioadmin123}
ports:
- "19000:9000"
- "19001:9001"
volumes:
- minio_data:/data
command: server /data --console-address ":9001"
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
interval: 10s
timeout: 5s
retries: 5
loki:
image: grafana/loki:3.2.1
container_name: studyweb-loki
restart: always
ports:
- "13100:3100"
volumes:
- loki_data:/loki
- ./config/loki/loki-config.yml:/etc/loki/local-config.yaml
command: -config.file=/etc/loki/local-config.yaml
promtail:
image: grafana/promtail:3.2.1
container_name: studyweb-promtail
restart: always
volumes:
- ./logs:/var/log/app:ro
- ./config/promtail/promtail-config.yml:/etc/promtail/config.yml:ro
- /var/run/docker.sock:/var/run/docker.sock:ro
command: -config.file=/etc/promtail/config.yml
depends_on:
- loki
volumes:
mysql_data:
redis_data:
minio_data:
loki_data:
差异被折叠。
# 项目目录创建以及脚手架搭建
> 本文档记录实习生训练平台的项目目录创建过程和脚手架验收标准,基于《技术架构设计.md》执行。
---
## 一、验收标准
| 项目 | 验收命令 | 成功标准 |
|------|----------|----------|
| backend-app | `./mvnw compile` | BUILD SUCCESS |
| frontend | `pnpm build` | built in X.XXs |
| ai-service | `python -m py_compile app/main.py` | 无语法错误 |
---
## 二、项目目录结构
```
studyweb/ # 项目根目录
├── README.md
├── 平台文档/ # 项目文档
│ ├── MVP方案/
│ │ ├── 技术架构设计.md
│ │ ├── 项目目录创建以及脚手架搭建.md # 本文档
│ │ └── ...
│ └── ...
├── backend/ # 后端(Java 17 / Spring Boot 3.x)
│ ├── apps/
│ │ └── backend-app/ # 业务单体
│ │ ├── pom.xml
│ │ ├── mvnw
│ │ ├── mvnw.cmd
│ │ └── src/
│ │ ├── main/
│ │ │ ├── java/com/platform/backend/
│ │ │ │ ├── BackendApplication.java
│ │ │ │ └── ...
│ │ │ └── resources/
│ │ │ └── application.yml
│ │ └── test/
│ └── libs/ # 共享库(预留)
├── frontend/ # 前端(React + TypeScript + Vite)
│ ├── package.json
│ ├── pnpm-lock.yaml
│ ├── vite.config.ts
│ ├── tsconfig.json
│ ├── src/
│ │ ├── main.tsx
│ │ ├── App.tsx
│ │ └── ...
│ └── dist/ # 构建产物
├── ai-service/ # AI 服务(Python 3.11 / FastAPI)
│ ├── requirements.txt
│ ├── pyproject.toml # 可选(尚未启用 uv)
│ ├── README.md
│ ├── app/
│ │ ├── main.py # FastAPI 入口
│ │ └── api/
│ │ ├── health.py
│ │ └── knowledge.py
│ └── repo_ingestion/ # 知识库构建模块
│ ├── collector.py
│ ├── parser.py
│ └── ...
├── scripts/ # 运维脚本
│ └── start.sh # 一键启停脚本
└── logs/ # 日志目录
├── backend-app.log
├── frontend.log
└── ai-service.log
```
---
## 三、后端(backend-app)
### 3.1 技术栈
- **语言**: Java 17
- **框架**: Spring Boot 3.2.5
- **构建工具**: Maven(Wrapper)
- **数据库**: MySQL 8.x
- **缓存**: Redis 6.x
### 3.2 脚手架创建
```bash
# 创建项目目录
mkdir -p backend/apps && cd backend/apps
# 使用 Spring Initializr 或手动创建
# 本项目采用手动创建 pom.xml 结构
# 初始化 Maven Wrapper
mvn wrapper:wrapper
# 或复制已有项目的 mvnw
```
### 3.3 关键配置文件
**pom.xml** 包含依赖:
- `spring-boot-starter-web`
- `spring-boot-starter-data-jpa`
- `spring-boot-starter-validation`
- `spring-boot-starter-security`
- `spring-boot-starter-data-redis`
- `mysql-connector-j`
- `lombok`
**application.yml** 配置:
```yaml
server:
port: 7087
address: 0.0.0.0
spring:
application:
name: backend-app
datasource:
url: jdbc:mysql://localhost:3306/intern_platform
username: root
password: root
jpa:
hibernate:
ddl-auto: update
show-sql: true
```
### 3.4 验收
```bash
cd backend/apps/backend-app
./mvnw compile
# 预期: BUILD SUCCESS
```
---
## 四、前端(frontend)
### 4.1 技术栈
- **语言**: TypeScript
- **框架**: React 18
- **构建工具**: Vite 5.x
- **包管理器**: pnpm
- **开发服务器端口**: 7080
### 4.2 脚手架创建
```bash
# 创建项目
mkdir -p frontend
cd frontend
# 初始化 package.json
pnpm init
# 安装依赖
pnpm add react react-dom
pnpm add -D typescript @types/react @types/react-dom vite @vitejs/plugin-react
# 配置文件
# - package.json
# - vite.config.ts
# - tsconfig.json
# - index.html
```
### 4.3 关键配置文件
**package.json**:
```json
{
"name": "intern-training-platform-frontend",
"version": "1.0.0",
"scripts": {
"dev": "vite",
"build": "tsc && vite build"
}
}
```
**vite.config.ts**:
```typescript
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
export default defineConfig({
plugins: [react()],
server: {
port: 7080,
host: '0.0.0.0',
proxy: {
'/api': {
target: 'http://localhost:7087',
changeOrigin: true,
},
},
},
});
```
### 4.4 验收
```bash
cd frontend
pnpm install
pnpm build
# 预期: ✓ built in X.XXs
```
---
## 五、AI 服务(ai-service)
### 5.1 技术栈
- **语言**: Python 3.11
- **框架**: FastAPI
- **运行端口**: 7083
### 5.2 脚手架创建
```bash
# 创建项目
mkdir -p ai-service/app/api ai-service/repo_ingestion
# 依赖文件
echo 'fastapi==0.115.0
uvicorn[standard]==0.30.6
pydantic==2.9.2
python-multipart==0.0.10
httpx==0.27.2' > requirements.txt
# 安装依赖
pip install -r requirements.txt
```
### 5.3 最小骨架文件
**app/main.py** - FastAPI 入口:
```python
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
app = FastAPI(
title="ai-service",
version="1.0.0",
description="实习生训练平台 AI 服务",
)
app.add_middleware(
CORSMiddleware,
allow_origins=["*"],
allow_credentials=True,
allow_methods=["*"],
allow_headers=["*"],
)
from app.api import health, knowledge
app.include_router(health.router, prefix="/api/health", tags=["health"])
app.include_router(knowledge.router, prefix="/api/knowledge", tags=["knowledge"])
if __name__ == "__main__":
import uvicorn
uvicorn.run("app.main:app", host="0.0.0.0", port=7083, reload=True)
```
**app/api/health.py** - 健康检查:
```python
from fastapi import APIRouter
router = APIRouter()
@router.get("/")
def health_check():
return {"status": "ok", "service": "ai-service", "version": "1.0.0"}
```
### 5.4 验收
```bash
cd ai-service
python -m py_compile app/main.py app/api/health.py app/api/knowledge.py
# 预期: 无输出(语法检查通过)
```
---
## 六、运维脚本
### 6.1 一键启停脚本
位置: `scripts/start.sh`
功能:
- 使用 conda studyweb 环境
- 启动 backend-app (端口 7087)
- 启动 frontend (端口 7080)
- 启动 ai-service (端口 7083)
用法:
```bash
./scripts/start.sh # 启动所有服务
./scripts/start.sh restart # 重启所有服务
./scripts/start.sh stop # 停止所有服务
```
---
## 七、服务端口汇总
| 服务 | 端口 | 说明 |
|------|------|------|
| backend-app | 7087 | Spring Boot 业务后端 |
| frontend | 7080 | Vite 开发服务器 |
| ai-service | 7083 | FastAPI AI 服务 |
---
## 八、后续工作
- [ ] 完成四端前端开发(student/mentor/supervisor/admin)
- [ ] 实现用户认证模块
- [ ] 实现实训流程状态机
- [ ] 集成 Milvus 向量数据库
- [ ] 完善 CI/CD 流水线
差异被折叠。
差异被折叠。
差异被折叠。
差异被折叠。
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论