VEU.WathBody/1-docs/4-modules/m02-rest-api/api_specs/01-config-bootstrap.md

Спецификация: конфигурация и стартовая инициализация (единица 1)

Назначение

Чтение appsettings.json, валидация при старте (tech-requirements 4.2), тест подключения к БД; идемпотентная синхронизация атлетов из конфига с src.athlete (upsert по хэшу ключа).

Конфигурация

Параметр	Тип	Валидация
Api.Key	string	непустой; уникальный среди Api.Athletes[].apiKey
Api.Athletes	list	каждый {name, apiKey}: оба поля непусты; дубликаты apiKey — фатально
Db.ConnectionString	string	непустой; тест подключения при старте — фатально при неудаче

Ошибка любой проверки: запись в лог (Log.Logger, уровень Error) + stderr, код возврата процесса 1.

Логика

1. Загрузить и провалидировать конфиг (порядок: Api.Key → Api.Athletes → Db.ConnectionString).
2. Тест подключения к БД (репозиторий MigrationRepository или прямой запрос SELECT 1 через Kit.Helpers).
3. Для каждого атлета из Api.Athletes:
   • hash = SHA256(apiKey) (hex, lower-case — тот же формат, что пишет m08 при создании атлета);
   • athlete_select по p_api_key_hash = hash;
   • если не найден — athlete_insert(p_name, p_api_key_hash);
   • если найден и имя отличается — athlete_update (имя из конфига — источник);
   • 🛡 is_blocked конфигом не переопределяется — источник блокировки только БД.

Тесты

#	Проверка	Ожидание
1	Пустой Api.Key	код возврата 1, ошибка в лог/stderr
2	Дубликат apiKey среди Api.Athletes	код возврата 1
3	Недоступная БД (Db.ConnectionString → неверный порт)	код возврата 1
4	Первый старт: атлет конфига отсутствует в БД	создан src.athlete с SHA-256-хэшем ключа
5	Повторный старт (идемпотентность)	дублей атлетов нет
6	Переименование атлета в конфиге	имя в БД обновлено, id сохранён

Пример конфига

{ "Api": { "Key": "owner-key", "Athletes": [ { "name": "Иван", "apiKey": "ivan-key-1" } ] },
  "Db": { "ConnectionString": "Host=127.0.0.1;Port=5433;Database=watchbody;Username=postgres;Password=watchbody" } }