# vbcoding-ycf

**Repository Path**: vibe-coding-2026-5/vbcoding-ycf

## Basic Information

- **Project Name**: vbcoding-ycf
- **Description**: vibe coding course 2 实践
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学院档案管理系统

## 项目介绍

学院档案管理系统是一个用于管理学院各类档案信息的综合平台，支持档案管理、媒体文件管理、关系管理和智能搜索等功能。

## 技术栈

### 后端 (Python)
- Python 3.10-3.13
- FastAPI
- pip + venv

### 前端 (Vue + Node.js)
- Node.js 20.19+ 或 22.12+
- Vue 3
- Vite
- npm

## 项目结构

```
project/
├── AGENT.md
├── .harness/
│   ├── README.md
│   ├── ROADMAP.md
│   ├── rules/
│   ├── specs/
│   ├── datasets/
│   ├── eval/
│   └── logs/
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── lib/
│   │   ├── pages/
│   │   ├── App.jsx
│   │   └── main.jsx
│   └── package.json
├── services/
│   ├── app_backend/
│   ├── agent_gateway/
│   └── domain_layer/
├── scripts/
├── data/
├── docs/
├── .env.example
└── README.md
```

## 服务端口

| 服务 | 端口 | 说明 |
|------|------|------|
| domain_layer | 8000 | 领域层服务 |
| app_backend | 8001 | 应用后端服务 |
| agent_gateway | 8002 | 智能代理网关 |
| frontend | 5173 | 前端应用 |

## 快速开始

### 环境要求
- Python 3.10-3.13
- Node.js 20.19+ 或 22.12+
- PowerShell (Windows)

### 启动后端服务

```powershell
cd services/domain_layer
python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

### 启动前端服务

```powershell
cd frontend
npm install
npm run dev
```

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request