# lending_index_system

**Repository Path**: cooltange/lending_index_system

## Basic Information

- **Project Name**: lending_index_system
- **Description**: 框架程序设计(Python) 实训项目
银行放贷指标查询系统
Design by CQIE BigData Tange
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 48
- **Created**: 2025-05-03
- **Last Updated**: 2025-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目开发环境搭建说明

## 一、项目简介
本项目为基于 框架程序设计(Python) 实训项目 银行放贷指标查询系统，适用于本地开发和测试环境。

## 二、环境要求
- 操作系统：Windows（推荐）
- Python 版本：3.10 及以上
- MySQL 数据库：8.0 或 MariaDB 10.5 及以上
- pip 包管理工具
- 推荐使用虚拟环境（如 venv）

## 三、项目结构
- `manage.py`：Django 项目管理入口
- `lending_index/`：主项目配置目录
- `query/`：业务应用目录
- `requirements.txt`：依赖包列表
- `static/`、`templates/`：静态文件与模板目录

## 四、安装步骤

### 1. 克隆或下载项目代码（强烈推荐右上角点击Fork操作到自己的私人仓库）
```bash
git clone https://gitee.com/cooltange/lending_index_system.git
cd lending_index_system
```

### 2. 创建并激活虚拟环境(在Pycharm下会自动创建)
```bash
python -m venv .venv
.venv\Scripts\activate
```

### 3. 安装依赖包(在Pycharm下会自动安装)
```bash
pip install -r requirements.txt
```

### 4. 配置数据库
请确保本地已安装并启动 MySQL，创建数据库 `lending_index`，编码utf8mb4_general_ci，并在 `lending_index/settings.py` 中配置好数据库用户名、密码以及端口号：
```python
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'lending_index',
        'USER': 'root',
        'PASSWORD': 'root',
        'HOST': 'localhost',
        'PORT': '3306',
    }
}
```
如有需要请修改为实际数据库账号信息。

### 5. 初始化数据库表
```bash
python manage.py makemigrations
python manage.py migrate
```

### 6. 导入初始数据（可选）
如需导入初始数据，可运行：
```bash
python init_data.py
```
或直接加载数据（包含用户、用户组以及业务样本数据）：
```bash
python manage.py loaddata query/fixtures/initial_data.json
```

### 7. 创建超级用户（如果直接使用初始化数据,跳过）
```bash
python manage.py createsuperuser
```

### 8. 启动开发服务器
```bash
python manage.py runserver
```

浏览器访问 [http://127.0.0.1:8000/](http://127.0.0.1:8000/) 即可进入系统。

## 五、常见问题
- 若遇到依赖安装失败，请检查 Python 版本及 pip 是否为最新版。
- 数据库连接异常请确认 MySQL 服务已启动且账号密码正确。
- 如需自定义端口，运行服务器时可加端口号参数：
  ```bash
  python manage.py runserver 8080
  ```

## 六、参考文档
- [Django 官方文档](https://docs.djangoproject.com/zh-hans/5.2/)
- [MySQL 官方文档](https://dev.mysql.com/doc/)