# bjmtr

**Repository Path**: echo-wind-dev/bjmtr

## Basic Information

- **Project Name**: bjmtr
- **Description**: 北京地铁查询系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-15
- **Last Updated**: 2025-05-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

📘 北京地铁线路管理系统
===
Python 
Flask
### 🚇 项目概述
基于Flask框架构建的地铁线路管理系统，提供以下核心功能：
- **路径规划**：Dijkstra算法实现最短路径查询
- **数据可视化**：动态生成线路拓扑结构
- **运维管理**：支持线路/站点的CRUD操作
- **RESTful API**：标准化接口设计
### 📂 项目结构
```bash
BJMTR/
├── 📁 lengthMap/        # 线路间距数据（CSV格式）
├── 📁 static/           # 静态资源
│   └── 📁 images/       # 系统图标与示意图
│       ├── icon.png     # 应用标识
│       └── map.png      # 线路示意图
├── 📁 templates/        # Jinja2模板
│   ├── admin.html       # 管理控制台
│   └── help.html        # API文档页
├── 📜 app.py            # Flask主程序
├── 📜 base.csv          # 线路基础数据
├── 📜 find_way.py       # 路径规划模块
├── 📜 line.py           # 线路模型（Line/Station类）
└── 📜 read_file.py      # 数据加载模块
```
### ⚙️ 环境配置
```bash
# 依赖安装
pip install flask==2.3.0
# 启动服务（开发模式）
python app.py
```
*访问 ` 查看系统界面*
---
### 📡 API 接口规范
| 端点                 | 方法   | 功能描述                     | 参数示例                  |
|----------------------|--------|----------------------------|--------------------------|
| `/api/get/way`       | GET    | 获取两站间最优路径           | ?start=西直门&end=复兴门  |
| `/api/get/map`       | GET    | 获取完整线路拓扑数据         | -                        |
| `/api/add/station`   | POST   | 新增站点（JSON格式）         | 见接口文档                |
| `/api/del/station`   | POST   | 移除指定站点                 | 见接口文档                |
---
### 📌 开发规范
1. **分支管理**
   - `main` 分支：生产环境代码
2. **提交格式**
```bash
git commit -m "[ADD] 新增线路删除功能 #ISS-12"
```
*类型标识：`[ADD]`/`[FIX]`/`[REFACTOR]`/`[DOCS]`*
---

💡 提示：建议通过Postman进行接口测试，详细API文档见`/templates/help.html`