# TianJiaoElec

**Repository Path**: digitzh/tian-jiao-elec

## Basic Information

- **Project Name**: TianJiaoElec
- **Description**: 天骄公寓电费查询系统
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TianJiaoElec

天骄公寓电费查询系统

![](./doc/img/snapshot.png)

## 功能说明

根据年月和房间号查询电费信息，支持两种数据格式：

### 单月数据
- 每天的用电量（第1天到第31天）
- 电表抄见数
- 电费单价
- 电费金额

### 多月汇总数据
- 汇总期间的电表计量
- 电费单价
- 电费总金额

## 安装依赖

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

## 使用方法

### Flask 可视化界面

启动基于 Flask 的轻量级可视化查询界面：

```bash
python src/web_app.py
```

浏览器访问 <http://127.0.0.1:5000/>，输入年月与房间号即可查看查询结果。前端页面位于 `templates/index.html`，静态资源位于 `static/`。
> 提示：Web 界面直接复用命令行的查询逻辑，通过 `/api/query` 接口返回结构化数据并以可视化样式展示。


### 交互式模式

```bash
python src/main.py
```

按照提示输入：
1. 年月（格式：2024.09）
2. 房间号（如：1119）

程序会自动判断是单月数据还是汇总数据。

> 注：由于2025年7-9月数据格式太复杂，难以支持，请手动查询...

### 命令行参数模式

支持通过命令行参数直接查询，结果默认保存到文件：

```bash
python src/main.py <年月> <房间号>
```

**参数说明：**
- `年月`：格式为 `YYYY.MM`（如：`2024.09`）
- `房间号`：4位数字（如：`1119`）

**选项：**
- `--console`：输出到控制台而不是文件
- `--output <文件路径>` 或 `-o <文件路径>`：指定输出文件路径（默认根据参数自动生成）

**输出文件命名规则：**
- 单月数据：`YYYY_MM_RoomNumber.txt`（如：`2024_09_1001.txt`）
- 汇总数据：`YYYY_MM-MM_RoomNumber.txt`（如：`2025_01-02_1001.txt`）

**示例：**
```bash
# 查询并保存到文件（自动生成文件名）
python src/main.py 2024.09 1001

# 查询并输出到控制台
python src/main.py 2024.09 1001 --console

# 查询并保存到指定文件
python src/main.py 2024.09 1001 -o my_result.txt

# 查看帮助信息
python src/main.py --help
```

### 直接使用查询模块

如果需要单独使用单月或汇总查询模块：

```bash
# 单月数据查询
python src/query_single.py 2024.09 1001

# 汇总数据查询
python src/query_summary.py 2025.01 1001
```

### 查询示例

#### 单月数据查询

**交互式查询：**
```
请输入年月（格式：2024.09）: 2024.10
请输入房间号（如：1119）: 1119
```

**命令行查询：**
```bash
python src/main.py 2024.10 1119
```

**输出示例：**
```
找到数据文件: 2024年10月.csv

==================================================
查询结果 - 房间号: 1119
==================================================
第1天用电量: 3.2
第2天用电量: 2.79
...
第31天用电量: 3.1
电表抄见数: 92.34
电费单价: 0.629
电费金额: 58.08
==================================================
```

#### 汇总数据查询

**交互式查询：**
```
请输入年月（格式：2024.09）: 2025.01
请输入房间号（如：1119）: 1001
```

**命令行查询：**
```bash
python src/main.py 2025.01 1001
# 结果保存到：2025_01-02_1001.txt
```

**输出示例：**
```
找到数据文件: 2025年1-2月.csv
信息已汇总至2025年1-2月

==================================================
查询结果 - 房间号: 1001
==================================================
1.1-2.28电表计量：512.18
电费单价：0.629
电费总金额：322.16
==================================================
```

## 程序结构

```
TianJiaoElec/
├── src/
│   ├── main.py              # 主程序入口（自动判断查询类型）
│   ├── query_single.py      # 单月数据查询模块
│   └── query_summary.py     # 汇总数据查询模块
├── util/
│   ├── xlsx2csv.py          # 单月数据转换工具
│   └── xlsx2csv_summary.py  # 汇总数据转换工具
├── data/                    # 数据文件目录（CSV和Excel）
└── README.md                # 本文件
```