# yj-platform

**Repository Path**: Vincentor/yj-platform

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# yj-platform

## 项目简介

`yj-platform` 是一个基于 Spring Boot / Spring Cloud 技术栈构建的**专家咨询与服务平台**。该项目集成了专家管理、在线订单、钱包结算、即时通讯（IM）、音视频通话（RTC）以及 AI 人工智能（聊天对话、绘画生成）等核心业务模块。

平台采用前后端分离架构，后端主要包含核心业务模块 (`yj-core`) 与通用框架模块 (`yj-framework`)，并提供了完善的管理后台 API 与用户移动端 API。

## 技术栈

*   **核心框架**: Spring Boot, Spring Cloud (待定/兼容)
*   **持久层**: MyBatis Plus
*   **缓存与消息**: Redis, RabbitMQ / Kafka / RocketMQ (消息队列)
*   **安全**: Spring Security, OAuth2
*   **API 文档**: Swagger (Knife4j)
*   **分布式链路追踪**: SkyWalking
*   **文件存储**: MinIO / OSS (集成预留)

## 项目结构

```text
├── yj-admin                          # 项目主目录
│   ├── yj-core                       # 核心业务模块
│   │   ├── controller                # 控制器层 (Admin & App API)
│   │   ├── dal                       # 数据访问层 (Mapper, DO)
│   │   └── service                   # 业务逻辑层 (Service & ServiceImpl)
│   ├── yudao-framework               # 通用基础框架
│   │   ├── yudao-common              # 通用工具与常量
│   │   ├── yudao-spring-boot-starter-* # 自动配置模块 (安全、租户、Redis、Web等)
│   └── yudao-module-ai               # AI 人工智能模块
```

## 核心功能模块

### 1. 专家服务 (Expert)
*   **专家入驻**: 用户可提交申请（姓名、职称、简介、标签等），由管理员进行审核。
*   **专家展示**: 用户可浏览已审核通过的专家列表，查看专家详情、评分、服务人数及价格。
*   **后台管理**: 支持专家信息的增删改查及状态管理。

### 2. 订单系统 (Order)
*   **咨询下单**: 用户可选择专家创建咨询订单，填写咨询描述与预约时间。
*   **订单流程**: 支持模拟支付、咨询进行、确认完成、取消订单等全生命周期管理。
*   **双向视图**: 买家（用户）与卖家（专家）拥有各自的订单列表查询接口。

### 3. 钱包与结算 (Wallet)
*   **资产管理**: 专家拥有独立钱包，记录余额、冻结金额与累计收益。
*   **资金流水**: 记录每一笔收入与支出的详细流水。
*   **提现系统**: 支持专家发起提现申请，管理员进行审核与打款（驳回/通过）。

### 4. 沟通系统 (Chat & Review)
*   **即时通讯 (IM)**: 基于订单的实时聊天功能，支持用户与专家在线沟通。
*   **音视频连线 (RTC)**: 提供创建/加入音视频房间的能力，用于远程咨询。
*   **评价系统**: 订单完成后，用户可对专家服务进行评价与打分。

### 5. 人工智能模块 (AI)
*   **智能对话**: 集成 AI 大模型，支持流式/段式发送消息，构建上下文对话。
*   **AI 绘图**: 支持文生图（Draw）以及集成 Midjourney 等第三方接口进行图片生成。

## API 接口概览

### 管理后台 API (`/admin` 或 `/yjcore`)
*   `/yjcore/expert`: 专家的增删改查与审核接口。
*   `/yjcore/order`: 订单状态管理、分页查询。
*   `/yjcore/withdrawal`: 提现申请的审核与结算。
*   `/yjcore/chat`: 聊天记录的查询与管理。

### 用户 App API (`/app` 或 `/yj-core`)
*   `/yj-core/auth`: 邮箱登录、注册、验证码发送。
*   `/yj-core/expert`: 专家列表查询、入驻申请、我的专家信息。
*   `/yj-core/order`: 创建订单、我的订单（买家/专家视角）、模拟支付。
*   `/yj-core/wallet`: 获取钱包余额、申请提现、查询交易流水。
*   `/yj-core/chat`: 发送消息、查询聊天记录、创建RTC房间。

### AI 模块 API
*   `/ai/chat/conversation`: AI 对话会话管理。
*   `/ai/chat/message`: AI 消息发送（支持流式输出）与历史查询。
*   `/ai/image`: AI 绘画生成与查询。

## 快速开始

### 环境要求
*   JDK 17+
*   MySQL 8.0+
*   Redis 6.0+
*   Maven 3.8+

### 数据库配置
1.  创建数据库 `yj_platform`。
2.  执行 `sql/mysql/` 目录下的初始化 SQL 文件（如 `ruoyi-vue-pro.sql` 及相关表结构）。
3.  配置 `application.yml` 中的数据库连接信息。

### 编译运行
```bash
# 克隆项目后，在 yj-admin 根目录执行
mvn clean package -DskipTests

# 启动服务
java -jar target/yj-admin.jar
```

## License

本项目基于 [MIT License](LICENSE) 开源。