sleep-tracker Docker镜像文档

镜像概述

sleep-tracker是一个轻量级Docker镜像，专注于个人睡眠数据的跟踪、记录与分析。该镜像集成了睡眠数据采集、处理及可视化功能，用户可通过简单配置快速部署，实现对睡眠时长、睡眠周期、睡眠中断等关键指标的监测与评估，为个人健康管理和睡眠研究提供数据支持。

核心功能与特性

• 睡眠数据记录：支持手动输入睡眠起止时间、睡眠中断次数等基础数据，或通过API接口同步智能手环、睡眠监测设备数据。
• 睡眠周期分析：自动识别并划分睡眠周期（浅睡、深睡、REM睡眠），计算各周期占比及时长。
• 睡眠质量评估：基于睡眠时长、睡眠效率（卧床时间与实际睡眠时间占比）、中断频率等指标，生成睡眠质量评分。
• 数据可视化：提供睡眠趋势图表（如每日/每周睡眠时长变化、睡眠周期分布饼图），支持导出PNG/JPG格式报告。
• 数据持久化：支持本地文件存储（JSON/CSV格式）或集成MySQL、SQLite数据库，确保睡眠数据长期保存。

使用场景与适用范围

• 个人健康管理：普通用户通过部署该镜像，实时监测自身睡眠状况，调整作息***惯。
• 健康应用集成：作为第三方健康管理平台的组件，提供睡眠数据采集与分析能力。
• 睡眠研究辅助：科研人员可利用该镜像收集标准化睡眠数据，支持小规模睡眠模式研究。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动sleep-tracker容器：

docker run -d \
  --name sleep-tracker \
  -p 8080:8080 \  # 映射Web界面端口
  -v /path/to/local/data:/app/data \  # 挂载本地目录持久化数据
  -e TZ=Asia/Shanghai \  # 设置时区
  sleep-tracker

启动后，通过浏览器访问http://localhost:8080进入Web管理界面。

环境变量配置

数据导入与导出

• 数据导入：将CSV/JSON格式的睡眠数据文件放入/app/data/import目录（需提前在挂载的本地目录创建import子目录），容器启动后会自动导入数据。
• 数据导出：在Web界面的“数据管理”模块，选择导出时间范围及格式（CSV/PNG），文件将保存至/app/data/export目录。

Docker Compose配置示例

以下是集成MySQL数据库的docker-compose.yml配置示例：

version: '3'
services:
  sleep-tracker:
    image: sleep-tracker
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai
      - DATA_STORAGE=db
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=sleepuser
      - DB_PASSWORD=sleeppass
      - DB_NAME=sleep_tracker
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=sleep_tracker
      - MYSQL_USER=sleepuser
      - MYSQL_PASSWORD=sleeppass

volumes:
  mysql-data:

执行docker-compose up -d启动服务，通过http://localhost:8080访问。