# LingXin-Python

**Repository Path**: liu-wei-chao/ling-xin-python

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-04
- **Last Updated**: 2025-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 灵心Python项目 (Ling-Xin Python Project)

## 项目简介

这是一个基于FastAPI的Python Web应用项目，提供AI聊天、角色管理、支付系统、社交功能等综合服务。

## 主要功能

- 🤖 **AI聊天服务**: 支持多种AI模型的对话功能
- 👤 **用户管理**: 用户注册、登录、角色管理
- 💰 **支付系统**: 支付宝集成、订单管理、VIP服务
- 🎭 **角色系统**: 虚拟角色创建、激活、管理
- 🌐 **WebRTC**: 实时音视频通信
- 📱 **移动端支持**: 移动应用API接口
- 🔔 **通知系统**: 实时通知和提醒
- 📊 **数据统计**: 用户行为分析和报表
- 🎨 **媒体管理**: 图片、音频上传下载
- 🔄 **消息队列**: RabbitMQ集成，异步处理

## 技术架构

- **后端框架**: FastAPI
- **数据库**: MySQL (支持读写分离)
- **缓存**: Redis
- **消息队列**: RabbitMQ
- **异步任务**: Celery
- **WebSocket**: 实时通信
- **AI服务**: 多模型集成
- **支付集成**: 支付宝API

## 项目结构

```
├── main.py                 # 应用入口文件
├── config.ini             # 配置文件
├── requirements.txt        # 依赖包列表
├── services/              # 业务服务层
│   ├── user_service.py    # 用户服务
│   ├── payment_service.py # 支付服务
│   ├── ai_service.py      # AI服务
│   └── ...
├── routes/                # API路由层
│   ├── user_routes.py     # 用户相关路由
│   ├── payment_routes.py  # 支付相关路由
│   ├── chat_routes.py     # 聊天相关路由
│   └── ...
├── database/              # 数据库相关
├── utils/                 # 工具函数
├── tools/                 # 工具脚本
├── static/                # 静态资源
└── docs/                  # 文档
```

## 安装和运行

### 环境要求

- Python 3.8+
- MySQL 5.7+
- Redis 6.0+
- RabbitMQ 3.8+

### 安装步骤

1. 克隆项目
```bash
git clone https://gitee.com/liu-wei-chao/ling-xin-python.git
cd ling-xin-python
```

2. 安装依赖
```bash
pip install -r requirements.txt
```

3. 配置环境
```bash
# 复制配置文件
cp config.ini.example config.ini
# 编辑配置文件，设置数据库、Redis等连接信息
```

4. 初始化数据库
```bash
python init_database.py
```

5. 启动应用
```bash
python main.py
```

### 使用Docker

```bash
# 构建镜像
docker build -t ling-xin-python .

# 运行容器
docker run -d -p 8000:8000 --name ling-xin-app ling-xin-python
```

## API文档

启动应用后，访问以下地址查看API文档：

- Swagger UI: `http://localhost:8000/docs`
- ReDoc: `http://localhost:8000/redoc`

## 配置说明

主要配置项在 `config.ini` 文件中：

- **数据库配置**: MySQL连接池、读写分离设置
- **Redis配置**: 缓存和会话存储
- **AI服务配置**: 各种AI模型的API密钥
- **支付配置**: 支付宝相关配置
- **音频配置**: TTS和音频生成设置

## 部署

### 生产环境部署

1. 使用Nginx作为反向代理
2. 配置SSL证书
3. 使用Supervisor管理进程
4. 配置日志轮转

### 性能优化

- 数据库连接池优化
- Redis集群配置
- 异步任务队列
- 静态资源CDN

## 开发指南

### 代码规范

- 遵循PEP 8编码规范
- 使用类型注解
- 编写单元测试
- 添加适当的注释和文档

### 贡献流程

1. Fork项目
2. 创建功能分支
3. 提交代码
4. 创建Pull Request

## 许可证

本项目采用MIT许可证，详见LICENSE文件。

## 联系方式

- 项目地址: https://gitee.com/liu-wei-chao/ling-xin-python
- 问题反馈: 请在Gitee上提交Issue

## 更新日志

### v1.0.0
- 初始版本发布
- 基础功能实现
- AI聊天服务
- 用户管理系统
- 支付集成