Зафиксировать рабочий BreathMonitor v1 и сервер
This commit is contained in:
Generated
+10
@@ -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,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
|
||||
+31
@@ -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-----
|
||||
+5
-5
@@ -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"
|
||||
Vendored
BIN
Binary file not shown.
Vendored
+6
@@ -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
@@ -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
Reference in New Issue
Block a user