SmartEDT（智能电动车数字孪生系统）代码框架

本仓库提供一套可扩展的系统骨架代码，用于支撑《系统开发技术方案.md》中定义的后端采集处理与桌面端多屏显示能力。

目录结构

SmartEDT/
  backend/
  frontend/
  系统开发技术方案.md

后端（Python 3.13.1 + FastAPI + WebSocket + PostgreSQL/TimescaleDB）

1) 环境准备

• 建议使用 venv：
  • python -m venv venv
  • venv\Scripts\activate
  • pip install -r backend/requirements.txt

2) 配置

• 复制示例配置：
  • copy backend\\config.ini.example backend\\config.ini
• 按需修改 [DATABASE].url（示例密码为占位符 CHANGE_ME）。

也可以通过环境变量覆盖：

• SMARTEDT_DATABASE_URL
• SMARTEDT_FILE_ROOT
• SMARTEDT_HOST
• SMARTEDT_PORT

3) 数据库

需要 PostgreSQL 并安装 TimescaleDB 扩展（数据库侧操作）。后端启动时会尝试：

• CREATE EXTENSION IF NOT EXISTS timescaledb
• create_hypertable('vehicle_signals', 'ts', if_not_exists => TRUE)

4) 启动

• 开发启动：
  • python backend/main.py --host 127.0.0.1 --port 5000 --debug

接口：

• GET /health
• POST /api/simulation/start
• POST /api/simulation/{simulation_id}/stop
• WS /ws

前端（Electron + Vue）

1) 安装依赖

在 frontend/ 目录下执行：

• npm install

2) 开发启动（Vite + Electron）

• npm run dev

Electron 主进程会尝试启动后端：

• 默认使用 python backend/main.py
• 可通过 SMARTEDT_PYTHON 指定 Python 可执行文件路径