# 宇之然 AI (YuZhiRan AI)

AI 学习与实践平台 — 让每个人都能用好 AI

| 信息 | 内容 |
|------|------|
| 品牌 | 宇之然（北京宇之然科技中心） |
| 官网 | https://yuzhiran.com |
| 备域名 | https://yuzhiran.com.cn |
| ICP 备案 | ✅ 已完成 |

## 项目结构

```
ai-learning-platform/
├── README.md                    # 项目说明
├── docs/                        # 项目文档
│   ├── 产品规划书.md            # 完整产品规划（含商业模式、可行性分析）
│   ├── 技术架构设计.md          # 技术选型与系统架构
│   └── 合规与运营方案.md        # ICP合规、数据合规、运营策略
├── frontend/                    # 官网前端（Next.js + Tailwind）
├── mobile/                      # 移动端 App/小程序
├── backend/                     # 后端 API（NestJS + Prisma + MySQL）
│   ├── src/modules/payment/     # 微信支付模块（已完善）
│   ├── src/modules/ai/          # AI模型接入（支持OpenAI兼容接口）
│   └── prisma/                  # 数据模型定义
└── scripts/                     # 工具脚本
    └── setup.sh                 # 项目初始化脚本
```

## 技术栈

### 后端
- **框架**: NestJS (Node.js)
- **ORM**: Prisma
- **数据库**: MySQL
- **支付**: 微信支付 V3 SDK
- **AI接口**: OpenAI兼容接口、DeepSeek、通义千问

### 前端
- **框架**: Next.js 14
- **样式**: Tailwind CSS
- **状态管理**: React Hooks

## 快速开始

### 1. 初始化项目

```bash
cd ai-learning-platform
./scripts/setup.sh
```

### 2. 手动配置

#### 后端配置
编辑 `backend/.env` 文件，配置：
- 微信支付参数（已从 `/www/wwwroot/sharefile/note.txt` 获取）
- AI模型API密钥
- 数据库密码

#### 前端配置
编辑 `frontend/.env.local` 文件，配置API地址。

### 3. 启动开发环境

```bash
# 启动后端（默认端口3000）
cd backend && npm run dev

# 启动前端（默认端口3001）
cd frontend && npm run dev
```

### 4. 访问

- 前端: http://localhost:3001
- 后端API文档: http://localhost:3000/api

## 核心功能

- ✅ 用户系统（注册、登录、会员管理）
- ✅ 微信支付集成（JSAPI/NATIVE/MWEB）
- ✅ 会员订阅管理（月卡/年卡自动续期）
- ✅ AI模型接入（支持美团longcat等OpenAI兼容接口）
- ✅ 课程系统
- ✅ 提示词库
- ✅ AI实操沙箱
- ✅ 社区功能

## 产品定位

面向大众化分领域用户的 AI 学习与实践平台，涵盖：
- AI 基础知识与通识教育
- 提示词工程教学与模板库
- 智能体（Agent）使用教程
- 大模型介绍与选型指南
- AI 实操沙箱体验