# CodeGuidePro

**Repository Path**: mustangai/codeguide-web-pro

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-24
- **Last Updated**: 2025-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SaaS Platform Starter Kit

一个功能完整的SaaS平台启动模板，包含用户管理、支付系统、仪表板和多租户架构。

## 🚀 技术栈

### 前端
- **Next.js 14** - React框架，支持App Router
- **TypeScript** - 类型安全
- **Tailwind CSS** - 样式框架
- **shadcn/ui** - UI组件库
- **NextAuth.js** - 认证系统
- **Zustand** - 状态管理
- **React Query** - 数据获取和缓存

### 后端
- **FastAPI** - 现代Python Web框架
- **SQLAlchemy** - ORM
- **PostgreSQL** - 数据库
- **Alembic** - 数据库迁移
- **JWT** - 认证令牌
- **Stripe** - 支付处理

### 基础设施
- **Docker** - 容器化
- **Docker Compose** - 本地开发环境
- **Redis** - 缓存和会话存储

## 🏗️ 项目结构

```
SaasPlatform/
├── frontend/          # Next.js 前端应用
│   ├── src/
│   │   ├── app/       # App Router页面
│   │   ├── components/ # 可复用组件
│   │   ├── lib/       # 工具函数和配置
│   │   ├── hooks/     # 自定义hooks
│   │   └── types/     # TypeScript类型定义
│   └── public/        # 静态资源
├── backend/           # FastAPI 后端应用
│   ├── app/
│   │   ├── api/       # API路由
│   │   ├── core/      # 核心配置
│   │   ├── models/    # 数据模型
│   │   ├── schemas/   # Pydantic模式
│   │   ├── services/  # 业务逻辑
│   │   └── utils/     # 工具函数
│   └── alembic/       # 数据库迁移
├── shared/            # 前后端共享代码
└── docker-compose.yml # 开发环境配置
```

## ✨ 核心功能

### 🔐 用户管理
- 用户注册和登录
- JWT认证
- 角色权限管理
- 用户资料管理
- 密码重置

### 🏢 多租户架构
- 租户数据隔离
- 子域名路由
- 租户配置管理
- 资源限制和配额

### 💳 支付系统
- Stripe集成
- 订阅计划管理
- 发票生成
- 支付历史
- Webhook处理

### 📊 仪表板
- 数据可视化
- 用户活动统计
- 收入分析
- 系统监控
- 实时数据更新

## 🚀 快速开始

### 环境要求
- Node.js 18+
- Python 3.11+
- Docker & Docker Compose
- PostgreSQL 15+

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd SaasPlatform
```

2. **环境配置**
```bash
cp .env.example .env
# 编辑 .env 文件，配置数据库和API密钥
```

3. **启动开发环境**
```bash
docker-compose up -d
```

4. **安装依赖**
```bash
# 前端
cd frontend
npm install

# 后端
cd ../backend
pip install -r requirements.txt
```

5. **数据库迁移**
```bash
cd backend
alembic upgrade head
```

6. **启动应用**
```bash
# 后端 (终端1)
cd backend
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# 前端 (终端2)
cd frontend
npm run dev
```

访问 http://localhost:3000 查看前端应用
访问 http://localhost:8000/docs 查看API文档

## 📝 开发指南

### API文档
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc

### 数据库管理
```bash
# 创建新迁移
alembic revision --autogenerate -m "描述"

# 应用迁移
alembic upgrade head

# 回滚迁移
alembic downgrade -1
```

### 测试
```bash
# 前端测试
cd frontend
npm run test

# 后端测试
cd backend
pytest
```

## 🔧 配置

### 环境变量
参考 `.env.example` 文件配置以下环境变量：
- 数据库连接
- JWT密钥
- Stripe API密钥
- 邮件服务配置

## 📄 许可证

MIT License

## 🤝 贡献

欢迎提交Issue和Pull Request！

## 📞 支持

如有问题，请创建Issue或联系维护者。