добавлены документация проекта и каркас разработки

- README, CLAUDE.md, docs: назначение и границы, архитектура, конвенции, план
- docs/local-research.md — 36 находок по формату Health Auto Export, снятых на
  живых данных; документация приложения местами расходится с тем, что оно шлёт
- Taskfile, .golangci.yml, самодокументируемый config.example.toml
This commit is contained in:
av
2026-08-01 12:37:03 +03:00
commit 5e2385ba6e
12 changed files with 2318 additions and 0 deletions
+30
View File
@@ -0,0 +1,30 @@
# Образец конфигурации healthlog.
#
# Реальный config.toml не коммитится (в нём токены), права 0600.
# Все поля необязательны: без файла сервис поднимается на умолчаниях, что
# удобно для локального запуска. Умолчание каждого поля указано ниже.
[server]
addr = ":8080" # адрес прослушивания; ":8080" — все интерфейсы (нужно, чтобы телефон достучался по локальной сети)
read_timeout = "5m" # на всё чтение запроса вместе с телом; Go-duration. Щедро: экспорт истории — десятки мегабайт по мобильной сети
write_timeout = "30s" # на отправку ответа; Go-duration
[auth]
# Токены проверяются как `Authorization: Bearer <токен>`.
# Health Auto Export умеет слать произвольные заголовки — токен задаётся в
# настройках автоматизации.
# ПУСТОЙ СПИСОК = ПРОВЕРКА ВЫКЛЮЧЕНА. Так можно в доверенной локальной сети;
# сервис предупреждает об этом на старте записью `write auth disabled`.
write_tokens = [] # токены на приём данных
read_tokens = [] # токены на чтение (read API появится позже)
[storage]
db_path = "./healthlog.db" # файл SQLite-витрины; каталог должен существовать
archive_dir = "./raw" # корень сырого архива; создаётся при старте
[ingest]
max_body_mb = 64 # максимальный размер тела запроса, МиБ; целое > 0. Больше — 413
[log]
level = "info" # debug | info | warn | error
format = "json" # json | text (text удобен при локальной отладке)