Зафиксировать рабочий BreathMonitor v1 и сервер

This commit is contained in:
AidarKC
2026-10-25 14:14:27 +03:00
parent 370f4ae94e
commit d5a37d3009
43 changed files with 2490 additions and 1522 deletions
+10
View File
@@ -0,0 +1,10 @@
# Default ignored files
/shelf/
/workspace.xml
# Editor-based HTTP Client requests
/httpRequests/
# Ignored default folder with query files
/queries/
# Datasource local storage ignored files
/dataSources/
/dataSources.local.xml
+2 -2
View File
@@ -2,8 +2,8 @@
This group contains Waveshare ESP32-S3-Touch-AMOLED-2.16 breath-monitor sketches.
- `breath_button_monitor` is the original external-button monitor.
- `breathmonitor_v1 button_monitor` is the original external-button monitor.
- `breath_dual_mode_monitor` supports USB sensor and manual-button modes.
- `manual_monitor_lvgl_v2` is the current LVGL manual monitor.
- `breathmonitor_v2 lvgl` is the current LVGL manual monitor.
- Each AMOLED sketch needs Waveshare's common libraries from the adjacent `SHiNE-product` checkout; its local `es8311` files are included beside the sketch when required.
- Run `./burn.sh <mode>` from this folder to compile or flash.
@@ -1,28 +0,0 @@
# AGENTS
## Назначение папки
Эта папка содержит отдельный ESP32-скетч `breath_dual_mode_monitor.ino` для Waveshare `ESP32-S3-Touch-AMOLED-2.16`.
Скетч совмещает два режима измерения дыхания:
- `START USB SENSOR` — датчик-сухой контакт на USB `D- / D+`;
- `START MANUAL MONITOR` — ручной монитор с двумя внешними кнопками пользователя `KEY3 / GPIO18` и `BOOT / GPIO0`.
- `START POT 3-WIRE` — тест переменного резистора по 3-проводной схеме через `USB D- / D+ / GND`.
- `START POT 2-WIRE` — грубый тест переменного резистора по двум контактам `USB D- / D+`.
- `START POT CAL` — калиброванный грубый тест переменного резистора по двум контактам `USB D- / D+`.
- `START PIN DIAG` — диагностика возможности использовать `USB D- / D+` как GPIO/ADC.
## Обязательная синхронизация
При любом изменении `breath_dual_mode_monitor.ino` обязательно обновлять рядом лежащий `README.md`.
Если меняются экранные тексты, кнопки, режимы старта, пины, настройки, звуковые сигналы, правила подсчёта циклов или поведение тревоги после 60 секунд, описание в `README.md` должно быть обновлено в том же наборе изменений.
Также при изменении поведения скетча обновлять общий reference-документ:
- `../../../../reference/usb_contact_sensor_test_spec.md`
## Язык экрана
Экранные строки в скетче оставлять на английском языке.
@@ -1,160 +0,0 @@
# Breath Dual Mode Monitor
Dual-mode breath monitor для Waveshare `ESP32-S3-Touch-AMOLED-2.16`.
## Режимы
На стартовом экране есть кнопки выбора режима:
- `START USB SENSOR` — использует USB `D- / D+` как сухой контакт.
- `START MANUAL MONITOR` — ручной монитор, использующий две внешние кнопки пользователя.
- `START POT 3-WIRE` — использует USB `D- / D+` и `USB GND` для проверки переменного резистора.
- `START POT 2-WIRE` — грубо оценивает положение переменного резистора только по `D- / D+`.
- `START POT CAL` — калиброванный грубый режим по двум контактам `D- / D+`, показывает положение внутри реально увиденного диапазона.
- `START PIN DIAG` — диагностирует, могут ли USB `D- / D+` реально работать как GPIO/ADC.
`START MANUAL MONITOR` является большой основной кнопкой. Все остальные режимы находятся ниже как компактные служебные кнопки.
## USB Sensor Mode
- `GPIO19 / USB D-` переводится в `OUTPUT LOW`.
- `GPIO20 / USB D+` переводится в `INPUT_PULLUP`.
- Замкнутый контакт считается `EXHALE`.
- Разомкнутый контакт считается `INHALE`.
- Короткие USB-циклы меньше 3 секунд не считаются завершённым циклом: время текущего цикла продолжает идти от предыдущего принятого `EXHALE`.
- Короткое нажатие `KEY3 / GPIO18` открывает или закрывает settings в USB-режиме.
- Внизу рабочего экрана USB-режима показываются длительности последних пяти засчитанных циклов.
- После старта USB data-линии заняты GPIO-режимом до перезагрузки.
## Buttons Mode
- `KEY3 / GPIO18` — `INHALE`, active LOW.
- `BOOT / GPIO0` — `EXHALE`, active LOW.
- `BOOT` нельзя удерживать во время включения или reset платы.
- На рабочем экране нет touch-кнопок `INHALE` / `EXHALE`: дыхание переключается только внешними кнопками.
- Долгое удержание `KEY3 / INHALE` около 850 мс открывает settings и одновременно считается нажатием `INHALE`.
- Когда settings открыты, следующее нажатие `KEY3 / INHALE` закрывает settings и тоже считается нажатием `INHALE`.
- В правом верхнем углу показываются заряд батареи и значок молнии во время зарядки. Данные читает AXP2101.
- Дисплей гаснет после выбранного времени без касания экрана или внешней кнопки. Измерение, кнопки и предупреждения продолжают работать; касание или кнопка сразу включает подсветку обратно.
- Если после принятой фазы нет следующей корректной противоположной кнопки: первые 30 секунд скетч молчит, затем 30 секунд тихо сигналит каждые 5 секунд, следующие 30 секунд громко сигналит каждые 5 секунд, затем ещё 5 минут громко сигналит раз в 15 секунд. После этого AXP2101 выключает прибор.
## Pot Test Mode
Режим для проверки переменного резистора `RP 6045-B50K` на 50 kΩ по 3-проводной схеме:
- `USB D- / GPIO19` — источник `3.3V`, подключается к одному крайнему выводу резистора.
- `USB D+ / GPIO20` — ADC-вход, подключается к средней ножке/ползунку.
- `USB GND` — земля, подключается ко второму крайнему выводу резистора.
На экране показываются:
- положение ползунка `0..100%`;
- горизонтальная шкала;
- напряжение на `D+`;
- raw ADC;
- примерное сопротивление участка `0..50 kΩ`.
Программная защита best-effort:
- если ADC насыщается или показывает опасно высокое напряжение, скетч переводит `D-` и `D+` в `INPUT`, пищит и показывает `USB/PIN FAULT`;
- это не делает 5V на GPIO безопасными: ESP32-S3 GPIO не являются 5V tolerant;
- после fault нужно отключить неправильное подключение и перезагрузить плату.
## Pot 2-Wire Test Mode
Грубый режим для проверки переменного резистора по двум контактам:
- `USB D- / GPIO19` — источник `3.3V`;
- `USB D+ / GPIO20` — ADC-вход с внутренней подтяжкой вниз;
- подключить два вывода потенциометра между `D-` и `D+`: средний ползунок и один крайний вывод.
Ограничения:
- измерение грубое, потому что внутренняя подтяжка ESP32 имеет большой разброс;
- положение и сопротивление могут быть нелинейными и отличаться между платами;
- для проверки движения ползунка и примерного края диапазона режим подходит;
- для будущей точной логики дыхания лучше использовать `START POT 3-WIRE`.
## Pot Cal Test Mode
Калиброванный грубый режим для случаев, когда USB-линии дают маленький или смещённый диапазон, но движение всё равно видно:
- `USB D- / GPIO19` — источник `3.3V`;
- `USB D+ / GPIO20` — ADC-вход с внутренней подтяжкой вниз;
- подключить два вывода потенциометра между `D-` и `D+`: средний ползунок и один крайний вывод.
На экране показываются:
- процент `0..100%` внутри автоматически найденного диапазона;
- текущие `mV` и raw ADC;
- найденный диапазон `min-max`;
- состояние `CALIBRATING`, `SMALL RANGE`, `LOW EDGE`, `MID` или `HIGH EDGE`.
Как пользоваться:
- открыть `START POT CAL`;
- медленно провести ползунок от одного края до другого, чтобы скетч запомнил минимум и максимум;
- если нужно начать калибровку заново, нажать `KEY3 / GPIO18`.
Этот режим не измеряет настоящее сопротивление. Он нужен, чтобы понять, можно ли получить хотя бы относительное положение ползунка на проблемной USB-паре.
## USB Pin Diag Mode
Режим для проверки, не удерживает ли USB PHY/кабель линии `D- / D+` около нуля.
Тесты:
- `Test A`: `D- / GPIO19` переводится в `OUTPUT HIGH`, `D+ / GPIO20` читается как ADC.
- `Test B`: `D+ / GPIO20` переводится в `OUTPUT HIGH`, `D- / GPIO19` читается как ADC.
Как пользоваться:
- открыть `START PIN DIAG`;
- замкнуть `D-` и `D+` напрямую;
- смотреть, появляется ли около `3.3V` / высокий ADC хотя бы в одном направлении.
Если оба теста остаются около нуля, значит USB-линии, вероятно, удерживаются USB-подключением, USB PHY или платной обвязкой, и использовать этот разъём как аналоговый датчик при таком подключении нельзя.
## Логика дыхания
- Цикл считается от одного `EXHALE` до следующего `EXHALE`.
- `INHALE` до первого `EXHALE` не создаёт цикл.
- В ручном режиме учитывается каждый полный цикл, включая длительности меньше 3 секунд.
- Ручной монитор принимает фазы только в порядке `INHALE -> EXHALE -> INHALE`. Повторное нажатие текущей кнопки и `EXHALE` до первого `INHALE` полностью игнорируются: не меняют фазу, не сбрасывают таймер и не подают звук.
- Каждое принятое нажатие даёт один тихий подтверждающий сигнал. В ручном режиме поле `Phase time` показывает длительность именно текущего вдоха или выдоха.
- В USB Sensor Mode циклы короче 3 секунд игнорируются без сброса текущего таймера цикла.
- Среднее считается с округлением по миллисекундам по последним 5 завершённым циклам и выводится до десятых секунды.
- После принятого `EXHALE` добавляется полный цикл, пересчитывается среднее и при среднем ниже лимита срабатывает предупреждение.
- Внизу экрана всегда показаны те же последние 5 измерений, из которых считается среднее.
- Нижние два числовых поля (`From start` и `Limit`) выводятся увеличенным размером.
## Settings
Settings сохраняются в NVS:
- limit: `5 / 7 / 10 / 15 / 20` секунд;
- quiet cycle tick volume: `0..10`;
- alert volume: `0..10`.
- screen timeout: `10s / 30s / 60s / Always`.
Настройки прокручиваются вертикальным свайпом, чтобы поместить все четыре пункта.
## Тревоги
- Если среднее последних циклов меньше выбранного лимита, звучат предупреждения как в USB breath monitor: серия растёт до 5 сигналов.
- В USB-режиме длинный цикл с 60 секунд использует 5 громких сигналов с повтором каждые 5 секунд.
- В ручном мониторе используется отдельная экономная лестница напоминаний, описанная выше, с выключением питания через 6 минут 30 секунд без корректной следующей фазы.
## Прошивка
Из этой папки:
```bash
./burn.sh
```
Только проверить сборку, не прошивая плату:
```bash
NO_UPLOAD=1 ./burn.sh
```
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,130 @@
# AGENTS — BreathMonitor v3
## Назначение
Эта папка содержит третью версию автономного ESP32-монитора дыхания и отдельный Java/SQLite-сервер.
- `firmware/` — прошивка для Waveshare ESP32-S3-Touch-AMOLED-2.16.
- `server/` — исходники Java-сервера, Gradle-сборка и веб-интерфейс.
- `deploy/` — шаблон systemd-службы и отдельный фрагмент Caddy.
## Обязательные правила
- Все изменения этого проекта относятся к репозиторию `SKETCH`, не смешивать их с коммитами `SHiNE-product`.
- Основной язык документации и пояснений — русский.
- Не удалять FFat при обновлении прошивки. Не использовать `Erase All Flash`, если нужно сохранить локальные журналы.
- Если при старте появляется `STORAGE ERROR`, нажимать `FORMAT FFat` только после проверки/резервирования локальных журналов; без подтверждения прошивка форматирование не выполняет.
- Перед прошивкой убедиться, что выбрана схема `app3M_fat9M_16MB`.
- Не менять формат записей журналов и API без отдельного согласования: сервер проверяет 32-байтные записи, CRC32 и префиксную целостность загрузок.
- Не хранить пароли, токены, SQLite-базу и реальные серверные секреты в git.
## Прошивка
Плата и библиотеки такие же, как у `breathmonitor_v2 lvgl`. `firmware/burn.sh` использует библиотеки из:
`SHiNE-product/ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/official-demo/examples/Arduino-v3.3.5/libraries`
Сборка без загрузки:
```bash
cd "SKETCH/breath_button_monitor/breathmonitor_v3 with server/firmware"
NO_UPLOAD=1 ./burn.sh
```
Загрузка на подключённую плату:
```bash
PORT=/dev/ttyACM0 ./burn.sh
```
Скрипт использует ESP32 core 3.3.5, FQBN с 16 MB Flash, PSRAM OPI и разделом `app3M_fat9M_16MB`. Перед загрузкой проверить порт командой `arduino-cli board list`.
## Серверная сборка
Сервер всегда собирается локально. VPS не должен запускать Maven, Gradle или компилятор.
```bash
cd "SKETCH/breath_button_monitor/breathmonitor_v3 with server/server"
./gradlew --no-daemon clean shadowJar
```
Требуется JDK 17. Результат:
`server/build/libs/breathmonitor-1.0.0.jar`
Проверить локально запуск и health можно так:
```bash
BREATH_DATA_DIR="$PWD/.local-data" \
BREATH_WEB_DIR="$PWD/web" \
PUBLIC_ORIGIN="https://breathmonitor.shineup.me" \
java -jar build/libs/breathmonitor-1.0.0.jar
```
Для VPS передаётся только готовый JAR и при необходимости статические файлы `web/`. Не выполнять на VPS `build.sh`, `gradlew`, `mvn` или компиляцию.
## Деплой сервера
Целевой адрес: `breathmonitor.shineup.me`, VPS: `178.208.90.249`. SSH-пользователь текущего тестового контура — `player`.
Постоянные пути на VPS:
- приложение: `/opt/breathmonitor/server`
- JAR: `/opt/breathmonitor/server/build/libs/breathmonitor-1.0.0.jar`
- данные SQLite и журналы: `/var/lib/breathmonitor`
- systemd unit: `/etc/systemd/system/breathmonitor.service`
- Caddy: `/etc/caddy/Caddyfile`
- внутренний HTTP-порт: `127.0.0.1:8090`
Безопасный порядок обновления:
1. Локально собрать и проверить JAR.
2. Передать только JAR во временный файл на VPS через `rsync`.
3. Сделать копию текущего JAR и проверить права.
4. Атомарно заменить JAR, не удаляя `/var/lib/breathmonitor`.
5. Перезапустить только `breathmonitor.service`.
6. Проверить `systemctl status breathmonitor` и `curl https://breathmonitor.shineup.me/api/health`.
7. Caddy не перезапускать при обычном обновлении JAR. Перезагрузка Caddy нужна только при изменении его конфигурации.
Пример передачи готового артефакта:
```bash
rsync -az server/build/libs/breathmonitor-1.0.0.jar \
player@178.208.90.249:/tmp/breathmonitor-1.0.0.jar
```
Дальнейшая замена требует SSH/sudo-доступа и выполняется отдельно от сборки. При недоступном VPS не повторять сборку удалённо и не трогать существующие сервисы.
## Первый запуск и аккаунт
Сервис запускается от системного пользователя `breathmonitor` и использует `BREATH_DATA_DIR=/var/lib/breathmonitor`.
Создание аккаунта выполняется один раз на VPS с тем же каталогом данных:
```bash
sudo -u breathmonitor env BREATH_DATA_DIR=/var/lib/breathmonitor \
/opt/breathmonitor/server/start.sh create-user aidar
```
Текущая версия допускает пароль длиной от 1 до 63 символов. Короткие пароли допустимы только для закрытого тестового контура; для публичного использования нужен длинный пароль.
## Проверки после обновления
```bash
curl -fsS https://breathmonitor.shineup.me/api/health
sudo systemctl is-active breathmonitor
sudo journalctl -u breathmonitor -n 70 --no-pager
```
После прошивки на приборе проверить Wi-Fi, синхронизацию времени, `ONLINE → ACCOUNT`, `PAIR`, затем `UPLOAD`. Журналы на устройстве не удалять при диагностике; использовать USB-команды `LOG INFO`, `LOG LIST` и `LOG DOWNLOAD <дата>`.
## Резервирование
Резервировать нужно SQLite-базу с учётом WAL и каталог журналов:
- `/var/lib/breathmonitor/statistics.db`
- `/var/lib/breathmonitor/statistics.db-wal`
- `/var/lib/breathmonitor/statistics.db-shm`
- `/var/lib/breathmonitor/logs/`
Не заменять каталог данных при обновлении приложения и не выполнять `rsync --delete` по `/var/lib/breathmonitor`.
@@ -0,0 +1,186 @@
# BreathMonitor — автономный прибор + Java/SQLite сервер
**Комплект для развёртывания** · 24 октября 2026 года
Адрес API и сайта уже задан: **https://breathmonitor.shineup.me**
Это исходники готовой первой интеграционной версии, а не подтверждённая сборка для конкретной платы: Java-код и парсер рассчитаны на JDK 17, но `.ino` требуется собрать в Arduino IDE с исходными библиотеками и проверить на физическом ESP32-S3. Интернет в среде сборки отсутствовал, поэтому готовый исполняемый JAR с SQLite JDBC не вложен: `server/build.sh` соберёт его Gradle, скачав зависимости из Maven Central.
## Содержимое
```text
firmware/breathmonitor_lvgl.ino — изменённый скетч (исходный UI, измерения, RTC)
firmware/ISRG_Root_X1_reference.pem — копия публичного корневого сертификата (он уже встроен в .ino)
server/BreathServer.java — один Java-класс: API, SQLite, HTTPS через Caddy, веб-сайт
server/RecordFixtureTest.java — тест бинарного формата/CRC32 без JDBC
server/build.gradle — зависимости SQLite JDBC, SLF4J и сборка jar
server/build.sh — Gradle package
server/start.sh — запуск и админ-команды
server/web/ — независимая HTML/CSS/JavaScript статистика
deploy/Caddyfile.fragment — пример секции для Caddy
deploy/breathmonitor.service — пример службы systemd
```
## 1. Изменения прибора
- **Без постоянного Wi-Fi.** После загрузки радиомодуль выключен. Операция `TIME → SYNC NOW` подключает известную сеть, синхронизирует NTP+RTC, выключает Wi-Fi. `ONLINE → UPLOAD` делает то же самое для передачи журналов. `Wi-Fi → TEST` проверяет доступность сети и отключает модуль.
- До восьми сохранённых SSID и паролей перенесены из старой прошивки без изменения ключей `manual-wifi`.
- Если известные Wi-Fi недоступны, открывается список сетей; после выбора/ввода пароля ранее запрошенная операция продолжается автоматически.
- **Журнал по дням:** `/logs/20261024.bin` и т. п., записи по 32 байта, версия 1 + CRC32. Запись только в конец, существующие дневные файлы продолжаются после перезагрузки. `/logs/undated.bin` — события при недостоверном времени.
- `/events.bin` из исходной прошивки **не удаляется**. При первом запуске записи переносятся в дневные файлы, успешный перенос фиксируется `/migration.done`. При аварийном выключении перенос пробуется снова; старый исходный файл остаётся. Неверные CRC в старом файле пропускаются, но остаются в оригинале для диагностики.
- Автоформатирование FFat отключено (`FFat.begin(false)`). Если FFat не монтируется, прибор показывает на экране подтверждение `FORMAT FFat`; форматирование выполняется только после явного нажатия и удаляет локальные журналы.
- `ONLINE → ACCOUNT`: ввести логин и пароль учётной записи сайта, затем `PAIR` или сразу `UPLOAD`. Введённый пароль живёт в RAM до авторизации; хранится отдельный токен устройства в Preferences. После перезагрузки пароль не нужен.
- `ONLINE → REUPLOAD` очищает **только индекс отправленных размеров** `/sync.state`, не сами журналы. При следующем `UPLOAD` прибор повторно отправит все дневные файлы (сервер не дублирует циклы).
- Передача HTTPS в отдельной FreeRTOS-задаче; измерения и обновление LVGL продолжаются в основном цикле. Отправляется зафиксированный на момент начала передачи размер файла: новые записи попадут в следующую синхронизацию.
- Публичный ключ SSL не выключен: прошивка доверяет **ISRG Root X1**. Caddy должен получить совместимый сертификат Let's Encrypt. При смене удостоверяющего центра нужно обновить доверенный сертификат в прошивке.
**USB CDC:** доступны `LOG INFO`, `LOG LIST`, `LOG DOWNLOAD 20261024`, `LOG DOWNLOAD undated`, `LOG DOWNLOAD LEGACY`. `LOG DOWNLOAD` без указания даты больше не поддерживается. Бинарные данные передаются HEX-строками между `LOG BEGIN ...` и `LOG END`.
**Важно при прошивке:** используйте тот же раздел/Partition Scheme, который содержал исходный FFat, и не выбирайте `Erase All Flash`. Перепрошивка с изменением разметки может стереть старые журналы. До прошивки сделайте резервную копию `/events.bin` через исходную команду `LOG DOWNLOAD`.
## 2. Установка Java + SQLite (Ubuntu)
На сервере с Caddy и доступом в интернет:
```bash
sudo apt update
sudo apt install -y openjdk-17-jdk gradle
# Скопируйте папку server в /opt/breathmonitor/server
cd /opt/breathmonitor/server
chmod +x build.sh start.sh
./build.sh
```
Сборка создаёт `target/breathmonitor-1.0.0.jar`. Это самодостаточный shaded JAR, включающий SQLite JDBC и SLF4J. Другой процесс базы данных не нужен.
Для первого запуска от текущего пользователя:
```bash
cd /opt/breathmonitor/server
./start.sh create-user aidar
# Введите пароль длиной 1–63 символа
./start.sh create-user anna
./start.sh
```
Админ-команда сброса пароля:
```bash
./start.sh reset-password aidar
```
**Сброс пароля отзывает все веб-сессии и токены привязанных устройств**; пароль и привязку придётся ввести заново.
По умолчанию:
- Java-сервер слушает **только** `127.0.0.1:8090`, так что он не доступен напрямую из интернета.
- База данных находится в `server/data/statistics.db`, журналы в `server/data/logs/<login>/<device-id>/<login>_YYYYMMDD.bin`.
- Файлы фронтенда читаются из `server/web`.
- Значения настраиваются переменными `BREATH_PORT`, `BREATH_BIND`, `BREATH_DATA_DIR`, `BREATH_WEB_DIR`, `PUBLIC_ORIGIN`.
### Служба systemd
Для постоянного запуска рекомендуется отдельный системный пользователь и каталог данных:
```bash
sudo useradd --system --user-group --no-create-home --shell /usr/sbin/nologin breathmonitor || true
sudo mkdir -p /var/lib/breathmonitor
sudo chown -R breathmonitor:breathmonitor /var/lib/breathmonitor
sudo chown -R root:root /opt/breathmonitor/server
sudo cp /opt/breathmonitor/deploy/breathmonitor.service /etc/systemd/system/
sudo systemctl daemon-reload
# Сначала создайте пользователей, используя то же BREATH_DATA_DIR и от имени breathmonitor:
sudo -u breathmonitor env BREATH_DATA_DIR=/var/lib/breathmonitor bash -c 'cd /opt/breathmonitor/server && ./start.sh create-user aidar'
sudo systemctl enable --now breathmonitor
sudo journalctl -u breathmonitor -n 70 --no-pager
```
Не создавайте сначала пользователей в `server/data/`, а потом не переключайтесь на `/var/lib/breathmonitor`: это **разные** базы данных. При необходимости перенесите каталог данных до запуска службы.
## 3. Caddy / HTTPS / DNS
Настройте DNS-запись `A` (и при необходимости `AAAA`) для `breathmonitor.shineup.me` на адрес вашего сервера. В вашем существующем Caddyfile добавьте блок из `deploy/Caddyfile.fragment`, не перезаписывая остальные сайты. Прибор всегда использует `https://breathmonitor.shineup.me` — адрес уже в `.ino`.
```bash
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -i https://breathmonitor.shineup.me/api/health
```
Ответ должен быть HTTP 200 и `{"ok":true}`. Затем откройте сайт в браузере, войдите под созданным логином и паролем.
Текущая версия Caddy сама использует стандартный Let's Encrypt. Это важно, поскольку `ROOT_CA` прошивки содержит только ISRG Root X1; другой TLS-издатель может не пройти проверку. Если у вас уже есть отдельный wildcard-сертификат, сначала проверьте его цепочку доверия и при необходимости обновите `ROOT_CA`.
## 4. Первое подключение прибора
1. Установить обновлённую прошивку без стирания FFat/Preferences.
2. `SETTINGS → Wi-Fi → SCAN`: выбрать свою сеть, ввести пароль, дождаться успешной проверки. Сеть сохранится.
3. `SETTINGS → TIME → SYNC NOW`: получить точное время и выключить Wi-Fi. После NTP аппаратные часы продолжают работать автономно.
4. `SETTINGS → ONLINE → ACCOUNT → LOGIN`: ввести **тот же** логин, что создали командой `create-user`.
5. `PASSWORD`: ввести пароль аккаунта; `PAIR` — одноразово получить токен (или просто `ONLINE → UPLOAD`, и привязка выполнится при первой выгрузке).
6. Сделать несколько циклов дыхания и нажать `ONLINE → UPLOAD`. Увидеть сообщение `Done: ... uploaded`. Через браузер обновить страницу статистики.
7. Последующие загрузки выполняются одним нажатием `UPLOAD`; пароль повторно не вводится.
На приборах с заводским/сброшенным RTC перед защищённой отправкой автоматически выполняется NTP. Если отсутствует интернет/NTP, файлы продолжают сохраняться локально; при неудачной синхронизации не удаляются.
## 5. Формат API (для отладки)
| Метод и путь | Назначение | Авторизация |
|---|---|---|
| `GET /api/health` | проверка сервера | нет |
| `POST /api/device/login` | `login\npassword\nDEVICEID` → 64 шестнадцатеричных символа токена | пароль пользователя |
| `PUT /api/device/upload?date=20261024` | сырое тело `.bin`, заголовки `Authorization: Bearer TOKEN` и `X-Device-ID: <12 hex>` | токен устройства |
| `POST /api/login` | логин в браузере | пароль пользователя; cookie с Secure/HttpOnly |
| `GET /api/me` | профиль | cookie |
| `GET /api/stats` | личная статистика | cookie |
| `GET /api/leaderboard` | открытый рейтинг только согласившихся | нет |
| `POST /api/privacy` | тело `true` или `false`, включение публичного рейтинга | cookie + проверка Origin |
| `POST /api/logout` | выход | cookie + проверка Origin |
Сервер проверяет каждую 32-байтную запись и CRC32. Если файл уже существует, новая версия обязана **полностью содержать старый файл как начальный префикс**. Повторная отправка идентичной версии не добавляет циклы; изменение/уменьшение журнала отклоняется с HTTP 409. После проверки файл атомарно заменяется, а суточная статистика пересчитывается и записывается в SQLite через UPSERT. Для разных устройств одного пользователя файлы лежат в отдельных папках.
## 6. Конфиденциальность, администрирование, резервные копии
- По умолчанию **все аккаунты приватные**; другие люди не видят их результаты. Пользователь может включить публичный рейтинг в личном кабинете. В рейтинг попадают только агрегированные показатели, не подробные записи.
- Password storage: PBKDF2-HMAC-SHA256 с солью и 210 тыс. итераций. Веб-сессии и токены устройств в БД хранятся как SHA-256-хеши. Базовые ограничения на перебор логина — до 12 попыток с IP за минуту (для публичного большого проекта позже нужен усиленный anti-abuse перед Caddy).
- Важно делать резервные копии **и `statistics.db` (с учётом SQLite WAL), и `data/logs/`**. При работающем сервере лучше снимать транзакционный SQLite backup, а не просто копировать открытый файл базы без `-wal`.
- Долговременное сохранение FFat зависит от носителя и состояния питания. Базовую защиту обеспечивают append-only журналы, контроль CRC и серверные копии; для критичных данных нужен дополнительный журнал транзакций/резервирование.
- Сайт не утверждает, что измеряет здоровье или качество медитации. Он показывает только события, зафиксированные прибором.
## 7. Известные ограничения первой версии
1. `.ino` пока не прошёл аппаратную компиляцию, прошивку и испытания на вашей конкретной плате. Исходный LVGL UI, сенсор, IMU и аудио сохранены, но реальный тест кнопок, Wi-Fi и FFat обязателен.
2. Серверный Java-класс синтаксически компилируется; двоичный тест CRC и декодирования цикла пройден. Полный тест запуска SQLite/JDBC требует загрузки зависимостей Gradle из Maven Central.
3. Для простоты передаётся **целиком изменившийся суточный файл** (а не только его добавленный хвост); при типичном размере десятки КБ это нормально. Загрузка ограничена 16 МиБ на файл.
4. Если текущий дневной файл физически повреждён или содержит неполную запись, отправка этого файла отклоняется; прибор не удаляет файл автоматически. Нужна ручная диагностика через `LOG LIST`/USB.
5. При недостоверных часах события попадают в `undated.bin`. Автоматически приписывать им выдуманную дату нельзя: их можно учесть в общей сумме, но не привязать надёжно к календарному дню без дополнительной информации.
6. Суточная дата задаётся **фиксированным** UTC-смещением в настройках прибора (автоматический переход на летнее/зимнее время пока не предусмотрен).
7. Изменение времени/смещения суток не переименовывает уже записанные файлы. В случае некорректного времени возможен дневной файл с неправильной датой; хранящиеся в каждой записи UTC и флаг доверия дают возможность дальнейшей коррекции.
8. Устройства на одном аккаунте считаются вместе. Разные физические устройства должны иметь разные ID ESP32. В **первой версии прибор рассчитан на одного владельца**: после успешной привязки вход в другой аккаунт с того же прибора заблокирован, чтобы не загрузить личную историю прежнего владельца в чужой аккаунт. Для передачи устройства другому человеку нужно сначала экспортировать/архивировать журналы и безопасно сбросить локальное хранилище и Preferences (реализация безопасного сброса — отдельная задача).
9. Регистрация пользователей выполняется администратором через CLI; самостоятельная регистрация на сайте не реализована.
10. В `ONLINE → REUPLOAD` удаляется только локальный индекс выгрузок. Если сервер получил отличающуюся старую историю, он вернёт HTTP 409: безопаснее исследовать конфликт, чем автоматически переписать старые данные.
## 8. Проверки до ежедневного использования
- Питание OFF/ON посреди дня → количество 32-байтных записей в текущем файле увеличивается, записи не исчезают.
- Переход через полночь по настроенному времени → создаётся новый датированный файл.
- Сохранённая Wi-Fi сеть недоступна → устройство предлагает список сетей и затем продолжает именно TIME/UPLOAD.
- Отключение интернет-кабеля во время отправки → файл на приборе остаётся, повторная синхронизация работает.
- Повторный `UPLOAD` без новых циклов → нет дублей статистики.
- Появление новых циклов во время отправки → в следующей синхронизации сервер получает расширенный файл.
- Сброс часов RTC → новые события идут в `undated.bin` до синхронизации.
- Новый пользователь/новый токен → доступ только к своим файлам, публичный рейтинг по умолчанию пустой.
- Перед прошивкой заранее выгрузить старый `/events.bin` по USB и сравнить запись после миграции.
### Локальный тест Java без JDBC
```bash
cd server
javac --release 21 BreathServer.java RecordFixtureTest.java
java RecordFixtureTest
```
Ожидаемый ответ: `PASS: 32-byte little-endian event, duration and CRC32 validation`.
---
**После первого запуска** я рекомендую следующий этап: сделать диагностический экран «свободно FFat / не выгружено / ошибка последней передачи» и веб-функцию загрузки журнала вручную с компьютера. Это облегчит восстановление и сопровождение приборов, когда пользователей станет больше.
@@ -0,0 +1,4 @@
breathmonitor.shineup.me {
encode zstd gzip
reverse_proxy 127.0.0.1:8090
}
@@ -0,0 +1,22 @@
[Unit]
Description=BreathMonitor lightweight Java server
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=breathmonitor
Group=breathmonitor
WorkingDirectory=/opt/breathmonitor/server
ExecStart=/opt/breathmonitor/server/start.sh
Environment=BREATH_DATA_DIR=/var/lib/breathmonitor
Environment=BREATH_WEB_DIR=/opt/breathmonitor/server/web
Environment=PUBLIC_ORIGIN=https://breathmonitor.shineup.me
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/var/lib/breathmonitor
PrivateTmp=true
[Install]
WantedBy=multi-user.target
@@ -0,0 +1,31 @@
-----BEGIN CERTIFICATE-----
MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
-----END CERTIFICATE-----
@@ -2,12 +2,12 @@
set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
WORKSPACE_DIR="$(cd "$ROOT_DIR/../../../" && pwd)"
WORKSPACE_DIR="$(cd "$ROOT_DIR/../../../../" && pwd)"
DEMO_BASE="$WORKSPACE_DIR/SHiNE-product/ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/official-demo/examples/Arduino-v3.3.5"
PORT="${PORT:-}"
FQBN="${FQBN:-esp32:esp32:esp32s3:USBMode=hwcdc,CDCOnBoot=cdc,UploadSpeed=921600,CPUFreq=240,FlashMode=dio,FlashSize=16M,PartitionScheme=app3M_fat9M_16MB,PSRAM=opi}"
BUILD_DIR="$ROOT_DIR/../../.arduino-build/breath-dual-mode-monitor"
OUT_DIR="$ROOT_DIR/../../.arduino-build/out-breath-dual-mode-monitor"
BUILD_DIR="$ROOT_DIR/../../.arduino-build/breathmonitor-v3"
OUT_DIR="$ROOT_DIR/../../.arduino-build/out-breathmonitor-v3"
if [[ ! -d "$DEMO_BASE/libraries" ]]; then
echo "Missing Waveshare libraries: $DEMO_BASE/libraries" >&2
@@ -23,7 +23,7 @@ compile_args=(
--library "$DEMO_BASE/libraries/XPowersLib"
--library "$DEMO_BASE/libraries/lvgl"
--library "$DEMO_BASE/libraries/Mylibrary"
"$ROOT_DIR"
"$ROOT_DIR/firmware.ino"
)
if ! arduino-cli compile "${compile_args[@]}"; then
@@ -40,4 +40,4 @@ if [[ -z "$PORT" ]]; then
echo "Set PORT=/dev/ttyACM0 or use NO_UPLOAD=1." >&2
exit 1
fi
arduino-cli upload --fqbn "$FQBN" -p "$PORT" --input-dir "$OUT_DIR" "$ROOT_DIR"
arduino-cli upload --fqbn "$FQBN" -p "$PORT" --input-dir "$OUT_DIR" "$ROOT_DIR/firmware.ino"
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,11 @@
# AGENTS — BreathMonitor server
- Сборка выполняется только локально через `./gradlew --no-daemon shadowJar` на JDK 17.
- VPS получает только `build/libs/breathmonitor-1.0.0.jar`; Maven/Gradle на VPS не запускать.
- Runtime-каталог данных задаётся `BREATH_DATA_DIR=/var/lib/breathmonitor` и не должен попадать в пакет приложения.
- Не менять `/var/lib/breathmonitor` при обновлении JAR.
- Не добавлять в git SQLite-файлы, логи, токены, пароли и временные `.gradle`/`build`-артефакты.
- При изменении REST API обновлять описание API в `README_RU.md` и проверять совместимость прошивки.
- При изменении схемы журналов обновлять документацию и тест `RecordFixtureTest.java`.
- Сервис слушает только `127.0.0.1:8090`; внешний HTTPS обслуживает Caddy.
- Production/test VPS не использовать для компиляции: отсутствие Maven/Gradle на VPS является нормальным и ожидаемым состоянием.
@@ -0,0 +1,464 @@
import com.sun.net.httpserver.Headers;
import com.sun.net.httpserver.HttpExchange;
import com.sun.net.httpserver.HttpServer;
import javax.crypto.SecretKeyFactory;
import javax.crypto.spec.PBEKeySpec;
import java.io.*;
import java.net.*;
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import java.nio.charset.StandardCharsets;
import java.nio.file.*;
import java.security.*;
import java.sql.*;
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.*;
import java.util.concurrent.*;
import java.util.zip.CRC32;
/** Lightweight standalone server: HTTP API, SQLite, immutable record parser and a static dashboard.
* Deploy behind a HTTPS reverse-proxy (Caddy); never expose the raw HTTP port publicly.
* JDK 21 + org.xerial:sqlite-jdbc (shaded by Gradle). No Spring, Node, or external database.
*/
public final class BreathServer {
private static final int RECORD = 32, MAX_UPLOAD = 16 * 1024 * 1024, ITERATIONS = 210_000;
private static final long SESSION_TTL = 14L * 24 * 3600 * 1000;
private static final SecureRandom RNG = new SecureRandom();
private static final String DB_URL = "jdbc:sqlite:" + Path.of(System.getenv().getOrDefault("BREATH_DATA_DIR", "data"), "statistics.db").toAbsolutePath();
private static final Path DATA = Path.of(System.getenv().getOrDefault("BREATH_DATA_DIR", "data")).toAbsolutePath();
private static final Path WEB = Path.of(System.getenv().getOrDefault("BREATH_WEB_DIR", "web")).toAbsolutePath();
private static final String ORIGIN = System.getenv().getOrDefault("PUBLIC_ORIGIN", "https://breathmonitor.shineup.me");
private static final String BIND = System.getenv().getOrDefault("BREATH_BIND", "127.0.0.1");
private static final int PORT = Integer.parseInt(System.getenv().getOrDefault("BREATH_PORT", "8090"));
private static final DateTimeFormatter DAY = DateTimeFormatter.BASIC_ISO_DATE;
private static final Map<String, LoginThrottle> THROTTLES = new ConcurrentHashMap<>();
private static final Object UPLOAD_LOCK = new Object();
record User(long id, String login, boolean published) {}
record FileSummary(long cycles, long durationMs, long inhaleMs, long exhaleMs, long maxCycleMs) {}
static final class HttpError extends Exception {
final int status;
HttpError(int status, String message) { super(message); this.status = status; }
}
static final class LoginThrottle { long start = System.currentTimeMillis(); int attempts; }
public static void main(String[] args) throws Exception {
Files.createDirectories(DATA);
Class.forName("org.sqlite.JDBC");
initialize();
if (args.length > 0) {
if (args.length == 2 && args[0].equals("create-user")) { createUser(args[1]); return; }
if (args.length == 2 && args[0].equals("reset-password")) { resetPassword(args[1]); return; }
System.err.println("Usage: java -jar BreathServer.jar [create-user <login> | reset-password <login>]");
System.exit(2);
}
HttpServer server = HttpServer.create(new InetSocketAddress(InetAddress.getByName(BIND), PORT), 64);
server.createContext("/", BreathServer::dispatch);
server.setExecutor(Executors.newFixedThreadPool(12));
server.start();
System.out.printf("BreathMonitor listening on http://%s:%d (public origin %s)%n", BIND, PORT, ORIGIN);
}
private static Connection connection() throws SQLException {
Connection c = DriverManager.getConnection(DB_URL);
try (Statement s = c.createStatement()) {
s.execute("PRAGMA foreign_keys=ON");
s.execute("PRAGMA busy_timeout=5000");
}
return c;
}
private static void initialize() throws SQLException {
try (Connection c = connection(); Statement s = c.createStatement()) {
s.execute("PRAGMA journal_mode=WAL");
s.execute("""
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY, login TEXT NOT NULL UNIQUE,
salt TEXT NOT NULL, password_hash TEXT NOT NULL,
published INTEGER NOT NULL DEFAULT 0)
""");
s.execute("""
CREATE TABLE IF NOT EXISTS devices (
user_id INTEGER NOT NULL, device_id TEXT NOT NULL,
token_hash TEXT NOT NULL, created_at INTEGER NOT NULL,
PRIMARY KEY(user_id,device_id), FOREIGN KEY(user_id) REFERENCES users(id))
""");
s.execute("CREATE UNIQUE INDEX IF NOT EXISTS devices_tokens ON devices(token_hash)");
s.execute("""
CREATE TABLE IF NOT EXISTS sessions (
token_hash TEXT PRIMARY KEY, user_id INTEGER NOT NULL,
expires_at INTEGER NOT NULL, FOREIGN KEY(user_id) REFERENCES users(id))
""");
s.execute("""
CREATE TABLE IF NOT EXISTS uploads (
user_id INTEGER NOT NULL, device_id TEXT NOT NULL, day TEXT NOT NULL,
bytes INTEGER NOT NULL, sha256 TEXT NOT NULL, cycles INTEGER NOT NULL,
duration_ms INTEGER NOT NULL, inhale_ms INTEGER NOT NULL,
exhale_ms INTEGER NOT NULL, max_cycle_ms INTEGER NOT NULL,
updated_at INTEGER NOT NULL,
PRIMARY KEY(user_id,device_id,day), FOREIGN KEY(user_id) REFERENCES users(id))
""");
}
}
private static String readPassword(String prompt) throws IOException {
Console console = System.console();
if (console != null) {
char[] p = console.readPassword("%s", prompt);
if (p == null) throw new IOException("Password input cancelled");
String result = new String(p); Arrays.fill(p, '\0'); return result;
}
System.out.print(prompt);
BufferedReader reader = new BufferedReader(new InputStreamReader(System.in, StandardCharsets.UTF_8));
String result = reader.readLine();
if (result == null) throw new IOException("Password input cancelled");
return result;
}
private static void createUser(String login) throws Exception {
validLogin(login);
String pwd = readPassword("New password (1..63 characters): ");
if (pwd.isEmpty() || pwd.length() > 63) throw new IllegalArgumentException("Password must contain 1..63 characters");
String salt = tokenBytes(16), hash = passwordHash(pwd, salt);
try (Connection c = connection(); PreparedStatement p = c.prepareStatement("INSERT INTO users(login,salt,password_hash) VALUES(?,?,?)")) {
p.setString(1, login); p.setString(2, salt); p.setString(3, hash); p.executeUpdate();
}
System.out.println("Created user: " + login + ". Sign in on the dashboard, then pair the device.");
}
private static void resetPassword(String login) throws Exception {
validLogin(login); String pwd = readPassword("New password (1..63 characters): ");
if (pwd.isEmpty() || pwd.length() > 63) throw new IllegalArgumentException("Password must contain 1..63 characters");
String salt = tokenBytes(16), hash = passwordHash(pwd, salt);
try (Connection c = connection()) {
c.setAutoCommit(false);
try (PreparedStatement p = c.prepareStatement("UPDATE users SET salt=?,password_hash=? WHERE login=?")) {
p.setString(1, salt); p.setString(2, hash); p.setString(3, login);
if (p.executeUpdate() != 1) throw new IllegalArgumentException("Unknown user: " + login);
}
try (PreparedStatement p = c.prepareStatement("DELETE FROM sessions WHERE user_id=(SELECT id FROM users WHERE login=?)")) {
p.setString(1, login); p.executeUpdate();
}
try (PreparedStatement p = c.prepareStatement("DELETE FROM devices WHERE user_id=(SELECT id FROM users WHERE login=?)")) {
p.setString(1, login); p.executeUpdate();
}
c.commit();
}
System.out.println("Password updated, web sessions and device tokens revoked.");
}
private static byte[] fromHex(String hex) { return HexFormat.of().parseHex(hex); }
private static String tokenBytes(int n) { byte[] v = new byte[n]; RNG.nextBytes(v); return HexFormat.of().formatHex(v); }
private static String sha(byte[] b) {
try { return HexFormat.of().formatHex(MessageDigest.getInstance("SHA-256").digest(b)); }
catch (NoSuchAlgorithmException ex) { throw new AssertionError(ex); }
}
private static String sha(String v) { return sha(v.getBytes(StandardCharsets.UTF_8)); }
private static String passwordHash(String pwd, String salt) throws Exception {
PBEKeySpec spec = new PBEKeySpec(pwd.toCharArray(), fromHex(salt), ITERATIONS, 256);
try { return HexFormat.of().formatHex(SecretKeyFactory.getInstance("PBKDF2WithHmacSHA256").generateSecret(spec).getEncoded()); }
finally { spec.clearPassword(); }
}
private static void validLogin(String login) throws HttpError {
if (!login.matches("[a-z0-9_-]{3,24}")) throw new HttpError(400, "Login must be 3..24 lowercase characters, numbers, '_' or '-'");
}
private static void validDevice(String device) throws HttpError {
if (!device.matches("[0-9A-F]{12}")) throw new HttpError(400, "Invalid device ID");
}
private static void validDay(String day) throws HttpError {
if (day.equals("undated")) return;
if (!day.matches("20[2-9][0-9][0-1][0-9][0-3][0-9]")) throw new HttpError(400, "Invalid day");
try { LocalDate.parse(day, DAY); } catch (Exception ex) { throw new HttpError(400, "Invalid calendar date"); }
}
private static void dispatch(HttpExchange x) {
try {
Headers h = x.getResponseHeaders();
h.set("X-Content-Type-Options", "nosniff"); h.set("Referrer-Policy", "no-referrer");
h.set("X-Frame-Options", "DENY"); h.set("Cache-Control", "no-store");
h.set("Content-Security-Policy", "default-src 'self'; script-src 'self'; style-src 'self'; connect-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'");
String path = x.getRequestURI().getPath(), method = x.getRequestMethod();
switch (path) {
case "/api/health" -> { if (!method.equals("GET")) throw new HttpError(405,"Method not allowed"); json(x,200,"{\"ok\":true}"); }
case "/api/device/login" -> { requireMethod(method,"POST"); deviceLogin(x); }
case "/api/device/upload" -> { requireMethod(method,"PUT"); deviceUpload(x); }
case "/api/login" -> { requireMethod(method,"POST"); requireBrowserOrigin(x); browserLogin(x); }
case "/api/logout" -> { requireMethod(method,"POST"); requireBrowserOrigin(x); browserLogout(x); }
case "/api/me" -> { requireMethod(method,"GET"); me(x); }
case "/api/stats" -> { requireMethod(method,"GET"); stats(x); }
case "/api/leaderboard" -> { requireMethod(method,"GET"); leaderboard(x); }
case "/api/privacy" -> { requireMethod(method,"POST"); requireBrowserOrigin(x); privacy(x); }
default -> { if (!method.equals("GET")&& !method.equals("HEAD")) throw new HttpError(405,"Method not allowed"); serveWeb(x,path,method); }
}
} catch (HttpError err) { sendError(x,err.status,err.getMessage()); }
catch (Exception err) { System.err.println("API error: " + err); sendError(x,500,"Internal error"); }
finally { x.close(); }
}
private static void requireMethod(String actual,String expected) throws HttpError { if (!actual.equals(expected))throw new HttpError(405,"Expected " + expected); }
private static void requireBrowserOrigin(HttpExchange x) throws HttpError {
String origin = x.getRequestHeaders().getFirst("Origin");
if (!ORIGIN.equals(origin)) throw new HttpError(403,"Origin mismatch");
}
private static byte[] readLimited(HttpExchange x, int limit) throws IOException, HttpError {
long len = 0;
try { len = Long.parseLong(Optional.ofNullable(x.getRequestHeaders().getFirst("Content-Length")).orElse("-1")); }
catch (NumberFormatException err) { throw new HttpError(400,"Invalid content length"); }
if (len > limit) throw new HttpError(413,"Payload too large");
try (InputStream in = x.getRequestBody(); ByteArrayOutputStream out = new ByteArrayOutputStream()) {
byte[] buf = new byte[8192]; int n;
while ((n=in.read(buf))!=-1) { if (out.size()+n > limit) throw new HttpError(413,"Payload too large"); out.write(buf,0,n); }
return out.toByteArray();
}
}
private static String[] credentials(HttpExchange x, boolean device) throws Exception {
String body = new String(readLimited(x, 1024),StandardCharsets.UTF_8);
String[] parts = body.split("\\n",-1);
if (parts.length != (device?3:2)) throw new HttpError(400,"Invalid credential payload");
validLogin(parts[0]);
if (device) validDevice(parts[2]);
return parts;
}
private static String remoteAddress(HttpExchange x) {
// Caddy is trusted and the server binds to 127.0.0.1: use its Remote-IP as a throttle key.
String ip = x.getRequestHeaders().getFirst("X-Forwarded-For");
return ip!=null && ip.length()<100 ? ip.split(",")[0].trim() : x.getRemoteAddress().getAddress().getHostAddress();
}
private static void throttle(HttpExchange x) throws HttpError {
String ip=remoteAddress(x); long now=System.currentTimeMillis();
LoginThrottle l=THROTTLES.computeIfAbsent(ip,key->new LoginThrottle());
synchronized (l) {
if (now-l.start>60000){l.start=now;l.attempts=0;}
if (++l.attempts>12) throw new HttpError(429,"Too many login attempts, try again later");
}
if (THROTTLES.size()>10000) THROTTLES.clear();
}
private static User checkCredentials(String login,String pass) throws Exception {
try(Connection c=connection();PreparedStatement p=c.prepareStatement("SELECT id,salt,password_hash,published FROM users WHERE login=?")) {
p.setString(1,login);
try(ResultSet rs=p.executeQuery()){
if(!rs.next())return null;
String actual=passwordHash(pass,rs.getString("salt"));
if (!MessageDigest.isEqual(fromHex(actual),fromHex(rs.getString("password_hash"))))return null;
return new User(rs.getLong("id"),login,rs.getInt("published")==1);
}
}
}
private static void deviceLogin(HttpExchange x) throws Exception {
throttle(x);
String[] values=credentials(x,true);
User user=checkCredentials(values[0],values[1]);
if(user==null) throw new HttpError(401,"Invalid credentials");
String token=tokenBytes(32);
try(Connection c=connection(); PreparedStatement p=c.prepareStatement("""
INSERT INTO devices(user_id,device_id,token_hash,created_at) VALUES(?,?,?,?)
ON CONFLICT(user_id,device_id) DO UPDATE SET token_hash=excluded.token_hash,created_at=excluded.created_at
""")) {
p.setLong(1,user.id());p.setString(2,values[2]);p.setString(3,sha(token));p.setLong(4,System.currentTimeMillis());p.executeUpdate();
}
send(x,200,"text/plain; charset=utf-8",token.getBytes(StandardCharsets.UTF_8));
}
private static void browserLogin(HttpExchange x) throws Exception {
throttle(x);String[] values=credentials(x,false);
User user=checkCredentials(values[0],values[1]);
if(user==null)throw new HttpError(401,"Invalid credentials");
String token=tokenBytes(32);long expiry=System.currentTimeMillis()+SESSION_TTL;
try(Connection c=connection();PreparedStatement p=c.prepareStatement("INSERT INTO sessions(token_hash,user_id,expires_at) VALUES(?,?,?)")){
p.setString(1,sha(token));p.setLong(2,user.id());p.setLong(3,expiry);p.executeUpdate();
}
x.getResponseHeaders().add("Set-Cookie","bm_session="+token+"; HttpOnly; Secure; SameSite=Strict; Path=/; Max-Age="+(SESSION_TTL/1000));
json(x,200,"{\"ok\":true}");
}
private static User loggedIn(HttpExchange x) throws Exception {
String cookie=Optional.ofNullable(x.getRequestHeaders().getFirst("Cookie")).orElse("");
String token=null;
for(String piece:cookie.split(";")){
String s=piece.trim();if(s.startsWith("bm_session=")){token=s.substring("bm_session=".length());break;}
}
if(token==null || !token.matches("[0-9a-f]{64}"))throw new HttpError(401,"Please sign in");
try(Connection c=connection(); PreparedStatement p=c.prepareStatement("""
SELECT u.id,u.login,u.published FROM sessions s JOIN users u ON u.id=s.user_id
WHERE s.token_hash=? AND s.expires_at>?
""")){
p.setString(1,sha(token));p.setLong(2,System.currentTimeMillis());
try(ResultSet rs=p.executeQuery()){
if(!rs.next())throw new HttpError(401,"Session expired");
return new User(rs.getLong(1),rs.getString(2),rs.getInt(3)!=0);
}
}
}
private static void browserLogout(HttpExchange x) throws Exception {
try { loggedIn(x); } catch(HttpError e) { /* Expired sessions still get cookie cleared. */ }
String cookie=Optional.ofNullable(x.getRequestHeaders().getFirst("Cookie")).orElse("");
for(String p:cookie.split(";")) {
String v=p.trim(); if(v.startsWith("bm_session=")){
try(Connection c=connection();PreparedStatement s=c.prepareStatement("DELETE FROM sessions WHERE token_hash=?")){
s.setString(1,sha(v.substring("bm_session=".length())));s.executeUpdate();
}
}
}
x.getResponseHeaders().add("Set-Cookie","bm_session=; HttpOnly; Secure; SameSite=Strict; Path=/; Max-Age=0");
json(x,200,"{\"ok\":true}");
}
private static void me(HttpExchange x) throws Exception {
User u=loggedIn(x);
json(x,200,"{\"login\":"+quoted(u.login())+",\"published\":"+u.published()+"}");
}
private static void privacy(HttpExchange x) throws Exception {
User u=loggedIn(x);String body=new String(readLimited(x,16),StandardCharsets.US_ASCII).trim();
if (!body.equals("true")&&!body.equals("false"))throw new HttpError(400,"Expected true or false");
try(Connection c=connection();PreparedStatement p=c.prepareStatement("UPDATE users SET published=? WHERE id=?")){
p.setInt(1,body.equals("true")?1:0);p.setLong(2,u.id());p.executeUpdate();
}
json(x,200,"{\"ok\":true}");
}
private static String param(HttpExchange x,String name) {
String q=x.getRequestURI().getRawQuery();if(q==null)return null;
for(String pair:q.split("&")) {
String[] kv=pair.split("=",2);if(kv[0].equals(name))return kv.length==2?URLDecoder.decode(kv[1],StandardCharsets.UTF_8):"";
}
return null;
}
private static User authorizeDevice(HttpExchange x,String device) throws Exception {
String auth=x.getRequestHeaders().getFirst("Authorization");
if(auth==null||!auth.matches("Bearer [0-9a-f]{64}"))throw new HttpError(401,"Invalid bearer token");
try(Connection c=connection();PreparedStatement p=c.prepareStatement("""
SELECT u.id,u.login,u.published FROM devices d JOIN users u ON u.id=d.user_id
WHERE d.token_hash=? AND d.device_id=?
""")){
p.setString(1,sha(auth.substring(7)));p.setString(2,device);
try(ResultSet rs=p.executeQuery()){
if(!rs.next())throw new HttpError(401,"Unknown device or revoked token");
return new User(rs.getLong(1),rs.getString(2),rs.getInt(3)!=0);
}
}
}
private static FileSummary verifyAndSummarize(byte[] body) throws HttpError {
if(body.length==0||body.length%RECORD!=0)throw new HttpError(400,"File must contain complete 32-byte records");
long cycles=0,total=0,inhale=0,exhale=0,max=0;
CRC32 crc=new CRC32();
for(int pos=0;pos<body.length;pos+=RECORD){
int version=body[pos]&255, type=body[pos+1]&255;
if(version!=1||type<1||type>10)throw new HttpError(400,"Invalid record type/version at offset "+pos);
crc.reset();crc.update(body,pos,28);
long got=ByteBuffer.wrap(body,pos+28,4).order(ByteOrder.LITTLE_ENDIAN).getInt()&0xffffffffL;
if(crc.getValue()!=got)throw new HttpError(400,"CRC32 mismatch at offset "+pos);
if(type==1){
long i=((body[pos+16]&255)|((body[pos+17]&255)<<8))*100L;
long e=((body[pos+18]&255)|((body[pos+19]&255)<<8))*100L;
cycles++; inhale+=i;exhale+=e;total+=i+e;max=Math.max(max,i+e);
}
}
return new FileSummary(cycles,total,inhale,exhale,max);
}
private static void deviceUpload(HttpExchange x) throws Exception {
String day=param(x,"date");if(day==null)throw new HttpError(400,"Missing date");validDay(day);
String device=x.getRequestHeaders().getFirst("X-Device-ID");if(device==null)throw new HttpError(400,"Missing X-Device-ID");validDevice(device);
User user=authorizeDevice(x,device);
byte[] body=readLimited(x,MAX_UPLOAD);
FileSummary summary=verifyAndSummarize(body);
String hash=sha(body);
Path dest=DATA.resolve("logs").resolve(user.login()).resolve(device).resolve(user.login()+"_"+day+".bin");
synchronized(UPLOAD_LOCK){
Files.createDirectories(dest.getParent());
if(Files.exists(dest)){
byte[] prior=Files.readAllBytes(dest);
// Device journals are append-only: old bytes may never be replaced or truncated.
if(body.length<prior.length || !MessageDigest.isEqual(Arrays.copyOf(body,prior.length),prior))
throw new HttpError(409,"Upload does not extend stored journal; reconcile manually");
}
Path tmp=Files.createTempFile(dest.getParent(),"upload-",".part");
try {
Files.write(tmp,body,StandardOpenOption.WRITE,StandardOpenOption.TRUNCATE_EXISTING);
try{Files.move(tmp,dest,StandardCopyOption.ATOMIC_MOVE,StandardCopyOption.REPLACE_EXISTING);}
catch(AtomicMoveNotSupportedException err){Files.move(tmp,dest,StandardCopyOption.REPLACE_EXISTING);}
}finally{Files.deleteIfExists(tmp);}
// Repeated identical uploads are idempotent thanks to the per-device/date PRIMARY KEY.
try(Connection c=connection();PreparedStatement p=c.prepareStatement("""
INSERT INTO uploads(user_id,device_id,day,bytes,sha256,cycles,duration_ms,inhale_ms,exhale_ms,max_cycle_ms,updated_at)
VALUES(?,?,?,?,?,?,?,?,?,?,?)
ON CONFLICT(user_id,device_id,day) DO UPDATE SET
bytes=excluded.bytes, sha256=excluded.sha256,cycles=excluded.cycles,
duration_ms=excluded.duration_ms,inhale_ms=excluded.inhale_ms,
exhale_ms=excluded.exhale_ms,max_cycle_ms=excluded.max_cycle_ms,updated_at=excluded.updated_at
""")){
p.setLong(1,user.id());p.setString(2,device);p.setString(3,day);p.setInt(4,body.length);
p.setString(5,hash);p.setLong(6,summary.cycles());p.setLong(7,summary.durationMs());
p.setLong(8,summary.inhaleMs());p.setLong(9,summary.exhaleMs());
p.setLong(10,summary.maxCycleMs());p.setLong(11,System.currentTimeMillis());p.executeUpdate();
}
}
json(x,200,"{\"ok\":true,\"bytes\":"+body.length+",\"cycles\":"+summary.cycles()+"}");
}
private static void stats(HttpExchange x) throws Exception {
User user=loggedIn(x);
StringBuilder daily=new StringBuilder("[");
String sql="""
SELECT day,SUM(cycles),SUM(duration_ms),SUM(inhale_ms),SUM(exhale_ms),MAX(max_cycle_ms)
FROM uploads WHERE user_id=? AND day <> 'undated' GROUP BY day ORDER BY day DESC LIMIT 400
""";
long totalCycles=0,totalDuration=0,totalDays=0,lastSync=0,undated=0;
try(Connection c=connection()){
try(PreparedStatement p=c.prepareStatement(sql)){
p.setLong(1,user.id());try(ResultSet rs=p.executeQuery()){
while(rs.next()){
long cycles=rs.getLong(2),duration=rs.getLong(3);
if(daily.length()>1)daily.append(',');
daily.append("{\"day\":").append(quoted(rs.getString(1)))
.append(",\"cycles\":").append(cycles)
.append(",\"durationMs\":").append(duration)
.append(",\"inhaleMs\":").append(rs.getLong(4))
.append(",\"exhaleMs\":").append(rs.getLong(5))
.append(",\"maxCycleMs\":").append(rs.getLong(6)).append('}');
}
}
}
try(PreparedStatement p=c.prepareStatement("SELECT COALESCE(SUM(cycles),0),COALESCE(SUM(duration_ms),0),COUNT(DISTINCT CASE WHEN day<>'undated' THEN day END),COALESCE(MAX(updated_at),0) FROM uploads WHERE user_id=?")){
p.setLong(1,user.id());try(ResultSet rs=p.executeQuery()){rs.next();totalCycles=rs.getLong(1);totalDuration=rs.getLong(2);totalDays=rs.getLong(3);lastSync=rs.getLong(4);}
}
try(PreparedStatement p=c.prepareStatement("SELECT COALESCE(SUM(cycles),0) FROM uploads WHERE user_id=? AND day='undated'")){
p.setLong(1,user.id());try(ResultSet rs=p.executeQuery()){rs.next();undated=rs.getLong(1);}
}
}
daily.append(']');
json(x,200,"{\"login\":"+quoted(user.login())+",\"totalCycles\":"+totalCycles+
",\"totalDurationMs\":"+totalDuration+",\"activeDays\":"+totalDays+
",\"lastSyncMs\":"+lastSync+",\"undatedCycles\":"+undated+",\"daily\":"+daily+"}");
}
private static void leaderboard(HttpExchange x) throws Exception {
StringBuilder b=new StringBuilder("[ ");
try(Connection c=connection();PreparedStatement p=c.prepareStatement("""
SELECT u.login,COALESCE(SUM(f.cycles),0),COALESCE(SUM(f.duration_ms),0),
COUNT(DISTINCT CASE WHEN f.day<>'undated' THEN f.day END)
FROM users u LEFT JOIN uploads f ON f.user_id=u.id
WHERE u.published=1 GROUP BY u.id ORDER BY SUM(f.duration_ms) DESC LIMIT 100
""");ResultSet rs=p.executeQuery()){
boolean first=true;
while(rs.next()){
if(!first)b.append(',');first=false;
b.append("{\"login\":").append(quoted(rs.getString(1)))
.append(",\"cycles\":").append(rs.getLong(2))
.append(",\"durationMs\":").append(rs.getLong(3))
.append(",\"activeDays\":").append(rs.getLong(4)).append('}');
}
}
b.append(']');json(x,200,b.toString());
}
private static String quoted(String s){return "\""+s.replace("\\","\\\\").replace("\"","\\\"")+"\"";}
private static void serveWeb(HttpExchange x,String path,String method) throws Exception {
String name = switch(path){case "/","/index.html" -> "index.html";
case "/app.js" -> "app.js";case "/style.css" -> "style.css";
default -> null;};
if(name==null)throw new HttpError(404,"Not found");
Path target=WEB.resolve(name);if(!Files.isRegularFile(target))throw new HttpError(404,"Frontend files not installed");
String ct=name.endsWith(".js")?"application/javascript; charset=utf-8":name.endsWith(".css")?"text/css; charset=utf-8":"text/html; charset=utf-8";
byte[] bytes=Files.readAllBytes(target);
if(method.equals("HEAD")){x.getResponseHeaders().set("Content-Type",ct);x.sendResponseHeaders(200,-1);return;}
send(x,200,ct,bytes);
}
private static void sendError(HttpExchange x,int status,String message) {
try {json(x,status,"{\"error\":"+quoted(message)+"}");}catch(IOException ignored){}
}
private static void json(HttpExchange x,int status,String json) throws IOException {
send(x,status,"application/json; charset=utf-8",json.getBytes(StandardCharsets.UTF_8));
}
private static void send(HttpExchange x,int status,String type,byte[] bytes) throws IOException {
x.getResponseHeaders().set("Content-Type",type);x.sendResponseHeaders(status,bytes.length);
try(OutputStream o=x.getResponseBody()){o.write(bytes);}
}
}
@@ -0,0 +1,25 @@
import java.lang.reflect.*;
import java.nio.*;
import java.util.zip.CRC32;
// Requires only JDK 21, not the SQLite JDBC jar; verifies compatibility with ESP32 binary layout.
final class RecordFixtureTest {
public static void main(String[] args) throws Exception {
byte[] r=new byte[32];r[0]=1;r[1]=1;r[2]=1;
ByteBuffer b=ByteBuffer.wrap(r).order(ByteOrder.LITTLE_ENDIAN);
b.putInt(4,100);b.putLong(8,1792828800000L);
b.putShort(16,(short)41);b.putShort(18,(short)55);
CRC32 crc=new CRC32();crc.update(r,0,28);b.putInt(28,(int)crc.getValue());
Method m=BreathServer.class.getDeclaredMethod("verifyAndSummarize",byte[].class);
m.setAccessible(true);
Object summary=m.invoke(null,(Object)r);
Method cycles=summary.getClass().getDeclaredMethod("cycles");cycles.setAccessible(true);
Method duration=summary.getClass().getDeclaredMethod("durationMs");duration.setAccessible(true);
if((Long)cycles.invoke(summary)!=1||(Long)duration.invoke(summary)!=9600L)
throw new AssertionError("Cycle values not decoded correctly");
r[16]^=1;
try {m.invoke(null,(Object)r);throw new AssertionError("Corrupted CRC accepted");}
catch(InvocationTargetException ex){if(!ex.getCause().getMessage().contains("CRC32"))throw ex;}
System.out.println("PASS: 32-byte little-endian event, duration and CRC32 validation");
}
}
@@ -0,0 +1,39 @@
plugins {
id 'java'
id 'application'
id 'com.github.johnrengelman.shadow' version '8.1.1'
}
group = 'me.shineup'
version = '1.0.0'
repositories { mavenCentral() }
java {
toolchain { languageVersion = JavaLanguageVersion.of(17) }
}
dependencies {
implementation 'org.xerial:sqlite-jdbc:3.50.3.0'
implementation 'org.slf4j:slf4j-nop:2.0.16'
}
sourceSets {
main {
java.srcDirs = ['.']
java.includes = ['BreathServer.java']
}
}
application { mainClass = 'BreathServer' }
tasks.jar { enabled = false }
shadowJar {
archiveBaseName = 'breathmonitor'
archiveVersion = '1.0.0'
archiveClassifier = ''
mergeServiceFiles()
manifest { attributes 'Main-Class': 'BreathServer' }
}
tasks.build { dependsOn tasks.shadowJar }
@@ -0,0 +1,12 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
if [[ -x ./gradlew ]]; then
./gradlew --no-daemon shadowJar
elif command -v gradle >/dev/null 2>&1; then
gradle --no-daemon shadowJar
else
echo 'Gradle is required (install Gradle or provide ./gradlew).' >&2
exit 1
fi
printf 'Built %s\n' "$(pwd)/build/libs/breathmonitor-1.0.0.jar"
@@ -0,0 +1,6 @@
#Mon Oct 20 16:15:09 MSK 2025
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
+234
View File
@@ -0,0 +1,234 @@
#!/bin/sh
#
# Copyright © 2015-2021 the original authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
##############################################################################
#
# Gradle start up script for POSIX generated by Gradle.
#
# Important for running:
#
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
# noncompliant, but you have some other compliant shell such as ksh or
# bash, then to run this script, type that shell name before the whole
# command line, like:
#
# ksh Gradle
#
# Busybox and similar reduced shells will NOT work, because this script
# requires all of these POSIX shell features:
# * functions;
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
# * compound commands having a testable exit status, especially «case»;
# * various built-in commands including «command», «set», and «ulimit».
#
# Important for patching:
#
# (2) This script targets any POSIX shell, so it avoids extensions provided
# by Bash, Ksh, etc; in particular arrays are avoided.
#
# The "traditional" practice of packing multiple parameters into a
# space-separated string is a well documented source of bugs and security
# problems, so this is (mostly) avoided, by progressively accumulating
# options in "$@", and eventually passing that to Java.
#
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
# see the in-line comments for details.
#
# There are tweaks for specific operating systems such as AIX, CygWin,
# Darwin, MinGW, and NonStop.
#
# (3) This script is generated from the Groovy template
# https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
# within the Gradle project.
#
# You can find Gradle at https://github.com/gradle/gradle/.
#
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
app_path=$0
# Need this for daisy-chained symlinks.
while
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
[ -h "$app_path" ]
do
ls=$( ls -ld "$app_path" )
link=${ls#*' -> '}
case $link in #(
/*) app_path=$link ;; #(
*) app_path=$APP_HOME$link ;;
esac
done
APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
APP_NAME="Gradle"
APP_BASE_NAME=${0##*/}
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
# Use the maximum available, or set MAX_FD != -1 to use that value.
MAX_FD=maximum
warn () {
echo "$*"
} >&2
die () {
echo
echo "$*"
echo
exit 1
} >&2
# OS specific support (must be 'true' or 'false').
cygwin=false
msys=false
darwin=false
nonstop=false
case "$( uname )" in #(
CYGWIN* ) cygwin=true ;; #(
Darwin* ) darwin=true ;; #(
MSYS* | MINGW* ) msys=true ;; #(
NONSTOP* ) nonstop=true ;;
esac
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
# Determine the Java command to use to start the JVM.
if [ -n "$JAVA_HOME" ] ; then
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD=$JAVA_HOME/jre/sh/java
else
JAVACMD=$JAVA_HOME/bin/java
fi
if [ ! -x "$JAVACMD" ] ; then
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
else
JAVACMD=java
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
# Increase the maximum file descriptors if we can.
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
case $MAX_FD in #(
max*)
MAX_FD=$( ulimit -H -n ) ||
warn "Could not query maximum file descriptor limit"
esac
case $MAX_FD in #(
'' | soft) :;; #(
*)
ulimit -n "$MAX_FD" ||
warn "Could not set maximum file descriptor limit to $MAX_FD"
esac
fi
# Collect all arguments for the java command, stacking in reverse order:
# * args from the command line
# * the main class name
# * -classpath
# * -D...appname settings
# * --module-path (only if needed)
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
# For Cygwin or MSYS, switch paths to Windows format before running java
if "$cygwin" || "$msys" ; then
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
JAVACMD=$( cygpath --unix "$JAVACMD" )
# Now convert the arguments - kludge to limit ourselves to /bin/sh
for arg do
if
case $arg in #(
-*) false ;; # don't mess with options #(
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
[ -e "$t" ] ;; #(
*) false ;;
esac
then
arg=$( cygpath --path --ignore --mixed "$arg" )
fi
# Roll the args list around exactly as many times as the number of
# args, so each arg winds up back in the position where it started, but
# possibly modified.
#
# NB: a `for` loop captures its iteration list before it begins, so
# changing the positional parameters here affects neither the number of
# iterations, nor the values presented in `arg`.
shift # remove old arg
set -- "$@" "$arg" # push replacement arg
done
fi
# Collect all arguments for the java command;
# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
# shell script including quotes and variable substitutions, so put them in
# double quotes to make sure that they get re-expanded; and
# * put everything else in single quotes, so that it's not re-expanded.
set -- \
"-Dorg.gradle.appname=$APP_BASE_NAME" \
-classpath "$CLASSPATH" \
org.gradle.wrapper.GradleWrapperMain \
"$@"
# Use "xargs" to parse quoted args.
#
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
#
# In Bash we could simply go:
#
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
# set -- "${ARGS[@]}" "$@"
#
# but POSIX shell has neither arrays nor command substitution, so instead we
# post-process each arg (as a line of input to sed) to backslash-escape any
# character that might be a shell metacharacter, then use eval to reverse
# that process (while maintaining the separation between arguments), and wrap
# the whole thing up as a single "set" statement.
#
# This will of course break if any of these variables contains a newline or
# an unmatched quote.
#
eval "set -- $(
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
xargs -n1 |
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
tr '\n' ' '
)" '"$@"'
exec "$JAVACMD" "$@"
@@ -0,0 +1,12 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion><groupId>me.shineup</groupId><artifactId>breathmonitor</artifactId><version>1.0.0</version><packaging>jar</packaging>
<properties><maven.compiler.release>21</maven.compiler.release><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
<dependencies>
<dependency><groupId>org.xerial</groupId><artifactId>sqlite-jdbc</artifactId><version>3.50.3.0</version></dependency>
<dependency><groupId>org.slf4j</groupId><artifactId>slf4j-nop</artifactId><version>2.0.16</version></dependency>
</dependencies>
<build><sourceDirectory>${project.basedir}</sourceDirectory><plugins>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.13.0</version><configuration><includes><include>BreathServer.java</include></includes></configuration></plugin>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-shade-plugin</artifactId><version>3.6.0</version><executions><execution><phase>package</phase><goals><goal>shade</goal></goals><configuration><createDependencyReducedPom>false</createDependencyReducedPom><transformers><transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainClass>BreathServer</mainClass></transformer></transformers></configuration></execution></executions></plugin>
</plugins></build>
</project>
@@ -0,0 +1,8 @@
pluginManagement {
repositories {
gradlePluginPortal()
mavenCentral()
}
}
rootProject.name = 'breathmonitor'
@@ -0,0 +1,7 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
export BREATH_BIND="${BREATH_BIND:-127.0.0.1}"
export BREATH_PORT="${BREATH_PORT:-8090}"
export PUBLIC_ORIGIN="${PUBLIC_ORIGIN:-https://breathmonitor.shineup.me}"
exec java -jar build/libs/breathmonitor-1.0.0.jar "$@"
@@ -0,0 +1,80 @@
'use strict';
const $ = (id) => document.getElementById(id);
const number = (value) => new Intl.NumberFormat('ru-RU').format(value || 0);
const duration = (ms) => { const min=Math.round(ms/60000); return min >= 60 ? `${Math.floor(min/60)} ч ${min%60} мин` : `${min} мин`; };
const readableDay = (day) => `${day.slice(6,8)}.${day.slice(4,6)}.${day.slice(0,4)}`;
async function request(path, options) {
const result=await fetch(path,{credentials:'same-origin', ...options});
let data;
try { data=await result.json(); } catch {throw new Error(`HTTP ${result.status}`);}
if(!result.ok)throw new Error(data.error||`HTTP ${result.status}`);
return data;
}
function showLoggedIn(yes){$('loginPanel').classList.toggle('hidden',yes);$('dashboard').classList.toggle('hidden',!yes);$('logout').classList.toggle('hidden',!yes);}
async function loadMe(){
try { const me=await request('/api/me');showLoggedIn(true);$('userName').textContent=me.login;
$('published').checked=!!me.published;await loadStats(); }
catch { showLoggedIn(false);$('userName').textContent=''; }
}
async function loadStats(){
const data=await request('/api/stats');
$('totalCycles').textContent=number(data.totalCycles);
$('totalHours').textContent=duration(data.totalDurationMs);
$('activeDays').textContent=number(data.activeDays);
$('avgCycle').textContent=data.totalCycles?`${(data.totalDurationMs/data.totalCycles/1000).toFixed(1)} с`:'—';
$('syncedAt').textContent=data.lastSyncMs?`Обновлено: ${new Date(data.lastSyncMs).toLocaleString('ru-RU')}`:'Пока нет загрузок';
const days=[...data.daily].slice(0,12);
$('dailyList').replaceChildren();
for(const d of days){const row=document.createElement('div');row.className='day';
const label=document.createElement('div');label.textContent=readableDay(d.day);
const small=document.createElement('small');small.textContent=`${number(d.cycles)} циклов · ср. ${d.cycles?(d.durationMs/d.cycles/1000).toFixed(1):'—'} с`;
label.append(small);const value=document.createElement('strong');value.textContent=duration(d.durationMs);row.append(label,value);$('dailyList').append(row);}
if(!days.length)$('dailyList').textContent='Пока нет синхронизированных практик.';
$('notice').textContent=data.undatedCycles?`Циклов без достоверной даты: ${number(data.undatedCycles)}. Синхронизируйте часы прибора.`:'';
renderChart(data.daily);
}
function renderChart(days){
const canvas=$('chart'),ctx=canvas.getContext('2d');
const w=canvas.width,h=canvas.height;ctx.clearRect(0,0,w,h);
const indexed=new Map(days.map(d=>[d.day,d.durationMs/60000]));
const today=new Date();const series=[];
for(let n=29;n>=0;n--){const date=new Date(today.getFullYear(),today.getMonth(),today.getDate()-n);
const key=`${date.getFullYear()}${String(date.getMonth()+1).padStart(2,'0')}${String(date.getDate()).padStart(2,'0')}`;
series.push({date,value:indexed.get(key)||0});}
const max=Math.max(20,...series.map(s=>s.value)), top=25,bottom=260,base=bottom-top;
ctx.strokeStyle='#375163';ctx.lineWidth=1;ctx.fillStyle='#9bb0bf';ctx.font='17px system-ui';
for(let i=0;i<=4;i++){const y=bottom-i*base/4;ctx.beginPath();ctx.moveTo(44,y);ctx.lineTo(w-10,y);ctx.stroke();
ctx.fillText(`${Math.round(max*i/4)}м`,0,y+5);}
const span=(w-64)/30;
for(let i=0;i<series.length;i++){
const x=47+i*span,bar=series[i].value/max*base;
ctx.fillStyle=i>=27?'#51d4bb':'#4c87ac';ctx.fillRect(x,bottom-bar,Math.max(5,span-6),bar);
if(i%7===0||i===29){ctx.fillStyle='#9bb0bf';ctx.fillText(String(series[i].date.getDate()),x,bottom+25);}
}
}
async function loadLeaderboard(){
const rows=await request('/api/leaderboard');const board=$('leaderboard');board.replaceChildren();
if(!rows.length){const msg=document.createElement('p');msg.className='empty';msg.textContent='Пока никто не включил участие в рейтинге.';board.append(msg);return;}
rows.forEach((r,i)=>{
const row=document.createElement('div');row.className='leader';
const rank=document.createElement('span');rank.className='rank';rank.textContent=`#${i+1}`;
const login=document.createElement('b');login.textContent=r.login;
const time=document.createElement('span');time.className='value';time.textContent=duration(r.durationMs);
const cycles=document.createElement('span');cycles.className='cycles';cycles.textContent=`${number(r.cycles)} циклов`;
row.append(rank,login,time,cycles);board.append(row);
});
}
$('loginForm').addEventListener('submit',async event=>{
event.preventDefault();$('loginError').textContent='';
const fd=new FormData(event.target);
try {
await request('/api/login',{method:'POST',headers:{'Content-Type':'text/plain; charset=utf-8'},body:`${fd.get('login')}\n${fd.get('password')}`});
event.target.reset();await loadMe();
}catch(e){$('loginError').textContent=e.message;}
});
$('logout').addEventListener('click',async()=>{try{await request('/api/logout',{method:'POST'});}catch{}showLoggedIn(false);$('userName').textContent='';});
$('published').addEventListener('change',async event=>{
try{await request('/api/privacy',{method:'POST',headers:{'Content-Type':'text/plain'},body:String(event.target.checked)});await loadLeaderboard();}
catch(e){event.target.checked=!event.target.checked;$('notice').textContent=`Ошибка изменения видимости: ${e.message}`;}
});
loadMe();loadLeaderboard().catch(()=>{$('leaderboard').textContent='Не удалось загрузить рейтинг.';});
@@ -0,0 +1,29 @@
<!doctype html>
<html lang="ru"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="theme-color" content="#111e2d"><title>BreathMonitor · Статистика дыхания</title>
<link rel="stylesheet" href="/style.css">
</head><body>
<header class="nav"><div class="brand"><span class="logo">◉</span><div>BreathMonitor<small>Дыхательные практики</small></div></div>
<div class="right"><span id="userName"></span><button id="logout" class="subtle hidden">Выход</button></div></header>
<main>
<section class="hero"><div><span class="eyebrow">BREATH DATA · LIVE DASHBOARD</span><h1>Прогресс начинается<br>с каждого вдоха.</h1><p>Автономная запись на устройстве. Синхронизация по запросу. История, которая остаётся с вами.</p></div>
<div class="pulse"><div class="orb"></div><span>INHALE · EXHALE</span></div></section>
<section id="loginPanel" class="panel auth"><div><div class="eyebrow">ЛИЧНЫЙ КАБИНЕТ</div><h2>Войти в статистику</h2><p>Аккаунт создаётся администратором сервера. Логин и пароль используются также для привязки прибора.</p></div>
<form id="loginForm"><label>Логин<input name="login" required minlength="3" maxlength="24" autocomplete="username" placeholder="например, aidar"></label>
<label>Пароль<input name="password" type="password" required autocomplete="current-password" placeholder="••••••••••••"></label>
<button type="submit" class="primary">Войти →</button><p id="loginError" class="error" role="alert"></p></form></section>
<section id="dashboard" class="hidden">
<div class="section-title"><div><span class="eyebrow">МОЯ СТАТИСТИКА</span><h2>Обзор практики</h2></div><span id="syncedAt" class="pill">Не синхронизировано</span></div>
<div class="stat-grid"><div class="stat"><span>Всего циклов</span><strong id="totalCycles">—</strong></div><div class="stat"><span>Всего времени</span><strong id="totalHours">—</strong></div>
<div class="stat"><span>Активных дней</span><strong id="activeDays">—</strong></div><div class="stat"><span>Средний цикл</span><strong id="avgCycle">—</strong></div></div>
<div class="grid"><section class="panel chart"><div class="panel-head"><div><h3>Регулярность</h3><p>Минуты практики за последние 30 дней</p></div></div>
<canvas id="chart" width="900" height="300" aria-label="Время практики по дням"></canvas></section>
<section class="panel"><div class="panel-head"><h3>Последние дни</h3><span>История</span></div><div id="dailyList" class="days"></div></section></div>
<section class="panel privacy"><div><h3>Открытый рейтинг</h3><p>По умолчанию ваши данные скрыты. Вы можете добровольно включить публичный показ общего результата. Детальные графики остаются личными.</p></div><label class="toggle"><input id="published" type="checkbox"><span>Показывать меня в рейтинге</span></label></section>
<p id="notice" class="hint"></p>
</section>
<div class="section-title"><div><span class="eyebrow">СООБЩЕСТВО</span><h2>Рейтинг участников</h2></div><span class="pill">По общему времени практики</span></div>
<section class="panel"><div id="leaderboard" class="leaders"><p class="empty">Загрузка рейтинга…</p></div></section>
<footer>BreathMonitor · Время практики рассчитывается по завершённым зарегистрированным циклам. Данные обновляются после ручной синхронизации прибора.</footer>
</main><script src="/app.js" defer></script></body></html>
File diff suppressed because one or more lines are too long