# cas

**Repository Path**: hngcadmin/cas

## Basic Information

- **Project Name**: cas
- **Description**: 一个基于 `Python + Flask + HTML + MySQL` 的汽车行业垂类系统，主题聚焦“车市行情 + 市面主流轿车特点”。  
系统包含前端可视化、后端 API、批量真实化数据、智能推荐器，以及接入 DeepSeek 的汽车问答助手。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AutoSage 轿车情报舱

一个基于 `Python + Flask + HTML + MySQL` 的汽车行业垂类系统，主题聚焦“车市行情 + 市面主流轿车特点”。  
系统包含前端可视化、后端 API、批量真实化数据、智能推荐器，以及接入 DeepSeek 的汽车问答助手。

## 功能概览

- 市场总览：展示主流轿车月度销量、均价、同比、折扣、能源结构。
- 车型库：按能源、级别、关键词和排序维度浏览主流轿车。
- 数据可视化：包含销量榜、车系趋势、城市热力图谱。
- 联动详情：点选车系后查看 5 个配置梯度、核心卖点、知识库片段。
- 智能推荐：根据预算、使用场景、能源偏好、关注重点输出 Top 5 车型。
- 垂类问答：先检索本地汽车知识库，再调用 DeepSeek 生成问答；如果 API 不可用，会自动回退到本地知识库回答。

## 技术栈

- 后端：`Flask`、`PyMySQL`
- 前端：`HTML`、`CSS`、`JavaScript`、`ECharts`
- 数据库：`MySQL 8.x`
- AI：`DeepSeek Chat API`

## 项目结构

```text
E:\car
├─ app
│  ├─ services
│  │  ├─ ai_service.py
│  │  └─ data_service.py
│  ├─ static
│  │  ├─ css/style.css
│  │  └─ js/main.js
│  ├─ templates
│  │  ├─ base.html
│  │  └─ index.html
│  ├─ config.py
│  ├─ db.py
│  └─ routes.py
├─ scripts
│  ├─ generate_seed_sql.py
│  └─ smoke_test.py
├─ mysql_init.sql
├─ main.py
├─ requirements.txt
└─ README.md
```

## 数据说明

初始化脚本位于 `mysql_init.sql`，包含数据库、表结构和数据。

- `sedan_catalog`：150 条
- `sales_monthly`：360 条
- `city_market_heat`：240 条
- `qa_knowledge`：140 条

所有表均超过 100 条数据，满足大数据量初始化要求。

## 环境配置

当前目录已放置 `.env`，默认配置如下：

- MySQL 地址：`127.0.0.1:3306`
- 用户名：`root`
- 密码：`123456`
- 数据库：`car_intel`

如需修改，可直接编辑 `.env`。

## 启动步骤

1. 安装依赖

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

2. 生成初始化 SQL

```bash
python scripts/generate_seed_sql.py
```

3. 导入 MySQL

PowerShell:

```powershell
cmd /c "mysql --default-character-set=utf8mb4 -h 127.0.0.1 -P 3306 -u root -p123456 < mysql_init.sql"
```

4. 启动服务

```bash
python main.py
```

5. 浏览器访问

```text
http://127.0.0.1:5000
```

## 自测

运行以下命令可执行接口烟测：

```bash
python scripts/smoke_test.py
```

已覆盖：

- 页面首页
- 市场总览 API
- 车型列表 API
- 车系趋势 API
- 城市热度 API
- 车系详情 API
- 智能推荐 API
- AI 问答 API

## DeepSeek 说明

- 系统默认会优先使用 `.env` 中的 `DEEPSEEK_API_KEY`。
- 如果 DeepSeek 返回鉴权/配额错误，系统会自动回退到本地知识库，不影响主流程可用性。
- 本地实测中，当前提供的 Key 返回了 `401 Authorization Required`，因此问答接口已验证兜底逻辑正常，但未能完成真实模型回答。

## 已完成的本地验证

- `python scripts/generate_seed_sql.py`
- `python -m compileall app main.py scripts\generate_seed_sql.py`
- `cmd /c "mysql --default-character-set=utf8mb4 -h 127.0.0.1 -P 3306 -u root -p123456 < mysql_init.sql"`
- `python scripts/smoke_test.py`