# kernel_dev_for_fun

**Repository Path**: gxngit/kernel_dev_for_fun

## Basic Information

- **Project Name**: kernel_dev_for_fun
- **Description**: kerneldev_flow
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-02-17
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OS内核质量服务平台

## 项目简介

OS内核质量服务平台，提供OS内核业务流程IT化、代码评审、质量管理、质量监控等功能。

## 技术栈

### 后端
- **框架**: NestJS
- **语言**: TypeScript
- **数据库**: PostgreSQL
- **ORM**: Prisma
- **缓存**: Redis
- **认证**: JWT

### 前端
- **框架**: React
- **语言**: TypeScript
- **构建工具**: Vite
- **UI库**: Ant Design
- **HTTP客户端**: Axios

## 项目结构

```
kernel_dev_for_fun/
├── backend/          # 后端代码
│   ├── src/          # 后端源代码
│   │   ├── auth/     # 认证模块
│   │   ├── users/    # 用户模块
│   │   ├── projects/ # 项目模块
│   │   ├── branches/ # 分支模块
│   │   ├── mr/       # MR模块
│   │   ├── reviews/  # 评审模块
│   │   ├── approvals/ # 审批模块
│   │   ├── builds/   # 构建模块
│   │   ├── tests/    # 测试模块
│   │   ├── redis/    # Redis模块
│   │   ├── prisma/   # Prisma模块
│   │   └── common/   # 公共模块
│   ├── prisma/       # Prisma配置
│   ├── generated/    # 生成的文件
│   └── dist/         # 构建输出
├── frontend/         # 前端代码
│   ├── src/          # 前端源代码
│   │   ├── components/ # 通用组件
│   │   ├── pages/     # 页面组件
│   │   └── contexts/  # React Context
│   ├── public/       # 静态资源
│   └── dist/         # 构建输出
├── docs/            # 项目文档
│   ├── PROJECT_STRUCTURE.md
│   ├── ARCHITECTURE.md
│   ├── API.md
│   └── DEPLOYMENT.md
├── test/            # 测试脚本
├── scripts/         # 辅助脚本
└── package.json     # 根目录配置
```

详细的项目结构说明请参考 [docs/PROJECT_STRUCTURE.md](docs/PROJECT_STRUCTURE.md)

## 快速开始

### 1. 安装依赖

```bash
# 安装根所有依赖
cd kernel_dev_for_fun/backend
npm install
cd kernel_dev_for_fun/frontend
npm install
```

### 2. 配置环境变量

复制并编辑后端环境变量文件：

```bash
./manage.sh init
```

### 3. 初始化数据库

```bash
cd backend
npx prisma generate
npx prisma migrate dev
npx prisma db seed
#----也可以是用一键式脚本-----
./scripts/reset-db.sh
```

### 4. 启动开发服务器

```bash
# 推荐使用一键式脚本
./manage.sh start

# 同时启动后端和前端
npm run dev

# 或者分别启动
npm run dev:backend   # 后端运行在 http://localhost:3000
npm run dev:frontend  # 前端运行在 http://localhost:3001
```

## 测试用户

系统提供以下测试用户用于开发测试：

- **用户名**: `testuser`
- **密码**: `test123456`
- **角色**: `ADMINISTRATOR`

## 文档

- [项目结构说明](docs/PROJECT_STRUCTURE.md)
- [架构设计文档](docs/ARCHITECTURE.md)
- [API接口文档](docs/API.md)
- [部署文档](docs/DEPLOYMENT.md)
- [开发计划](DEVELOPMENT_PLAN.md)

## 部署

### 环境要求

- Node.js 18+
- PostgreSQL 13+
- Redis 6+

### 部署步骤

1. **克隆代码**

```bash
git clone <repository-url>
cd kernel_dev_for_fun
```

2. **安装依赖**

```bash
# 安装后端依赖
cd backend
npm install

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

3. **配置环境变量**

```bash
# 配置后端环境变量
cd ../backend
cp env.example .env
# 编辑 .env 文件，配置数据库连接等信息

# 配置前端环境变量
cd ../frontend
cp .env.example .env
# 编辑 .env 文件，配置API地址等信息
```

4. **构建项目**

```bash
# 构建后端
cd ../backend
npm run build

# 构建前端
cd ../frontend
npm run build
```

5. **初始化数据库**

```bash
cd ../backend
npx prisma generate
npx prisma migrate deploy
npx prisma db seed
```

6. **启动服务**

```bash
# 启动后端服务
cd backend
npm run start:prod

# 启动前端服务（可使用nginx等反向代理）
# 将前端构建产物部署到web服务器
```

详细的部署说明请参考 [部署文档](docs/DEPLOYMENT.md)

## 开发脚本

```bash
# 开发
npm run dev              # 同时启动后端和前端
npm run dev:backend     # 只启动后端
npm run dev:frontend    # 只启动前端

# 构建
npm run build           # 构建后端和前端
npm run build:backend   # 只构建后端
npm run build:frontend  # 只构建前端

# 测试
npm run test            # 运行所有测试
npm run test:backend    # 运行后端测试
npm run test:frontend   # 运行前端测试
```

## 测试

### 测试目录结构

- `tests/` - 测试脚本和配置
- `backend/src/**/*.spec.ts` - 后端单元测试
- `frontend/src/**/*.test.tsx` - 前端单元测试

### 运行测试

```bash
# 运行所有测试
npm run test

# 运行后端测试
npm run test:backend

# 运行前端测试
npm run test:frontend

# 运行测试并生成覆盖率报告
npm run test:backend -- --coverage
npm run test:frontend -- --coverage

# 检查测试用户一键式运行测试用例
./tests/run-all-tests.sh auth
```

### 测试结果

测试结果目录：`tests/results`

详细说明请参考 [backend/test/README.md](backend/test/README.md)
## 贡献

欢迎提交Issue和Pull Request！

## 许可证

MIT License