┌──────────────────────────────────────────────────────────┐│                     浏览器 (Client)                       ││  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐ ││  │ 首页概览  │  │ 排行分析  │  │ 地图可视化│  │ 大屏展示  │ ││  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘ ││       │              │              │              │       ││       └──────────────┴──────────────┴──────────────┘       ││                         │ AJAX / fetch                     │└─────────────────────────┼──────────────────────────────────┘                          │ HTTP (JSON)┌─────────────────────────┼──────────────────────────────────┐│                   FastAPI Server                            ││  ┌──────────┐  ┌───────────────────────────────────────┐  ││  │ Page     │  │           API Routers                  │  ││  │ Routes   │  │  /auth  /api/hurun  /api/private      │  ││  │ (Jinja2) │  │  /api/forbes  /api/analysis           │  ││  └──────────┘  └───────────────────┬───────────────────┘  ││                                     │                      ││  ┌──────────────────────────────────┴──────────────────┐  ││  │              SQLAlchemy ORM                          │  ││  │  Models: User, HurunBrand, PrivateEnterprise,       │  ││  │          ForbesGlobal                                │  ││  └──────────────────────────┬──────────────────────────┘  │└─────────────────────────────┼──────────────────────────────┘                              │┌─────────────────────────────┼──────────────────────────────┐│                      MySQL Database                        ││                   design_119_company                        ││  ┌────────┐ ┌──────────────┐ ┌────────────────┐           ││  │ users  │ │hurun_brand   │ │private_enterprise│          ││  └────────┘ └──────────────┘ └────────────────┘           ││                        ┌────────────┐                      ││                        │forbes_global│                      ││                        └────────────┘                      │└────────────────────────────────────────────────────────────┘

119-基于Python的各类企业排行数据可视化分析系统/├── code/│   ├── app/│   │   ├── __init__.py│   │   ├── main.py              # FastAPI应用入口，路由注册│   │   ├── config.py            # 配置常量(DB连接、JWT密钥)│   │   ├── database.py          # SQLAlchemy引擎和会话工厂│   │   ├── models.py            # ORM模型定义(4张表)│   │   ├── schemas.py           # Pydantic请求/响应模型│   │   ├── routers/│   │   │   ├── auth.py          # 认证路由(注册/登录/鉴权)│   │   │   ├── hurun.py         # 胡润榜数据API│   │   │   ├── private.py       # 民营企业数据API│   │   │   ├── forbes.py        # 福布斯数据API│   │   │   └── analysis.py      # 跨排行榜分析API(17个接口)│   │   ├── services/│   │   │   ├── crawler.py       # Firecrawl网页爬虫│   │   │   └── data_loader.py   # CSV/Excel批量导入│   │   └── static/│   │       └── css/│   │           └── style.css    # 全局样式(Luxury Dark主题)│   ├── templates/│   │   ├── base.html            # 基础布局模板(侧边栏+顶栏)│   │   ├── index.html           # 首页数据概览│   │   ├── login.html           # 登录页│   │   ├── register.html        # 注册页│   │   ├── profile.html         # 个人中心│   │   ├── hurun.html           # 胡润百富榜分析│   │   ├── private.html         # 民营企业500强分析│   │   ├── forbes.html          # 福布斯全球2000强分析│   │   ├── map_china.html       # 中国地图│   │   ├── map_world.html       # 全球地图│   │   ├── dashboard.html       # 数据分析仪表盘(20图表)│   │   └── screen.html          # 全屏可视化大屏│   ├── run.py                   # 启动脚本(uvicorn)│   ├── import_scraped2.py       # 数据导入: 胡润2022/2023, 民营2023│   ├── import_scraped_data.py   # 数据导入: 胡润2024, 福布斯2024│   ├── import_2025_data.py      # 数据导入: 2025年三大榜单│   ├── scraped_data.py          # 原始数据定义(硬编码)│   └── import_data.py           # 通用数据导入工具└── 技术文档.md                   # 本文档

用户访问页面 ──→ FastAPI Page Route ──→ Jinja2渲染HTML ──→ 浏览器                                                                │                                                          JS加载后                                                                │                                                    checkAuth()验证token                                                                │                                                    ┌───────────┴───────────┐                                                    │                       │                                              有token且有效            无token或无效                                                    │                       │                                            加载数据(ECharts)         跳转到 /login                                                    │                                            fetch('/api/...')                                                    │                                            Authorization: Bearer                                                     │                                            FastAPI API Route                                                    │                                            SQLAlchemy查询MySQL                                                    │                                            返回JSON ──→ ECharts渲染图表

{    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",    "token_type": "bearer",    "user": {"id": 1, "username": "admin", "email": null}}

注册流程:  用户提交 ──→ POST /auth/register              ├── 校验用户名唯一性              ├── BCrypt哈希密码              └── 写入users表登录流程:  用户提交 ──→ POST /auth/login              ├── 查询用户名              ├── BCrypt验证密码              ├── 生成JWT(sub=username, exp=60min)              └── 返回 {token, user}鉴权流程:  API请求 ──→ Authorization: Bearer               ├── jwt.decode(token, SECRET_KEY, HS256)              ├── 查询users表获取用户              └── 注入到路由参数

PROVINCE_SHORT = {    '北京市': '北京', '天津市': '天津', '河北省': '河北',    '山西省': '山西', '内蒙古自治区': '内蒙古', ...}def norm_province(name):    return PROVINCE_SHORT.get(name, name.rstrip('省市'))

CN_TO_EN = {    '中国石油': 'PetroChina', '阿里巴巴': 'Alibaba Group',    '中国银行': 'Bank of China', '腾讯': 'Tencent Holdings', ...}

:root {    --bg-primary: #06060b;         /* 页面背景(近黑) */    --bg-card: #151520;            /* 卡片背景(深灰) */    --accent-primary: #c9a84c;     /* 主色调(暖金) */    --text-primary: #f0ece2;       /* 主文字(暖白) */    --font-display: 'Cormorant Garamond';  /* 标题字体 */    --font-body: 'DM Sans';        /* 正文字体 */    --font-mono: 'JetBrains Mono'; /* 等宽字体 */}

# 1. 克隆项目cd "119-基于Python的各类企业排行数据可视化分析系统/code"# 2. 安装依赖pip install fastapi uvicorn sqlalchemy pymysql pydantic python-jose[cryptography] passlib[bcrypt] pandas openpyxl# 3. 创建MySQL数据库mysql -u root -p -e "CREATE DATABASE design_119_company CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"# 4. 修改数据库配置 (如需)# 编辑 app/config.py 中的 DB_USER, DB_PASSWORD, DB_HOST 等# 5. 导入数据python import_scraped2.py       # 胡润2022/2023, 民营2023python import_scraped_data.py   # 胡润2024, 福布斯2024python import_2025_data.py      # 2025年三大榜单# 6. 启动服务python run.py

http://127.0.0.1:8000          # 首页http://127.0.0.1:8000/login    # 登录页http://127.0.0.1:8000/docs     # Swagger API文档

# 示例: 导入新年度数据from app.models import HurunBrandfrom decimal import Decimalrecord = HurunBrand(    year=2026,    ranking=1,    brand_name="某品牌",    brand_value=Decimal("10000000000"),    parent_company="某公司",    industry="某行业")db.add(record)db.commit()

@router.get("/new-endpoint")def new_endpoint(year: int = None, db: Session = Depends(get_db)):    query = db.query(Model)    if year:        query = query.filter(Model.year == year)    return query.all()