# project_cursor

**Repository Path**: system/project_cursor

## Basic Information

- **Project Name**: project_cursor
- **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-03-20
- **Last Updated**: 2025-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 多功能Web应用

一个基于Flask的多功能Web应用，集成了多种功能模块，包括智能搜索、AI助手和影视中心等。

## 功能特性

- **用户认证系统**：安全的登录功能，支持会话管理
- **仪表盘界面**：直观的用户仪表盘，展示系统各功能模块
- **智能搜索**：基于Google Custom Search API的搜索功能，支持网页、图片、新闻和视频搜索
- **AI智能助手**：集成Gemini AI模型，支持文本对话和图像分析
- **影视中心**：集成多个影视资源API，支持影视搜索、分类浏览和在线播放
- **响应式设计**：适配各种设备屏幕尺寸

## 系统架构

- **前端**：HTML/CSS/JavaScript，基于Bootstrap框架
- **后端**：Python Flask框架
- **API集成**：Google Custom Search API、Gemini AI API、影视资源API
- **配置管理**：基于环境变量和配置文件的统一配置系统
- **数据存储**：SQLite数据库（开发环境）和PostgreSQL（生产环境）

## 项目结构


├── app/                       # 应用主目录
│   ├── __init__.py            # 初始化应用
│   ├── models/                # 模型定义
│   │   ├── __init__.py
│   │   ├── user.py            # 用户模型
│   │   └── movie.py           # 影视模型
│   ├── views/                 # 视图函数/路由处理
│   │   ├── __init__.py
│   │   ├── auth.py            # 认证相关
│   │   ├── pages.py           # 基本页面
│   │   ├── search.py          # 搜索功能
│   │   ├── ai_assistant.py    # AI助手功能
│   │   ├── admin/             # 管理功能
│   │   │   ├── __init__.py
│   │   │   ├── users.py
│   │   │   └── dashboard.py
│   │   └── movie/
│   │       ├── __init__.py
│   │       └── routes.py
│   ├── services/              # 业务逻辑层
│   │   ├── __init__.py
│   │   ├── user_service.py
│   │   ├── search_service.py
│   │   ├── ai_service.py
│   │   └── movie_service.py
│   ├── utils/                 # 工具函数
│   │   ├── __init__.py
│   │   ├── db.py              # 数据库工具 
│   │   ├── config.py          # 配置工具
│   │   └── helpers.py         # 辅助函数
│   ├── static/                # 静态资源
│   │   ├── css/
│   │   ├── js/
│   │   └── images/
│   └── templates/             # 模板文件
│       ├── layout.html
│       ├── index.html
│       ├── dashboard.html
│       ├── search/
│       │   ├── index.html
│       │   └── results.html
│       ├── ai_assistant/
│       │   ├── chat.html
│       │   └── image_analysis.html
│       ├── admin/
│       │   ├── users.html
│       │   └── dashboard.html
│       └── movie/
│           ├── index.html
│           ├── detail.html
│           └── player.html
├── config/                    # 配置文件
│   ├── __init__.py
│   ├── development.py
│   ├── production.py
│   └── readme.md              # 配置说明文档
├── migrations/                # 数据库迁移文件(使用Alembic)
├── tests/                     # 测试代码
│   ├── __init__.py
│   ├── test_auth.py
│   ├── test_search.py
│   └── test_movie.py
├── .env                       # 环境变量（开发环境）
├── .dockerignore              # Docker忽略文件
├── Dockerfile                 # Docker构建文件
├── docker-compose.yml         # Docker Compose配置
├── .gitignore
├── requirements.txt
├── run.py                     # 应用入口点
└── README.md

## 安装指南

### 方法一：直接安装

1. 克隆项目仓库
   ```
   git clone https://github.com/yourusername/multi-function-web-app.git
   cd multi-function-web-app
   ```

2. 创建虚拟环境（推荐）
   ```
   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   venv\Scripts\activate     # Windows
   ```

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

4. 配置系统
   ```
   # 创建.env文件（开发环境）
   cp .env.example .env
   # 然后编辑.env文件，填入您的API密钥和其他配置
   ```

5. 启动应用
   ```
   python run.py
   ```

6. 访问应用
   ```
   在浏览器中访问 http://127.0.0.1:5000
   ```

### 方法二：使用Docker

1. 构建Docker镜像
   ```
   docker build -t multi-function-app .
   ```

2. 运行容器
   ```
   docker run -d -p 5000:5000 \
     -e SECRET_KEY=your_secret_key \
     -e DATABASE_URL=your_database_url \
     -e GEMINI_API_KEY=your_gemini_key \
     -e GOOGLE_API_KEY=your_google_key \
     -e SEARCH_ENGINE_ID=your_search_engine_id \
     -e DEFAULT_USERNAME=admin \
     -e DEFAULT_PASSWORD=your_password \
     multi-function-app
   ```

## 配置说明

系统配置支持两种环境：

### 开发环境

在开发环境中，可以通过`.env`文件设置配置项：

### 安装依赖
```
#开发时单独安装缺失包
python -m pip install Flask-SQLAlchemy==3.0.3 Flask-Migrate==4.0.4
```