fatemaster/README.md

# FateMaster - 命运大师八字算命网站

一个功能完整的八字算命网站，支持多种卜卦方式、多语言、响应式设计。

## 技术栈

### 前端
- **Vue 3** + **TypeScript** + **Vite**
- **Ant Design Vue** - UI组件库
- **Vue Router** - 路由管理
- **Pinia** - 状态管理
- **vue-i18n** - 国际化
- **Axios** - HTTP客户端

### 后端
- **ASP.NET Core 8** - Web API框架
- **Entity Framework Core** - ORM
- **Pomelo.EntityFrameworkCore.MySql** - MySQL数据库驱动

### 数据库
- **MySQL** 8.0+

## 项目结构

```
fatemaster/
├── frontend/
│   ├── fatemaster-web/      # 用户端前端
│   └── fatemaster-admin/    # 管理后台前端
├── backend/
│   └── FateMaster.API/      # .NET后端API
└── docs/                    # 文档
```

## 功能特性

### 用户端功能
- ✅ 批八字 - 详细的生辰八字分析
- ✅ 事业运势 - 职业发展预测
- ✅ 姻缘测算 - 婚姻关系分析
- ✅ 塔罗占卜 - 互动式塔罗牌选择
- ✅ 星座运势 - 12星座每日/每周/每月运势
- ✅ 多语言支持 - 简体中文、繁体中文、英文、日语
- ✅ 响应式设计 - 支持PC、平板、手机
- ✅ 支付集成 - 支付宝、PayPal、Stripe

### 管理后台功能
- ✅ 仪表盘 - 数据统计概览
- ✅ 卜卦记录管理 - 查看和筛选所有记录
- ✅ 价格配置 - 动态调整各服务价格
- ✅ 统计分析 - 订单量、收入等数据分析

## 快速开始

### 环境要求
- Node.js 18+
- .NET 8 SDK
- MySQL 8.0+

### 1. 安装前端依赖

```bash
# 用户端
cd frontend/fatemaster-web
npm install

# 管理后台
cd frontend/fatemaster-admin
npm install
```

### 2. 配置数据库

创建MySQL数据库：
```sql
CREATE DATABASE fatemaster CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

修改 `backend/FateMaster.API/appsettings.json`：
```json
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Port=3306;Database=fatemaster;User=root;Password=your_password;"
  }
}
```

### 3. 运行数据库迁移

```bash
cd backend/FateMaster.API
dotnet ef migrations add InitialCreate
dotnet ef database update
```

### 4. 启动服务

```bash
# 启动后端API (端口5000)
cd backend/FateMaster.API
dotnet run

# 启动用户端 (端口3000)
cd frontend/fatemaster-web
npm run dev

# 启动管理后台 (端口3001)
cd frontend/fatemaster-admin
npm run dev
```

### 访问地址
- 用户端: http://localhost:3000
- 管理后台: http://localhost:3001
- API文档: http://localhost:5000/swagger

## 配置说明

### 支付配置
在 `appsettings.json` 中配置支付信息：

```json
{
  "PaymentSettings": {
    "Alipay": {
      "AppId": "your_app_id",
      "PrivateKey": "your_private_key",
      "PublicKey": "alipay_public_key"
    },
    "PayPal": {
      "ClientId": "your_client_id",
      "ClientSecret": "your_client_secret",
      "Mode": "sandbox"
    },
    "Stripe": {
      "SecretKey": "your_secret_key",
      "PublishableKey": "your_publishable_key"
    }
  }
}
```

### AI配置
配置AI大模型API（用于解读算命结果）：

```json
{
  "AISettings": {
    "Provider": "OpenAI",
    "ApiKey": "your_api_key",
    "Model": "gpt-4",
    "BaseUrl": "https://api.openai.com/v1"
  }
}
```

## 数据库表结构

### DivinationRecords - 卜卦记录表
- Id - 主键
- Type - 卜卦类型 (bazi, career, marriage, tarot, zodiac)
- InputData - 用户输入数据(JSON)
- TraditionalResult - 传统算法结果(JSON)
- AIInterpretation - AI解读结果
- PaymentStatus - 支付状态 (pending, paid, failed)
- PaymentMethod - 支付方式
- Amount - 金额
- ClientIp - 客户端IP
- Language - 语言
- CreatedAt - 创建时间

### PriceConfig - 价格配置表
- Id - 主键
- ServiceType - 服务类型
- Price - 价格
- Currency - 货币
- IsEnabled - 是否启用

### SystemConfig - 系统配置表
- Id - 主键
- ConfigKey - 配置键
- ConfigValue - 配置值
- Description - 描述

## 待实现功能

### 支付集成
需要实现以下支付服务类：
- AlipayService - 支付宝支付
- PayPalService - PayPal支付
- StripeService - Stripe支付

参考位置：`backend/FateMaster.API/Services/Payment/`

### AI集成
需要实现AI服务类：
- AIService - 调用大模型API解读算命结果

参考位置：`backend/FateMaster.API/Services/AI/`

### 算命算法
需要实现传统算法类：
- BaZiService - 八字排盘算法
- TarotService - 塔罗牌解读算法
- ZodiacService - 星座运势算法

参考位置：`backend/FateMaster.API/Services/Divination/`

## 部署建议

### 生产环境配置

1. **前端**
   - 使用 `npm run build` 构建生产版本
   - 部署到 Nginx 或其他静态文件服务器
   - 配置反向代理到后端API

2. **后端**
   - 使用 `dotnet publish -c Release` 构建发布版本
   - 部署到 Linux 服务器
   - 使用 Nginx 作为反向代理
   - 配置 SSL 证书

3. **数据库**
   - 使用独立的MySQL服务器
   - 配置定期备份
   - 优化索引和查询性能

### Nginx配置示例

```nginx
# 用户端
server {
    listen 80;
    server_name your-domain.com;
    root /var/www/fatemaster-web/dist;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api {
        proxy_pass http://localhost:5000;
    }
}

# 管理后台
server {
    listen 80;
    server_name admin.your-domain.com;
    root /var/www/fatemaster-admin/dist;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api {
        proxy_pass http://localhost:5000;
    }
}
```

## 开发注意事项

1. **环境变量**
   - 敏感信息（API密钥、数据库密码）应使用环境变量
   - 不要将密钥提交到代码仓库

2. **CORS配置**
   - 生产环境需要更新CORS白名单
   - 移除开发环境的localhost地址

3. **日志记录**
   - 配置适当的日志级别
   - 使用日志聚合工具（如ELK）

4. **性能优化**
   - 前端使用懒加载
   - 后端使用缓存（Redis）
   - 数据库查询优化

## License

MIT License

## 联系方式

如有问题，请提交Issue或联系开发团队。