# zkdtech-ai

**Repository Path**: mr-lwq/zkdtech-ai

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-03-14
- **Last Updated**: 2025-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZKD Tech AI 全栈项目

这是一个基于 Next.js 和 FastAPI 的全栈项目，采用前后端分离架构。

## 项目结构

```
.
├── api/                # 后端项目目录
│   ├── routers/       # API路由
│   ├── schemas/       # 数据模型和验证
│   ├── dao/          # 数据访问层
│   ├── models/       # 数据模型
│   ├── utils/        # 工具函数
│   └── test/         # 测试目录
├── web/               # 前端项目目录
│   ├── app/          # Next.js App Router
│   ├── service/      # API服务层
│   ├── utils/        # 工具函数
│   ├── models/       # 数据模型
│   └── public/       # 静态资源
├── start.bat         # Windows启动脚本
└── start.sh          # Linux/Mac启动脚本
```

## 环境要求

### 前端环境
- Node.js >= 18.0.0
- pnpm >= 8.0.0

### 后端环境
- Python >= 3.8
- Poetry >= 1.4.0

## 快速开始

### Windows系统

1. 克隆项目
```bash
git clone [项目地址]
cd zkdtech-ai
```

2. 启动项目
```bash
.\start.bat
```

### Linux/Mac系统

1. 克隆项目
```bash
git clone [项目地址]
cd zkdtech-ai
```

2. 添加执行权限
```bash
chmod +x start.sh
```

3. 启动项目
```bash
./start.sh
```

## 服务地址

- 前端服务：http://localhost:3000
- 后端服务：http://localhost:8011
- API文档：http://localhost:8011/docs

## 开发说明

### 前端开发
- 使用 Next.js 13+ App Router
- TypeScript 支持
- 使用 pnpm 作为包管理工具

### 后端开发
- 使用 FastAPI 框架
- Poetry 依赖管理
- 支持热重载
- 完整的类型提示

## 注意事项

1. 首次运行时会自动安装所需依赖
2. 后端服务需要配置 `.env` 文件，可以从 `.env.example` 复制并修改
3. 确保所有必要的端口（3000、8011）未被占用

## 贡献指南

1. Fork 项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

## 许可证

[添加许可证信息]