# StockQuant

**Repository Path**: chenlei1992/StockQuant

## Basic Information

- **Project Name**: StockQuant
- **Description**: 这是一个集合量化交易前端、后端java、后端Python三个内容的项目
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AKShareStock - 股票数据应用

基于AKShare的股票数据查询系统，使用Flask框架开发。

## 项目功能

- 用户注册/登录
- 股票数据查询（基于AKShare）
- MySQL数据存储

## 技术栈

- Python 3.14.2
- Flask
- MySQL 9.6.0
- AKShare
- SQLAlchemy

## 数据库配置

```yaml
host: localhost
port: 3306
user: root
password: admin123456
database: akshare_stock
```

## 详细部署步骤

### 1. 克隆仓库

```bash
git clone https://gitee.com/chenlei1992/StockQuant.git AKShareStock
cd AKShareStock
```

### 2. 创建虚拟环境（推荐）

```bash
python3 -m venv venv
source venv/bin/activate
```

### 3. 安装依赖

```bash
pip3 install -r requirements.txt
```

### 4. 配置MySQL数据库

确保MySQL服务已启动，然后创建数据库：

```bash
mysql -u root -padmin123456 -e "CREATE DATABASE IF NOT EXISTS akshare_stock CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
```

### 5. 启动应用

```bash
python3 app.py
```

应用会自动创建所有数据表。

### 6. 访问应用

浏览器打开: http://127.0.0.1:5000

## 目录结构

```
AKShareStock/
├── app.py              # 主应用入口
├── config.py           # 配置文件
├── models.py           # 数据库模型
├── requirements.txt    # 依赖包
├── README.md          # 项目文档
├── static/            # 静态文件
│   ├── css/
│   └── js/
└── templates/         # HTML模板
    ├── base.html
    ├── login.html
    ├── register.html
    ├── index.html
    ├── profile.html
    ├── 404.html
    └── 500.html
```

## 数据库表结构

### 用户表 (users)

```sql
CREATE TABLE IF NOT EXISTS users (
    id INT AUTO_INCREMENT PRIMARY KEY COMMENT '用户ID',
    username VARCHAR(50) NOT NULL UNIQUE COMMENT '用户名',
    email VARCHAR(100) NOT NULL UNIQUE COMMENT '邮箱',
    password_hash VARCHAR(255) NOT NULL COMMENT '密码哈希',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    last_login_at TIMESTAMP NULL COMMENT '最后登录时间',
    is_active BOOLEAN DEFAULT TRUE COMMENT '是否激活',
    INDEX idx_username (username),
    INDEX idx_email (email)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户表';
```

### 登录日志表 (login_logs)

```sql
CREATE TABLE IF NOT EXISTS login_logs (
    id INT AUTO_INCREMENT PRIMARY KEY COMMENT '日志ID',
    user_id INT NOT NULL COMMENT '用户ID',
    login_ip VARCHAR(45) COMMENT '登录IP',
    login_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '登录时间',
    login_status TINYINT DEFAULT 1 COMMENT '登录状态 1成功 0失败',
    user_agent TEXT COMMENT '浏览器信息',
    FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
    INDEX idx_user_id (user_id),
    INDEX idx_login_time (login_time)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='登录日志表';
```

## API接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /register | GET/POST | 用户注册 |
| /login | GET/POST | 用户登录 |
| /logout | GET | 用户登出 |
| / | GET | 首页（需登录）|
| /profile | GET | 个人中心 |
| /api/user/info | GET | 获取当前用户信息API |

## Git提交记录

| 日期 | 提交说明 |
|------|----------|
| 2025-02-28 | init: 初始化项目结构，创建用户注册/登录功能 |

## 开发日志

### 2025-02-28
- ✅ 初始化项目结构
- ✅ 创建config.py配置文件
- ✅ 创建models.py数据库模型（User, LoginLog）
- ✅ 创建app.py主应用（注册/登录/登出功能）
- ✅ 创建HTML模板（Bootstrap 5风格）
- ✅ 创建requirements.txt依赖文件
- ✅ 编写README.md文档