# zhyq

**Repository Path**: wangxinjiei/zhyq

## Basic Information

- **Project Name**: zhyq
- **Description**: 臻核引擎
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-12
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZZYQ-FastAPI

## 项目结构
```
zzyq/
├── app/
│   ├── __init__.py
│   ├── main.py                 # FastAPI应用入口
│   ├── config.py               # 配置文件
│   ├── database.py             # 数据库连接
│   ├── auth/                   # 认证相关
│   │   ├── __init__.py
│   │   ├── jwt_handler.py      # JWT处理
│   │   ├── auth_handler.py     # 认证逻辑
│   │   └── dependencies.py     # 认证依赖
│   ├── models/                 # 数据模型
│   │   ├── __init__.py
│   │   ├── user.py
│   │   └── user.py
│   ├── schemas/                # Pydantic模式
│   │   ├── __init__.py
│   │   ├── user.py
│   │   └── common.py
│   │   └── common.py
│   ├── api/                    # API路由
│   │   ├── __init__.py
│   │   ├── deps.py             # 依赖注入
│   │   └── v1/
│   │       ├── __init__.py
│   │       ├── auth.py
│   │       ├── users.py

│   │       └── dashboard.py
│   ├── crud/                   # 数据库操作
│   │   ├── __init__.py
│   │   ├── base.py
│   │   ├── user.py

│   └── utils/                  # 工具函数
│       ├── __init__.py
│       ├── security.py         # 安全工具
│       ├── logger.py           # 日志工具
│       └── common.py           # 通用工具
├── alembic/                    # 数据库迁移
│   ├── env.py
│   └── versions/
├── scripts/                    # 脚本文件
│   ├── init_db.py             # 数据库初始化
│   └── import_data.py         # 数据导入
├── tests/                      # 测试文件
│   ├── __init__.py
│   ├── conftest.py

├── requirements.txt            # 依赖包
├── alembic.ini                # 数据库迁移配置
├── .env                       # 环境变量
├── .gitignore
└── README.md
```

## 安装和运行指南

### 1. 环境准备
```bash
# 创建虚拟环境
python -m venv zzyq
source zzyq/bin/activate  # Linux/Mac
# 或
zzyq\Scripts\activate     # Windows

# 安装依赖
pip install -r requirements.txt

# 设置环境变量
cp .env.example .env
# 编辑 .env 文件配置数据库连接等信息

# 如果使用阿里云OSS，需要在.env文件中配置以下信息：
# OSS_ACCESS_KEY_ID=your_access_key_id
# OSS_ACCESS_KEY_SECRET=your_access_key_secret
# OSS_ENDPOINT=https://oss-cn-beijing.aliyuncs.com
# OSS_BUCKET_NAME=your_bucket_name
# OSS_BUCKET_DOMAIN=your_bucket_domain
```

### 2. 数据库初始化
```bash
# 初始化数据库
python scripts/init_db.py

# 运行数据库迁移
alembic upgrade head

# 导入初始数据（可选）
python scripts/import_data.py
```

### 3. 启动应用
```bash
# 开发模式启动
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# 访问API文档
# http://localhost:8000/docs (Swagger UI)
# http://localhost:8000/redoc (ReDoc)
```

## 核心功能特性

### ✅ 已实现功能
- 用户认证和授权（JWT）

- 搜索和过滤
- 数据导入导出
- API文档自动生成
- 日志记录
- 异常处理
- 数据验证

### 🚀 API接口预览
```
POST   /api/v1/auth/login          # 用户登录
POST   /api/v1/auth/register       # 用户注册

GET    /api/v1/dashboard/stats     # 获取统计数据

POST   /api/v1/upload/file         # 上传文件到阿里云OSS
POST   /api/v1/upload/bytes        # 上传字节数据到阿里云OSS
```

### 📊 数据统计功能

- 用户活跃度统计

### 🔒 安全特性
- JWT Token认证
- 密码加密存储
- SQL注入防护
- CORS跨域配置
- 请求频率限制
- 输入数据验证

### 📈 性能优化
- 数据库连接池
- 查询结果缓存
- 分页查询优化
- 索引优化
- 异步处理

## 使用示例

## 部署说明

### Docker部署（推荐）
```bash
# 构建镜像
docker build -t ip-persona-system .

# 运行容器
docker run -d \
  -p 8000:8000 \
  -e DATABASE_URL="mysql://user:pass@host:3306/db" \
  -e SECRET_KEY="your-secret-key" \
  ip-persona-system
```

### 生产环境部署
```bash
# 使用Gunicorn运行
gunicorn app.main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000

# 或使用Supervisor管理进程
supervisord -c supervisord.conf
```

## 下一步开发计划

### Phase 1: 当前版本功能完善
- [x] 基础CRUD操作
- [x] 用户认证系统
- [x] 版本控制
- [x] 搜索过滤功能

### Phase 2: 高级功能扩展
- [ ] AI内容分析和建议
- [ ] 批量操作功能
- [ ] 数据导入导出优化
- [ ] 实时通知系统

### Phase 3: 性能和监控
- [ ] Redis缓存集成
- [ ] 监控和日志分析
- [ ] 性能优化
- [ ] 自动备份系统

---

这个项目为您提供了一个完整、可扩展的个人IP管理后端系统，支持您的专业内容管理和商业化需求。