# py-sailboat

**Repository Path**: fun-study/py-sailboat

## Basic Information

- **Project Name**: py-sailboat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-19
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# py-sailboat

帆船训练数据监控系统，通过 MQTT 协议订阅帆船、网关、平板等设备的实时数据，并按日期和训练级别分类存储到本地日志文件。

## 功能特性

- 订阅 MQTT 主题：gateway（环境数据）、mobile（训练数据）、pad（视频录制操作记录数据）、gw（客户端连接状态）
- 按日期、训练级别、运动员分类存储日志

## 环境要求

- Python 3.13+
- Docker & Docker Compose（容器化部署）

## 配置说明

编辑 `config_prod.ini` 文件，配置 MQTT 连接信息和运动员信息：

```ini
[mqtt]
host = your_mqtt_host
port = 1883
username = your_username
password = your_password
```

## 构建与启动

### Docker Compose（推荐）

```bash
# 构建并启动
docker-compose up -d --build

# 查看日志
docker-compose logs -f

# 停止
docker-compose down
```

### 本地运行

```bash
# 安装依赖
uv sync

# 运行
uv run main.py
```

## 订阅数据目录结构

```
log/
└── 2026-06-25/
    ├── ILCA6&7/
    │   └── 杨鑫诺/
    │       ├── record/
    │       ├── train/
    │       ├── compute/
    │       └── original/
    └── env/
```

## 注意事项

- 日志文件通过 volume 挂载到宿主机 `./log` 目录