feat: /meta для версии в футере и устойчивый разбор JSON

Merge pull request 'fix(api): дублировать маршруты под /api и убрать Content-Type у GET' (#16 ) from fix/api-prefix-routing into main
Reviewed-on: #16
2026-04-08 10:32:52 +03:00 · 2026-04-08 07:21:03 +00:00 · 2026-04-08 10:20:17 +03:00 · 2026-04-07 22:21:49 +00:00 · 2026-04-08 01:21:11 +03:00 · 2026-04-07 21:55:25 +00:00
54 changed files with 2822 additions and 991 deletions
--- a/.dockerignore
+++ b/.dockerignore
@@ -0,0 +1,10 @@
+.git
+.github
+**/node_modules
+**/dist
+.env
+.env.*
+!.env.example
+**/*.md
+.cursor
+*.log
--- a/.env.example
+++ b/.env.example
@@ -1,18 +1,39 @@
-# ─── PostgreSQL ───────────────────────────────────────────────
+# =============================================================================
+# Корневой шаблон окружения: локальная разработка, docker-compose.yml (Postgres)
+# и docker-compose.stack.yml (backend + frontend в общей сети с Postgres).
+# Скопируйте в .env и подставьте значения. Файл .env не коммитьте.
+# =============================================================================
+
+# ─── Подключение бэкенда к PostgreSQL ──────────────────────────
+# Локально + docker-compose из этого репо: DB_HOST=localhost, DB_PORT=5432
+# Backend в Docker рядом с Postgres: DB_HOST = имя контейнера/сервиса в той же
+# docker-сети (например postgres_budget), DB_PORT=5432 (внутренний порт Postgres).
 DB_HOST=localhost
 DB_PORT=5432
 DB_NAME=calendar_run
 DB_USER=calendar_user
-DB_PASSWORD=calendar_pass
+DB_PASSWORD=replace_with_strong_secret

-# ─── Backend API ──────────────────────────────────────────────
-# Port the API server listens on
+# ─── Backend API ───────────────────────────────────────────────
+# Порт процесса: сначала PORT, иначе API_PORT, иначе 3001.
+# В docker-compose.stack.yml для контейнера задаётся PORT=3000 (см. compose).
+# PORT=3000
 API_PORT=3001

-# ─── CORS ─────────────────────────────────────────────────────
-# Allowed origin for the frontend (Vite dev server default)
+# ─── Режим без БД (только тесты / smoke API, не для migrate/seed) ─
+# CALENDAR_RUN_MOCK_DB=1
+
+# ─── CORS ────────────────────────────────────────────────────
+# Должен совпадать с origin в браузере (схема + хост + порт, без пути), иначе API «молчит».
+# Локальный Vite: http://localhost:5173
+# Стек с фронтом на 3033: http://localhost:3033
+# Прод: https://ваш-домен  — несколько origin через запятую: https://a.ru,https://www.a.ru
 CORS_ORIGIN=http://localhost:5173

-# ─── Frontend (Vite) ─────────────────────────────────────────
-# Public URL of the API, used in SPA code via import.meta.env
+# ─── Версия API (опционально) ─────────────────────────────────
+# Если в образе не удаётся прочитать package.json, подставьте вручную (видно в GET /health).
+# APP_VERSION=1.0.0
+
+# ─── Frontend (Vite, локально из каталога frontend/) ─────────
+# В Docker-образе фронта базовый URL API задаётся при сборке (/api), не из .env.
 VITE_API_BASE_URL=http://localhost:3001
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: |
+            backend/package-lock.json
+            frontend/package-lock.json
+
+      - name: Backend — install, build, test
+        working-directory: backend
+        env:
+          CALENDAR_RUN_MOCK_DB: "1"
+        run: |
+          npm ci
+          npm run build
+          npm test
+
+      - name: Frontend — install, build
+        working-directory: frontend
+        run: |
+          npm ci
+          npm run build
--- a/.gitignore
+++ b/.gitignore
@@ -2,5 +2,4 @@ node_modules/
 dist/
 .env
 *.log
-*plan*
-*PLAN*
+.DS_Store
--- a/Dockerfile.backend
+++ b/Dockerfile.backend
@@ -0,0 +1,22 @@
+# Сборка из корня монорепо: docker build -f Dockerfile.backend .
+FROM node:20-alpine AS deps
+WORKDIR /app
+COPY backend/package.json backend/package-lock.json ./
+RUN npm ci
+
+FROM deps AS build
+COPY backend/tsconfig.json ./
+COPY backend/src ./src
+RUN npm run build
+
+FROM node:20-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+COPY backend/package.json backend/package-lock.json ./
+RUN npm ci --omit=dev
+COPY --from=build /app/dist ./dist
+COPY backend/migrations ./migrations
+COPY import ./import
+EXPOSE 3000
+ENV PORT=3000
+CMD ["node", "dist/index.js"]
--- a/Dockerfile.frontend
+++ b/Dockerfile.frontend
@@ -0,0 +1,15 @@
+# Сборка из корня монорепо: docker build -f Dockerfile.frontend .
+# SPA дергает API по префиксу /api (nginx проксирует на сервис backend:3000).
+FROM node:20-alpine AS build
+WORKDIR /app
+COPY frontend/package.json frontend/package-lock.json ./
+RUN npm ci
+COPY frontend/ ./
+ARG VITE_API_BASE_URL=/api
+ENV VITE_API_BASE_URL=$VITE_API_BASE_URL
+RUN npm run build
+
+FROM nginx:alpine
+COPY --from=build /app/dist /usr/share/nginx/html
+COPY docker/nginx.frontend.conf /etc/nginx/conf.d/default.conf
+EXPOSE 80
--- a/PLAN.md
+++ b/PLAN.md
@@ -1,202 +0,0 @@
-# План: календарь забегов (SPA + API + PostgreSQL)
-
-Консолидированный план реализации с актуальными решениями. После инициализации git — работать в отдельной ветке (например `feature/race-calendar-app`).
-
-## 1. Цели продукта
-
-1. **Расписание по месяцу** — выбор месяца/года, список забегов.
-2. **Расписание на год** — календарная сетка года, отметки на датах со стартами; по клику на дату — модалка/панель со списком забегов и переход на карточку.
-3. Добавлять забеги **запланированные** и **уже прошедшие**.
-4. Для **прошедших** — ввод/редактирование **результата** и **стартового номера**; поля можно дописать позже.
-5. **Личные рекорды** на главной по дистанциям: 1 км, 5 км, 10 км, 15 км, 21.1 км, 42.2 км — обновляются, если в забеге указан более быстрый результат на «подходящей» дистанции.
-6. **Старты (организатор):** дата и время старта, расписание кластеров, выдача номеров — **ручной ввод**; обязательна возможность указать **официальную ссылку** на страницу организатора (автопарсинг сайтов не входит в объём).
-7. **Авторизация не требуется.**
-
-## 2. Исходные данные в репозитории
-
- Файл `import/races_2026_calendar.csv` — колонки `date`, `month`, `day`, `event`, `distance_km`.
- Назначение CSV: **один раз** — как вход для **seed-скрипта**, который пишет строки в PostgreSQL.
- **В рантайме** ни фронт, ни API этот CSV **не читают**. После успешного seed файл может оставаться в репо только как архив/референс.
-
-## 3. Стек и структура репозитория
-
- **Монорепозиторий:** `frontend/` (Vite + React 18 + TypeScript + react-router-dom) и `backend/` (Node.js + Fastify или Express).
- **БД:** PostgreSQL; схема — SQL-миграции в `backend/` (или согласованный каталог миграций).
- **Локально:** `docker-compose.yml` с сервисом Postgres.
- **Стили:** CSS + **BEM** + CSS variables (минимальная дизайн-система: цвета, отступы, типографика).
- **Даты/время:** `date-fns` или `Intl`, русская локаль там, где нужно.
-
-### 3.1 Переменные окружения
-
-**Только на сервере API (никогда не во фронт-бандле):**
-
-```env
-DB_HOST=
-DB_PORT=
-DB_NAME=
-DB_USER=
-DB_PASSWORD=
-```
-
-Дополнительно по необходимости: `PORT` или `API_PORT`, `NODE_ENV`, `CORS_ORIGIN`.
-
-**Фронтенд (Vite):** только публичный адрес API, например:
-
-```env
-VITE_API_BASE_URL=http://localhost:3001
-```
-
-В коде: `import.meta.env.VITE_API_BASE_URL`.
-
-Шаблон без секретов — корневой `.env.example`; описание — в `docs/frontend.md` и `docs/backend.md`.
-
-## 4. Источник правды и поток данных
-
-### 4.1 Рантайм
-
-Единственный источник правды для календаря и карточек в работающем приложении — **PostgreSQL**. SPA общается **только с HTTP API**.
-
-**localStorage не используется** для хранения забегов или «дельт».
-
-```mermaid
-flowchart LR
-  User[User]
-  SPA[React SPA]
-  API[Node API]
-  DB[(PostgreSQL)]
-  User --> SPA
-  SPA -->|"fetch VITE_API_BASE_URL"| API
-  API -->|"DB_* connection"| DB
-```
-
-
-
-### 4.2 Вне рантайма (разово)
-
-**Seed-скрипт** (запуск вручную при развёртывании/обновлении стартового набора):
-
- Читает `import/*.csv` и/или опционально `public/data/races.json`.
- Выполняет `INSERT` / upsert в таблицу `races`.
- Не вызывается из SPA и не выполняется на каждом HTTP-запросе.
-
-Промежуточная ступень **CSV → races.json для работы SPA не обязательна**: seed может писать в БД напрямую из CSV и/или из JSON.
-
-### 4.3 Разовый перенос CSV → БД
-
- Парсинг: заголовок; кавычки в `event`; `distance_km` — число; `date` — `YYYY-MM-DD`.
- После переноса приложение в обычном режиме **не использует** `import/races_2026_calendar.csv`. Новые старты — через UI/API (или отдельная админ-фича импорта, если появится позже).
-
-## 5. Модель данных (БД и API)
-
-Один набор полей — в таблице, в JSON тел запросов/ответов API и в опциональном файле для seed. Согласовать **camelCase в API** и **snake_case в SQL** в `docs/backend.md`.
-
-
-| Поле              | Обяз. | Примечание                                           |
-| ----------------- | ----- | ---------------------------------------------------- |
-| `id`              | да    | Стабильный ключ, напр. `2026-05-03-kazan-marathon`   |
-| `date`            | да    | День старта `YYYY-MM-DD`                             |
-| `title`           | да    | Название                                             |
-| `distanceKm`      | да    | Число км                                             |
-| `status`          | нет   | `planned` / `completed`; иначе можно вывести из даты |
-| `officialUrl`     | нет   | Ссылка на организатора                               |
-| `startTime`       | нет   | Напр. `09:30`                                        |
-| `clusterSchedule` | нет   | Многострочный текст                                  |
-| `bibPickup`       | нет   | Выдача номеров                                       |
-| `bibNumber`       | нет   | Стартовый номер                                      |
-| `finishTime`      | нет   | Время H:MM:SS / HH:MM:SS; для PR — перевод в секунды |
-| `notes`           | нет   | Заметки                                              |
-
-
-Опционально в миграциях: `created_at`, `updated_at`.
-
-**Операции:** `GET` список/фильтры по году-месяцу при необходимости, `GET :id`, `POST`, `PATCH :id`, при необходимости `DELETE` — зафиксировать в `docs/backend.md`.
-
-## 6. Поведение SPA
-
-### 6.1 Форма «Добавить забег»
-
- Обязательно: дата, название, дистанция.
- Если дата **строго до сегодня** (локальная дата пользователя) — показать **результат** и **стартовый номер** (необязательны при первом сохранении).
- Если дата в будущем — поля результата скрыты.
- Опционально: чекбокс «Уже прошёл» для случая **сегодняшней** даты, чтобы открыть поля результата.
- Сохранение: `**POST`** на API → запись в БД.
-
-### 6.2 Страница забега
-
- Все поля модели; для прошедших — акцент на результат и номер.
- Редактирование результата и номера **в любой момент**: `**PATCH`** на API, затем обновление состояния на клиенте (refetch / инвалидация кэша).
-
-### 6.3 Личные рекорды
-
- Дистанции: 1, 5, 10, 15, 21.1, 42.2 км.
- Учитывать забеги с заполненным `finishTime` и дистанцией в пределах допуска к целевой (напр. 21.0975 → 21.1, 42.195 → 42.2).
- «Чужие» дистанции (2 км, 6 км, 30 км…) в таблицу PR по умолчанию **не** включаются.
- Расчёт на клиенте по данным, полученным с API.
-
-### 6.4 Экраны
-
-1. Главная — PR, навигация «Месяц» / «Год», ближайшие старты.
-2. Месяц — селектор, список.
-3. Год — сетка, маркеры, клик по дате → модалка со списком → карточка.
-4. Карточка забега, форма добавления.
-5. Доступность модалки: фокус, Esc, контраст.
-
-## 7. Документация
-
-Создать каталог `**docs/`**:
-
-
-| Файл               | Назначение                                              |
-| ------------------ | ------------------------------------------------------- |
-| `docs/backend.md`  | Docker, `DB`_*, миграции, seed, REST API, CORS          |
-| `docs/frontend.md` | Структура `frontend/`, `VITE`_*, сборка, контракт с API |
-| `docs/ux-spa.md`   | Сценарии, экраны, BEM, кратко про a11y                  |
-
-
-Корневой `**README.md`**: описание проекта, быстрый старт, **ссылки на три файла выше**.
-
-## 8. Риски и ограничения
-
- `**DB`_* и пароли** — только в окружении сервера API; в git — только `.env.example` без реальных секретов.
- Актуальные данные после работы в UI — в **БД**; файлы в git не синхронизируются с правками автоматически. Надёжный бэкап — **резервное копирование PostgreSQL**.
- Деплой: Postgres + процесс API с env + статическая раздача фронта (или иная схема хостинга — описать в README).
- Данные организаторов (расписание стартов) — **вручную** + ссылка; без парсинга чужих сайтов в объёме первой версии.
-
-## 9. Ключевые пути после реализации
-
- `docker-compose.yml`, `.env.example`
- `backend/` — сервер, миграции, роуты
- `scripts/` или `backend/scripts/` — **разовый** seed из CSV/JSON
- `import/races_2026_calendar.csv` — только вход seed (не рантайм)
- `public/data/races.json` — опциональный вход seed
- `frontend/src/api/` — клиент API
- `frontend/src/pages/`, `frontend/src/components/` — UI (BEM)
- `frontend/src/lib/distances.ts` — PR
- `docs/*.md`, `README.md`
-
-## 10. Чеклист задач (implementation todos)
-
-1. Монорепо: `frontend/` + `backend/`, BEM, токены, роутер.
-2. Postgres в docker-compose, миграции таблицы `races`, бэкенд читает `DB`_*.
-3. REST CRUD + разовый seed (CSV и/или JSON) → БД.
-4. Клиент API на фронте, типы, загрузка данных для экранов и PR.
-5. Экраны месяц и год, модалка по дате.
-6. Форма добавления с условными полями; карточка с PATCH результата/номера.
-7. Поля организатора на карточке.
-8. A11y модалки, мобильная вёрстка, смоук-сценарии.
-9. `docs/` + README + `.env.example`.
-
-## 11. Идеи на будущее (тематика бега)
-
- Недельный объём / простой план подготовки.
- Импорт/экспорт JSON для бэкапа через API.
- Фильтры (город, дистанция), погода по дню старта.
- График динамики PR.
- Загрузка GPX / тренировки.
- Браузерные напоминания за N дней до старта.
- Сравнение результатов одной дистанции по годам.
- PWA для офлайн-просмотра (read-only кэш не заменяет БД без продуманной синхронизации).
-
---
-
-*Документ создан как единый актуальный план в корне репозитория. При расхождениях с черновиками в IDE приоритет у этого файла.*
--- a/README.md
+++ b/README.md
@@ -1,24 +1,48 @@
 # Calendar Run

-Calendar Run is a races calendar project with a backend API for storing and querying race events.
+Монорепозиторий: **backend** (Express + PostgreSQL) и **frontend** (React + Vite) — календарь забегов.

-## Quick Start
+## Переменные окружения

-1. Install dependencies:
-  - `cd backend`
-  - `npm install`
-2. Configure environment variables in `backend/.env`:
-  - `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASSWORD`
-  - Optional API port: `PORT` (priority) or `API_PORT`
-  - **No PostgreSQL (CI / local smoke):** set `CALENDAR_RUN_MOCK_DB=1` (or `true`). Real `DB_`* values are not required; the API uses in-memory stubs for SQL used by the HTTP routes. Do not use mock mode for `npm run db:migrate` or `npm run seed`.
-3. Build and run backend:
-  - `npm run build`
-  - `npm run dev`
+Один шаблон для локальной разработки и для Docker-стека: **[`.env.example`](.env.example)** → скопируйте в **`.env`** в корне репозитория.

-By default, the API listens on port `3001` if `PORT` and `API_PORT` are not set.
+Там же перечислены **`DB_HOST`**, **`DB_PORT`**, **`DB_NAME`**, **`DB_USER`**, **`DB_PASSWORD`** (подключение бэкенда к БД), **`PORT`** / **`API_PORT`**, опционально **`CALENDAR_RUN_MOCK_DB`**, **`CORS_ORIGIN`**, а для локального Vite — **`VITE_API_BASE_URL`**.

-## Backend And API Docs
+## Backend — локально

- [Backend API for Frontend](docs/backend-api-for-frontend.md)
- [Backend Agent Instruction](docs/agent-backend-instruction.md)
- [Backend Sync Fix Instruction](docs/agent-fix-backend-sync-instruction.md)
+1. `cd backend && npm install`
+2. Корень: `cp .env.example .env`, задайте `DB_*` (и при необходимости `CORS_ORIGIN`).
+3. Postgres: из корня `docker compose up -d` (см. [`docker-compose.yml`](docker-compose.yml)) — в compose используются те же `DB_NAME`, `DB_USER`, `DB_PASSWORD` из `.env`.
+4. `cd backend && npm run db:migrate && npm run seed`
+5. Dev-режим: `npm run dev`
+6. Или production: `npm run build && npm start`
+
+Без PostgreSQL (только smoke API): в `.env` задайте `CALENDAR_RUN_MOCK_DB=1`; **`db:migrate` и `seed` с mock не использовать**.
+
+## Frontend — локально
+
+```bash
+cd frontend
+cp .env.example .env
+npm install
+npm run dev
+```
+
+Значение `VITE_API_BASE_URL` см. в **корневом** [`.env.example`](.env.example); для dev по умолчанию `http://localhost:3001`. У бэкенда `CORS_ORIGIN` должен совпадать с origin приложения (например `http://localhost:5173`).
+
+## Docker: backend + frontend рядом с Postgres
+
+Используйте [`docker-compose.stack.yml`](docker-compose.stack.yml): общая **внешняя** сеть с контейнером Postgres (как в вашей инфраструктуре). В корне должен быть **`.env`** (из `.env.example`): `DB_HOST` — имя сервиса/контейнера Postgres в этой сети, `DB_PORT=5432`, плюс остальные `DB_*` и **`CORS_ORIGIN=http://localhost:3033`**, если заходите на фронт с хоста на порту 3033.
+
+```bash
+docker compose -f docker-compose.stack.yml up -d --build
+docker compose -f docker-compose.stack.yml exec backend node dist/migrate.js
+docker compose -f docker-compose.stack.yml exec backend node dist/seed.js
+```
+
+Фронт в браузере обращается к API по префиксу **`/api`** (nginx в образе фронта проксирует на backend).
+
+## Документация API и бэкенда
+
+- [Шпаргалка API для фронта](docs/backend-api-for-frontend.md)
+- [Эксплуатация backend](docs/backend.md)
--- a/agent-frontend-ui-instructions.md
+++ b/agent-frontend-ui-instructions.md
@@ -1,336 +0,0 @@
-Ниже — инструкция для дизайн-агента, которая задаёт стиль, структуру и принципы интерфейса для твоего SPA. Она ориентирована на **минимализм, читаемость данных и удовольствие от использования**, а не на “перегруженный фитнес-дэшборд”.
-
-# 🎯 Общая задача
-
-Создать **чистый, современный, минималистичный интерфейс** для SPA-приложения бегуна, где пользователь:
-
- отслеживает свои старты (прошлые и будущие),
- видит прогресс и личные рекорды,
- сравнивает результаты,
- получает ощущение “контроля над своей беговой историей”.
-
---
-
-# 🧭 Общая философия дизайна
-
-### 1. “Спокойная сила”, а не “спортивная агрессия”
-
-Не:
-
- кислотные цвета,
- перегруженные графики,
- “фитнес-клуб стиль 2015”.
-
-Да:
-
- чистый интерфейс,
- воздух,
- акцент на данных,
- ощущение премиальности.
-
---
-
-### 2. Минимум визуального шума
-
-Каждый экран должен отвечать на вопрос:
-
-> “Что здесь главное?”
-
-Если не ясно — убрать лишнее.
-
---
-
-### 3. Данные — главный герой
-
-Интерфейс не про “украшения”, а про:
-
- результаты,
- прогресс,
- сравнение,
- числа.
-
---
-
-# 🎨 Визуальный стиль
-
-## Цвета
-
-### Основа:
-
- фон: светлый (#F7F8FA или близко)
- карточки: белые
- текст:
-  - основной: почти чёрный (#111)
-  - вторичный: серый (#666)
-
-### Акцент:
-
- 1 основной цвет:
-  - глубокий синий или изумрудный (например #2F6BFF или #1FA37A)
-
-### Дополнительно:
-
- PR / успех: мягкий зелёный
- предупреждения: нейтральный жёлтый
- ошибки: мягкий красный
-
-❗ Никаких “радуг”.
-
---
-
-## Типографика
-
- современный sans-serif (Inter / SF Pro / аналог)
- крупные числа:
-  - результаты (время) — большие, жирные
- иерархия:
-  - H1 — экран
-  - H2 — блок
-  - body — данные
-  - caption — мета
-
---
-
-## Отступы и сетка
-
- много воздуха
- карточки с padding 16–24px
- равномерная вертикальная ритмика
- закругления: 12–16px
-
---
-
-# 🧱 Основные экраны
-
-## 1. Главный экран (Dashboard)
-
-### Цель:
-
-дать быстрый ответ:
-
- что впереди
- где я сейчас
- какой прогресс
-
-### Блоки:
-
-#### 🔹 Ближайший старт
-
- название
- дата
- дистанция
- countdown (“через 12 дней”)
-
-#### 🔹 Последний результат
-
- время
- дистанция
- место
- дата
-
-#### 🔹 Личный рекорд
-
- по ключевой дистанции
- выделен визуально
-
-#### 🔹 Сезон
-
- количество стартов
- лучший результат
- краткая статистика
-
---
-
-## 2. Календарь стартов
-
-### Два раздела:
-
- будущие
- прошедшие
-
-### Карточка старта:
-
- название
- дата
- дистанция
- статус:
-  - планирую
-  - зарегистрирован
-  - пробежал
-
-Минимум кликов.
-
---
-
-## 3. Карточка старта
-
- название
- дата
- дистанция
- время
- темп
- место (если есть)
- заметки (опционально)
-
---
-
-## 4. Личные рекорды (PR)
-
- список дистанций:
-  - 5K
-  - 10K
-  - 21.1
-  - 42.2
-
-Для каждой:
-
- лучшее время
- дата
- старт
-
---
-
-## 5. Сравнение стартов (ВАЖНО)
-
-Это ключевая фича.
-
-### UI:
-
-таблица или карточки:
-
-
-| Год | Время | Темп | Место |
-| --- | ----- | ---- | ----- |
-
-
-Можно добавить:
-
- стрелки (лучше/хуже)
- визуальный прогресс
-
---
-
-# 📊 Графики
-
-Минимально и аккуратно:
-
- линия прогресса по дистанции
- без перегруза
- без 10 линий сразу
-
---
-
-# 🧩 Компоненты
-
- карточки
- таблицы (очень аккуратно)
- фильтры
- переключатели (tabs)
- кнопки (primary / secondary)
-
---
-
-# 🧠 UX принципы
-
-### 1. Минимум кликов
-
-Любая частая задача:  
-→ максимум 2–3 клика
-
---
-
-### 2. Быстрое считывание
-
-Пользователь должен за 2 секунды понять:
-
- что это
- где он
- что делать
-
---
-
-### 3. Консистентность
-
- одинаковые карточки
- одинаковые статусы
- одинаковые действия
-
---
-
-# 🧪 Для аналитики (важно)
-
-Заложить:
-
- зоны кликов
- понятные CTA
- отсутствие “пустых зон”
-
---
-
-# 🖼️ Использование изображений
-
-## Когда использовать:
-
- пустые состояния
- onboarding
- вдохновение
-
-## Когда НЕ использовать:
-
- в данных
- в списках стартов
- в результатах
-
---
-
-## Если генерировать изображения
-
-Стиль:
-
- минимализм
- спорт без пафоса
- одиночный бегун
- город / парк
- мягкий свет
- утро / вечер
-
-### Пример prompt:
-
-> “minimalist photo of a runner jogging alone in a city park at sunrise, soft light, calm mood, no crowd, modern aesthetic”
-
---
-
-# 🚫 Чего избегать
-
- перегруженных дашбордов
- 100 метрик сразу
- ярких кислотных цветов
- сложных графиков
- таблиц как в Excel
- лишних иконок
- “геймификации ради геймификации”
-
---
-
-# 💡 Вдохновение (по духу)
-
-Если бы нужно было описать стиль:
-
- как Notion, но для бегунов
- как Apple Fitness, но менее ярко
- как Strava, но более спокойно и чисто
-
---
-
-# 🧭 Финальный ориентир
-
-Интерфейс должен вызывать ощущение:
-
-> “Я контролирую свою беговую историю и прогресс”
-
-а не:
-
-> “Я заполняю таблицу результатов”
-
---
-
--- a/backend/migrations/002_finish_place_and_registered_status.sql
+++ b/backend/migrations/002_finish_place_and_registered_status.sql
@@ -0,0 +1,5 @@
+ALTER TABLE races ADD COLUMN IF NOT EXISTS finish_place TEXT;
+
+ALTER TABLE races DROP CONSTRAINT IF EXISTS races_status_check;
+ALTER TABLE races ADD CONSTRAINT races_status_check
+  CHECK (status IS NULL OR status IN ('planned', 'registered', 'completed'));
--- a/backend/package-lock.json
+++ b/backend/package-lock.json
--- a/backend/package.json
+++ b/backend/package.json
@@ -1,13 +1,14 @@
 {
  "name": "calendar-run-backend",
-  "version": "1.0.0",
+  "version": "1.1.0",
  "private": true,
  "scripts": {
    "build": "tsc",
    "dev": "ts-node src/index.ts",
    "start": "node dist/index.js",
    "db:migrate": "ts-node src/migrate.ts",
-    "seed": "ts-node src/seed.ts"
+    "seed": "ts-node src/seed.ts",
+    "test": "cross-env CALENDAR_RUN_MOCK_DB=1 tsx --test test/app.test.ts"
  },
  "dependencies": {
    "cors": "^2.8.5",
@@ -21,7 +22,11 @@
    "@types/express": "^5.0.0",
    "@types/node": "^22.12.0",
    "@types/pg": "^8.11.10",
+    "@types/supertest": "^6.0.2",
+    "cross-env": "^10.1.0",
+    "supertest": "^7.0.0",
    "ts-node": "^10.9.2",
+    "tsx": "^4.19.2",
    "typescript": "^5.7.3"
  }
 }
--- a/backend/src/app.ts
+++ b/backend/src/app.ts
@@ -0,0 +1,31 @@
+import express, { Request, Response, NextFunction } from "express";
+import cors from "cors";
+import { config } from "./config";
+import healthRouter from "./routes/health";
+import racesRouter from "./routes/races";
+
+export function createApp(): express.Express {
+  const app = express();
+
+  app.use(
+    cors({ origin: config.corsOrigin, methods: ["GET", "POST", "PATCH", "DELETE", "OPTIONS"] }),
+  );
+  app.use(express.json());
+
+  app.use(healthRouter);
+  app.use(racesRouter);
+  // Тот же API под /api/* — если прокси не снимает префикс или запрос идёт напрямую на порт бэкенда с /api.
+  app.use("/api", healthRouter);
+  app.use("/api", racesRouter);
+
+  app.use((err: unknown, _req: Request, res: Response, _next: NextFunction) => {
+    if (err instanceof SyntaxError && "body" in err) {
+      res.status(400).json({ error: "validation_error", details: ["Invalid JSON in request body"] });
+      return;
+    }
+    console.error("[app] Unhandled error:", err);
+    res.status(500).json({ error: "unknown_error", details: ["Internal server error"] });
+  });
+
+  return app;
+}
--- a/backend/src/config.ts
+++ b/backend/src/config.ts
@@ -33,5 +33,21 @@ export const config = {
        password: requireEnv("DB_PASSWORD"),
      },
  apiPort: parseInt(process.env.PORT || process.env.API_PORT || "3001", 10),
-  corsOrigin: process.env.CORS_ORIGIN || "http://localhost:5173",
+  /** Одно значение или несколько через запятую (прод: https://домен) */
+  corsOrigin: parseCorsOrigins(),
 };
+
+function parseCorsOrigins(): string | string[] {
+  const raw = process.env.CORS_ORIGIN?.trim();
+  if (!raw) {
+    return "http://localhost:5173";
+  }
+  const parts = raw.split(",").map((s) => s.trim()).filter(Boolean);
+  if (parts.length === 0) {
+    return "http://localhost:5173";
+  }
+  if (parts.length === 1) {
+    return parts[0]!;
+  }
+  return parts;
+}
--- a/backend/src/db.ts
+++ b/backend/src/db.ts
@@ -15,7 +15,7 @@ const poolConfig: PoolConfig = {

 function mockRowFromInsert(sql: string, params: unknown[]): RaceRow {
  const match = sql.match(/INSERT INTO races\s*\(([^)]+)\)\s*VALUES/i);
-  const now = new Date().toISOString();
+  const now = new Date();
  if (!match) {
    return {
      id: String(params[0] ?? ""),
@@ -29,6 +29,7 @@ function mockRowFromInsert(sql: string, params: unknown[]): RaceRow {
      bib_pickup: null,
      bib_number: null,
      finish_time: null,
+      finish_place: null,
      notes: null,
      created_at: now,
      updated_at: null,
@@ -51,6 +52,7 @@ function mockRowFromInsert(sql: string, params: unknown[]): RaceRow {
    bib_pickup: row.bib_pickup != null ? String(row.bib_pickup) : null,
    bib_number: row.bib_number != null ? String(row.bib_number) : null,
    finish_time: row.finish_time != null ? String(row.finish_time) : null,
+    finish_place: row.finish_place != null ? String(row.finish_place) : null,
    notes: row.notes != null ? String(row.notes) : null,
    created_at: now,
    updated_at: null,
@@ -67,6 +69,8 @@ function createMockPool(): Pool {
      fields: [],
    }) as QueryResult<T>;

+  const store = new Map<string, RaceRow>();
+
  const mockQuery = async <T extends QueryResultRow>(
    text: string,
    params?: unknown[],
@@ -74,11 +78,9 @@ function createMockPool(): Pool {
    const sql = text.replace(/\s+/g, " ").trim();
    const p = params ?? [];

-    if (sql.includes("DELETE FROM races")) {
-      return emptyResult();
-    }
    if (sql.includes("INSERT INTO races") && sql.includes("RETURNING")) {
      const row = mockRowFromInsert(text, p);
+      store.set(row.id, row);
      return {
        rows: [row as unknown as T],
        rowCount: 1,
@@ -87,12 +89,49 @@ function createMockPool(): Pool {
        fields: [],
      } as QueryResult<T>;
    }
+
+    if (sql.includes("DELETE FROM races")) {
+      const id = String(p[0] ?? "");
+      const existed = store.delete(id);
+      return {
+        rows: [],
+        rowCount: existed ? 1 : 0,
+        command: "DELETE",
+        oid: 0,
+        fields: [],
+      } as QueryResult<T>;
+    }
+
    if (sql.includes("UPDATE races") && sql.includes("RETURNING")) {
+      const id = String(p[p.length - 1] ?? "");
+      const existing = store.get(id);
+      if (!existing) {
        return emptyResult();
      }
+      const updated = { ...existing, updated_at: new Date() };
+      store.set(id, updated);
+      return {
+        rows: [updated as unknown as T],
+        rowCount: 1,
+        command: "UPDATE",
+        oid: 0,
+        fields: [],
+      } as QueryResult<T>;
+    }
+
+    if (sql.includes("SELECT * FROM races WHERE id =")) {
+      const id = String(p[0] ?? "");
+      const row = store.get(id);
+      return row
+        ? { rows: [row as unknown as T], rowCount: 1, command: "SELECT", oid: 0, fields: [] } as QueryResult<T>
+        : emptyResult();
+    }
+
    if (sql.includes("SELECT * FROM races")) {
-      return emptyResult();
+      const rows = Array.from(store.values());
+      return { rows: rows as unknown as T[], rowCount: rows.length, command: "SELECT", oid: 0, fields: [] } as QueryResult<T>;
    }
+
    return emptyResult();
  };

--- a/backend/src/index.ts
+++ b/backend/src/index.ts
@@ -1,16 +1,7 @@
-import express from "express";
-import cors from "cors";
 import { config } from "./config";
-import healthRouter from "./routes/health";
-import racesRouter from "./routes/races";
+import { createApp } from "./app";

-const app = express();
-
-app.use(cors({ origin: config.corsOrigin, methods: ["GET", "POST", "PATCH", "DELETE"] }));
-app.use(express.json());
-
-app.use(healthRouter);
-app.use(racesRouter);
+const app = createApp();

 app.listen(config.apiPort, () => {
  console.log(`[api] Listening on http://localhost:${config.apiPort}`);
--- a/backend/src/mappers/race.ts
+++ b/backend/src/mappers/race.ts
@@ -1,7 +1,10 @@
-/** Row shape returned by PostgreSQL (snake_case). */
+/**
+ * Row shape returned by PostgreSQL (snake_case).
+ * pg returns DATE as string, NUMERIC as string, TIMESTAMPTZ as Date.
+ */
 export interface RaceRow {
  id: string;
-  race_date: string;
+  race_date: string | Date;
  title: string;
  distance_km: string;
  status: string | null;
@@ -11,9 +14,10 @@ export interface RaceRow {
  bib_pickup: string | null;
  bib_number: string | null;
  finish_time: string | null;
+  finish_place: string | null;
  notes: string | null;
-  created_at: string;
-  updated_at: string | null;
+  created_at: Date;
+  updated_at: Date | null;
 }

 /** API shape (camelCase). */
@@ -29,16 +33,33 @@ export interface RaceDto {
  bibPickup: string | null;
  bibNumber: string | null;
  finishTime: string | null;
+  finishPlace: string | null;
  notes: string | null;
  createdAt: string;
  updatedAt: string | null;
 }

+function toISOString(value: Date | string): string {
+  return value instanceof Date ? value.toISOString() : String(value);
+}
+
+/** DATE column may arrive as string or Date; API always exposes YYYY-MM-DD for the calendar day. */
+function raceDateToApiValue(value: string | Date): string {
+  if (typeof value === "string") {
+    const m = value.match(/^(\d{4}-\d{2}-\d{2})/);
+    return m ? m[1]! : value;
+  }
+  const y = value.getFullYear();
+  const mo = String(value.getMonth() + 1).padStart(2, "0");
+  const day = String(value.getDate()).padStart(2, "0");
+  return `${y}-${mo}-${day}`;
+}
+
 /** Convert a DB row to the API DTO (camelCase). */
 export function rowToDto(row: RaceRow): RaceDto {
  return {
    id: row.id,
-    date: row.race_date,
+    date: raceDateToApiValue(row.race_date),
    title: row.title,
    distanceKm: parseFloat(row.distance_km),
    status: row.status,
@@ -48,9 +69,10 @@ export function rowToDto(row: RaceRow): RaceDto {
    bibPickup: row.bib_pickup,
    bibNumber: row.bib_number,
    finishTime: row.finish_time,
+    finishPlace: row.finish_place,
    notes: row.notes,
-    createdAt: row.created_at,
-    updatedAt: row.updated_at,
+    createdAt: toISOString(row.created_at),
+    updatedAt: row.updated_at ? toISOString(row.updated_at) : null,
  };
 }

@@ -66,6 +88,7 @@ const FIELD_MAP: Record<string, string> = {
  bibPickup: "bib_pickup",
  bibNumber: "bib_number",
  finishTime: "finish_time",
+  finishPlace: "finish_place",
  notes: "notes",
 };

--- a/backend/src/routes/health.ts
+++ b/backend/src/routes/health.ts
@@ -1,10 +1,16 @@
 import { Router, Request, Response } from "express";
 import { checkDbConnection } from "../db";
+import { getBackendVersion } from "../version";

 const router = Router();

 router.get("/health", (_req: Request, res: Response) => {
-  res.json({ status: "ok" });
+  res.json({ status: "ok", version: getBackendVersion() });
+});
+
+/** Версия для UI; путь без «health», чтобы реже резался фильтрами/прокси. */
+router.get("/meta", (_req: Request, res: Response) => {
+  res.json({ version: getBackendVersion() });
 });

 router.get("/ready", async (_req: Request, res: Response) => {
--- a/backend/src/seed.ts
+++ b/backend/src/seed.ts
@@ -24,10 +24,24 @@ function makeId(date: string, title: string): string {
  return `${date}-${slugify(title)}`;
 }

+const CSV_NAME = "races_2026_calendar.csv";
+
+function resolveCsvPath(): string | null {
+  // Docker image: /app/dist/*.js → ../import = /app/import (matches Dockerfile COPY import ./import)
+  // Local monorepo: backend/dist/*.js → ../../import = repo root import/
+  const candidates = [
+    path.resolve(__dirname, "../import", CSV_NAME),
+    path.resolve(__dirname, "../../import", CSV_NAME),
+  ];
+  return candidates.find((p) => fs.existsSync(p)) ?? null;
+}
+
 async function seed() {
-  const csvPath = path.resolve(__dirname, "../../import/races_2026_calendar.csv");
-  if (!fs.existsSync(csvPath)) {
-    console.error(`[seed] CSV not found: ${csvPath}`);
+  const csvPath = resolveCsvPath();
+  if (!csvPath) {
+    console.error(
+      `[seed] CSV not found: ${CSV_NAME}. Tried:\n  - ${path.resolve(__dirname, "../import", CSV_NAME)}\n  - ${path.resolve(__dirname, "../../import", CSV_NAME)}`,
+    );
    process.exit(1);
  }

--- a/backend/src/version.ts
+++ b/backend/src/version.ts
@@ -0,0 +1,24 @@
+import fs from "fs";
+import path from "path";
+
+let cached: string | null = null;
+
+export function getBackendVersion(): string {
+  if (cached) {
+    return cached;
+  }
+  const fromEnv = process.env.APP_VERSION?.trim();
+  if (fromEnv) {
+    cached = fromEnv;
+    return cached;
+  }
+  try {
+    const pkgPath = path.join(__dirname, "..", "package.json");
+    const raw = fs.readFileSync(pkgPath, "utf-8");
+    cached = (JSON.parse(raw) as { version: string }).version;
+    return cached;
+  } catch {
+    cached = "0.0.0";
+    return cached;
+  }
+}
--- a/backend/test/app.test.ts
+++ b/backend/test/app.test.ts
@@ -0,0 +1,63 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import request from "supertest";
+import { createApp } from "../src/app";
+
+const app = createApp();
+
+test("GET /health returns ok", async () => {
+  const res = await request(app).get("/health").expect(200);
+  assert.equal(res.body.status, "ok");
+  assert.equal(typeof res.body.version, "string");
+  assert.ok(res.body.version.length > 0);
+});
+
+test("GET /api/health returns ok (prefix without proxy strip)", async () => {
+  const res = await request(app).get("/api/health").expect(200);
+  assert.equal(res.body.status, "ok");
+});
+
+test("GET /meta returns version for UI footer", async () => {
+  const res = await request(app).get("/meta").expect(200);
+  assert.equal(typeof res.body.version, "string");
+  assert.ok(res.body.version.length > 0);
+});
+
+test("GET /api/meta mirrors GET /meta", async () => {
+  const res = await request(app).get("/api/meta").expect(200);
+  assert.equal(typeof res.body.version, "string");
+  assert.ok(res.body.version.length > 0);
+});
+
+test("GET /ready succeeds with mock database", async () => {
+  const res = await request(app).get("/ready").expect(200);
+  assert.equal(res.body.status, "ready");
+  assert.equal(res.body.db, "connected");
+});
+
+test("GET /races rejects invalid year", async () => {
+  const res = await request(app).get("/races?year=bad").expect(400);
+  assert.equal(res.body.error, "validation_error");
+  assert.ok(Array.isArray(res.body.details));
+});
+
+test("GET /races rejects month out of range", async () => {
+  const res = await request(app).get("/races?month=13").expect(400);
+  assert.equal(res.body.error, "validation_error");
+});
+
+test("GET /races accepts year and month", async () => {
+  const res = await request(app).get("/races?year=2026&month=5").expect(200);
+  assert.ok(Array.isArray(res.body));
+});
+
+test("GET /api/races mirrors GET /races", async () => {
+  const res = await request(app).get("/api/races?year=2026&month=5").expect(200);
+  assert.ok(Array.isArray(res.body));
+});
+
+test("GET /races/:id returns not_found", async () => {
+  const res = await request(app).get("/races/does-not-exist").expect(404);
+  assert.equal(res.body.error, "not_found");
+  assert.ok(Array.isArray(res.body.details));
+});
--- a/docker-compose.stack.yml
+++ b/docker-compose.stack.yml
@@ -0,0 +1,54 @@
+# Backend + frontend в сети с уже поднятым PostgreSQL (external network).
+#
+# Подготовка: из корня репозитория скопируйте .env.example → .env и задайте DB_*
+# и CORS_ORIGIN (для фронта на :3033 — http://localhost:3033).
+#
+# Сеть (имя должно существовать, как у вашего Postgres):
+#   docker network ls
+#
+# Запуск:
+#   docker compose -f docker-compose.stack.yml up -d --build
+#
+# Миграции и seed (один раз после появления БД):
+#   docker compose -f docker-compose.stack.yml exec backend node dist/migrate.js
+#   docker compose -f docker-compose.stack.yml exec backend node dist/seed.js
+#
+# NPM: проброс на порт 3033. Браузер ходит на /api → nginx во фронте → backend:3000.
+
+services:
+  backend:
+    build:
+      context: .
+      dockerfile: Dockerfile.backend
+    container_name: runners-calendar-backend
+    env_file:
+      - .env
+    environment:
+      - PORT=3000
+    ports:
+      - "3001:3000"
+    volumes:
+      # CSV и прочие данные import/ на хосте (Synology: ./import рядом с compose) без пересборки образа
+      - ./import:/app/import:ro
+    restart: unless-stopped
+    networks:
+      - postgres_default
+
+  frontend:
+    build:
+      context: .
+      dockerfile: Dockerfile.frontend
+      args:
+        VITE_API_BASE_URL: /api
+    container_name: runners-calendar-frontend
+    depends_on:
+      - backend
+    ports:
+      - "3033:80"
+    restart: unless-stopped
+    networks:
+      - postgres_default
+
+networks:
+  postgres_default:
+    external: true
--- a/docker/nginx.frontend.conf
+++ b/docker/nginx.frontend.conf
@@ -0,0 +1,21 @@
+server {
+  listen 80;
+  server_name _;
+  root /usr/share/nginx/html;
+  index index.html;
+
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+
+  # Браузер ходит на тот же origin: /api/* → бэкенд без префикса /api
+  location /api/ {
+    rewrite ^/api/(.*) /$1 break;
+    proxy_pass http://backend:3000;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+  }
+}
--- a/docs/agent-backend-instruction.md
+++ b/docs/agent-backend-instruction.md
@@ -1,161 +0,0 @@
-# Инструкция агенту: реализация бэкенда по [PLAN.md](../PLAN.md)
-
-Документ для ИИ-агента или разработчика, который создаёт **backend** монорепозитория «календарь забегов». Продуктовые цели и модель данных — в корневом **PLAN.md**; здесь — порядок работ, ограничения и **обязательные итоговые артефакты для фронтенда**.
-
---
-
-## 0. Ограничение: нет возможности проверить подключение к БД
-
-1. **Всё равно реализовать полноценный бэкенд «как для прод»**: миграции SQL, пул подключений `pg`, переменные `DB_*`, `docker-compose.yml` с PostgreSQL в корне репозитория.
-2. **Не блокировать работу отсутствием живой БД у исполнителя:**
-   - код миграций и seed должен быть **валидным и согласованным** с PLAN;
-   - при старте API при невозможности подключиться к БД — **ясное сообщение в лог** и **корректный HTTP-ответ** на зависящих от БД маршрутах (например 503 с телом `{"error":"database_unavailable",...}`) **или** падение процесса на старте с понятной ошибкой (выбрать одну стратегию и описать её в `docs/backend.md`).
-3. **Не выдумывать обход БД** (in-memory «режим без Postgres»), если это не согласовано отдельно — фронт и план рассчитаны на PostgreSQL.
-4. Автотесты, требующие Docker/Postgres, помечать как **опциональные** или давать инструкцию «как прогнать локально», не считая провал из-за отсутствия БД у агента блокером для merge кода.
-
---
-
-## 1. Ветка и расположение в репо
-
- Если репозиторий под git: создать ветку `feature/backend-api` (или аналог по соглашению команды).
- Каталог **`backend/`** в корне проекта рядом с будущим `frontend/`.
- Корневой **`docker-compose.yml`** — сервис `postgres` (порт, пользователь, БД, пароль — согласовать с `.env.example`).
-
---
-
-## 2. Порядок реализации (обязательный)
-
-### Шаг A. Каркас
-
- Node **LTS**, **TypeScript**, **`backend/package.json`**.
- Фреймворк: **Fastify** или **Express** (выбрать один, не смешивать).
- Загрузка env: `dotenv` или встроенные средства; **валидация** наличия `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASSWORD` при старте (или при первом запросе к БД — но тогда задокументировать).
- Сервер слушает порт из **`PORT`** или **`API_PORT`** (значение по умолчанию, напр. `3001`, указать в `.env.example`).
-
-### Шаг B. CORS
-
- Читать **`CORS_ORIGIN`** (например `http://localhost:5173` для Vite в dev). В prod — origin фронта.
- Разрешить методы и заголовки, нужные для `GET/POST/PATCH` + `Content-Type: application/json`.
-
-### Шаг C. Миграции
-
- Каталог миграций, напр. `backend/migrations/` с нумерованными SQL-файлами **или** один миграционный runner (node-pg-migrate, graphile-migrate, собственный скрипт — на выбор, зафиксировать в `docs/backend.md`).
- Первая миграция: таблица **`races`** со столбцами, соответствующими PLAN (см. раздел 3 ниже).
- Команда **`npm run db:migrate`** (или эквивалент в `backend/`) — идемпотентное накатывание на чистую БД.
-
-### Шаг D. Доступ к данным
-
- Клиент **`pg`**: `Pool` с параметрами из `DB_*`.
- Слой репозитория или прямые запросы в обработчиках — на усмотрение, без лишних абстракций сверх задачи.
-
-### Шаг E. HTTP API
-
-Реализовать минимум:
-
-| Метод | Путь | Назначение |
-|--------|------|------------|
-| `GET` | `/health` | Liveness: процесс жив; **не обязан** проверять БД (или опционально — задокументировать). |
-| `GET` | `/ready` (опционально) | Readiness: проверка соединения с БД — полезно для оркестраторов. |
-| `GET` | `/races` | Список забегов; **query**: `year`, `month` (1–12) — фильтрация для экранов календаря; без параметров — все строки или разумный лимит + документация пагинации если добавите позже. |
-| `GET` | `/races/:id` | Одна запись по `id`. |
-| `POST` | `/races` | Создание; тело JSON в **camelCase** как в PLAN. |
-| `PATCH` | `/races/:id` | Частичное обновление; только переданные поля. |
-| `DELETE` | `/races/:id` | Опционально по PLAN; если не нужен фронту — можно не делать, но тогда явно написать в документации «удаление не поддерживается». |
-
-**Ошибки:**
-
- 400 — валидация тела/параметров.
- 404 — нет `id`.
- 409 — конфликт уникального `id` при POST (если клиент прислал уже существующий).
- 503 или 500 — недоступна БД (согласовать с разделом 0).
-
-Формат ошибки: JSON, единообразно, напр. `{"error":"validation_error","details":[...]}`.
-
-### Шаг F. Seed (разовый скрипт)
-
- Команда **`npm run seed`** в `backend/` (или корне монорепо с `workspace` — единообразно).
- Читает **`import/races_2026_calendar.csv`** (путь от корня репо); парсинг с учётом кавычек в поле названия.
- Генерирует **`id`** стабильно: например `{date}-{slug-from-title}`; при коллизии — суффикс или upsert по `id`.
- **`INSERT ... ON CONFLICT (id) DO UPDATE`** (upsert) — удобно для повторного запуска seed.
- Seed **не** вызывается из HTTP handlers.
-
-### Шаг G. Корневой `.env.example`
-
- Все переменные: `DB_*`, `PORT`/`API_PORT`, `CORS_ORIGIN`.
- **Без** реальных паролей; комментарии к каждой переменной.
-
---
-
-## 3. Соответствие полей PLAN ↔ SQL ↔ JSON API
-
-**В JSON API (запрос/ответ)** — **camelCase**, как в PLAN:
-
-`id`, `date`, `title`, `distanceKm`, `status`, `officialUrl`, `startTime`, `clusterSchedule`, `bibPickup`, `bibNumber`, `finishTime`, `notes`.
-
-**В PostgreSQL** — **snake_case**, например:
-
-| SQL column | Тип (рекомендация) |
-|------------|---------------------|
-| `id` | `TEXT` PRIMARY KEY |
-| `race_date` | `DATE` |
-| `title` | `TEXT` |
-| `distance_km` | `NUMERIC(6,3)` |
-| `status` | `TEXT` CHECK (опционально) |
-| `official_url` | `TEXT` |
-| `start_time` | `TEXT` |
-| `cluster_schedule` | `TEXT` |
-| `bib_pickup` | `TEXT` |
-| `bib_number` | `TEXT` |
-| `finish_time` | `TEXT` |
-| `notes` | `TEXT` |
-| `created_at` | `TIMESTAMPTZ` DEFAULT now() |
-| `updated_at` | `TIMESTAMPTZ` |
-
-Маппинг **строго** в одном модуле (например `backend/src/mappers/race.ts`), чтобы фронт всегда видел camelCase.
-
-**Типы `date`:** в API строка `YYYY-MM-DD`. **`distanceKm`:** число. **`finishTime`:** строка времени как в PLAN; бэкенд **не обязан** парсить для бизнес-логики (PR считает фронт), но может валидировать формат по желанию.
-
---
-
-## 4. Обязательный итог для упрощения фронтенда
-
-После того как код бэкенда готов, агент **обязан** добавить в репозиторий документ:
-
-### Файл: `docs/backend-api-for-frontend.md`
-
-В нём **кратко и без пробелов в фактах**:
-
-1. **Base URL** — что подставлять во фронт (`VITE_API_BASE_URL`), пример для dev.
-2. **CORS** — какой `CORS_ORIGIN` ожидается в dev.
-3. **Таблица эндпоинтов** — метод, путь, query, тело запроса (пример JSON), пример успешного ответа, коды ошибок.
-4. **Модель `Race`** — перечень полей в **camelCase** с типами и обязательностью для POST vs PATCH.
-5. **Фильтр списка** — как именно работают `year` и `month` на `GET /races` (включая границы: пустой месяц, только год и т.д.).
-6. **Идемпотентность seed** — одна фраза: upsert по `id`, откуда берётся CSV.
-7. **Поведение при недоступной БД** — что возвращает API / что в логах (как в реализации).
-
-Дополнительно можно дублировать суть в **`docs/backend.md`** (общая эксплуатация: docker, migrate, seed, запуск), но **`backend-api-for-frontend.md`** — главная «шпаргалка» для разработчика SPA.
-
---
-
-## 5. Критерии готовности (чеклист агента)
-
- [ ] `docker-compose.yml` поднимает Postgres с параметрами, совместимыми с `.env.example`.
- [ ] Миграция создаёт `races`; есть команда миграции.
- [ ] Реализованы `GET /races`, `GET /races/:id`, `POST /races`, `PATCH /races/:id` согласно PLAN.
- [ ] Реализован seed из `import/races_2026_calendar.csv`.
- [ ] `GET /health` (и при наличии `/ready` — описано).
- [ ] Корневой `.env.example` обновлён.
- [ ] Написан **`docs/backend-api-for-frontend.md`** (раздел 4).
- [ ] `docs/backend.md` содержит команды: установка зависимостей, migrate, seed, `npm run dev` для API.
-
---
-
-## 6. Не входит в объём бэкенда (напоминание)
-
- Авторизация, пользователи, сессии.
- Парсинг сайтов организаторов.
- Отдача статики фронта с того же процесса (фронт — отдельно Vite/build).
-
---
-
-*Конец инструкции. Источник требований к продукту — всегда [PLAN.md](../PLAN.md).*
--- a/docs/agent-fix-backend-sync-instruction.md
+++ b/docs/agent-fix-backend-sync-instruction.md
@@ -1,77 +0,0 @@
-# Инструкция агенту: устранение рассинхронизации backend с планом/контрактом
-
-Документ описывает, как выполнить план исправлений **только через изменения кода** (без правок существующей документации в `docs/`).
-
-## 1) Ветка и границы задачи
-
- Создать отдельную ветку по best practice, например: `fix/backend-api-validation-and-runtime-sync`.
- Не менять существующие файлы документации в `docs/` как способ "починить" замечания.
- Исправления вносятся в runtime-код и обязательные артефакты репозитория.
-
-## 2) Обязательные изменения в коде
-
-### A. Строгая валидация `GET /races`
-
-Файл: `backend/src/routes/races.ts`
-
- Добавить явную проверку `year`:
-  - целое число;
-  - при невалидном значении вернуть `400`:
-    - `{"error":"validation_error","details":[...]}`
- Добавить явную проверку `month`:
-  - целое число в диапазоне `1..12`;
-  - при невалидном значении вернуть `400` в том же формате.
- Исключить передачу `NaN`/некорректных значений в SQL-параметры.
-
-### B. Разделение ошибок валидации и ошибок БД
-
-Файл: `backend/src/routes/races.ts`
-
- `400` использовать только для ошибок входа (query/body/params).
- `503 {"error":"database_unavailable"}` использовать только для технической недоступности БД.
- Сохранить единый JSON-формат ошибок во всех CRUD-маршрутах.
-
-### C. Выравнивание конфигурации порта
-
-Файл: `backend/src/config.ts`
-
- Поддержать оба env-подхода:
-  - приоритет `PORT`,
-  - затем `API_PORT`,
-  - затем fallback `3001`.
-
-### D. Обязательный root-артефакт
-
-Файл: `README.md` (в корне)
-
- Создать базовый `README.md` с:
-  - кратким описанием проекта,
-  - минимальным quick start,
-  - ссылками на текущие документы backend/API.
-
-## 3) Допустимая реорганизация кода
-
- Можно добавить небольшие локальные helper-функции в `backend/src/routes/races.ts`.
- При необходимости можно вынести общие mapper/validator-хелперы в `backend/src/mappers/race.ts`, если это уменьшает дублирование.
- Не усложнять архитектуру: только то, что нужно для контракта и устойчивого поведения API.
-
-## 4) Проверка результата
-
-Минимум выполнить:
-
-1. `npm run build` в `backend/` (типизация/сборка).
-2. Проверка диагностики/линтов по измененным backend-файлам.
-3. Smoke-сценарии API:
-   - `GET /health` -> `200`,
-   - `GET /ready` -> `200` при доступной БД или `503` при недоступной,
-   - `GET /races?year=bad` -> `400`,
-   - `GET /races?month=13` -> `400`,
-   - `GET /races?year=2026&month=5` -> корректный `200` и данные/пустой массив.
-
-## 5) Критерии готовности (Definition of Done)
-
- Контракт валидации `GET /races` соблюден в runtime.
- Валидационные ошибки не маскируются под `database_unavailable`.
- Конфиг порта поддерживает `PORT` и `API_PORT` с правильным приоритетом.
- В репозитории есть корневой `README.md`.
- Никакие существующие документы в `docs/` не менялись для "закрытия" замечаний.
--- a/docs/backend-api-for-frontend.md
+++ b/docs/backend-api-for-frontend.md
@@ -8,6 +8,8 @@ VITE_API_BASE_URL=http://localhost:3001

 В коде SPA: `import.meta.env.VITE_API_BASE_URL`.

+В Docker-стеке из репозитория образ фронта собирается с **`VITE_API_BASE_URL=/api`**: запросы идут на тот же origin, nginx проксирует `/api` на backend (см. `docker/nginx.frontend.conf`).
+
 ## 2. CORS

 В dev-режиме бэкенд ожидает переменную:
@@ -87,6 +89,7 @@ GET /races?year=2026&month=5
    "bibPickup": null,
    "bibNumber": null,
    "finishTime": null,
+    "finishPlace": null,
    "notes": null,
    "createdAt": "2026-03-31T12:00:00.000Z",
    "updatedAt": null
@@ -102,10 +105,10 @@ GET /races?year=2026&month=5

 **Ответ 200:** объект `Race` (см. модель ниже).

-**Ответ 404:**
+**Ответ 404:** тело JSON, поле `details` — массив пояснений (можно показывать в UI или игнорировать).

 ```json
-{ "error": "not_found" }
+{ "error": "not_found", "details": ["Race not found"] }
 ```

 ---
@@ -129,6 +132,7 @@ GET /races?year=2026&month=5
  "bibPickup": null,
  "bibNumber": null,
  "finishTime": null,
+  "finishPlace": null,
  "notes": null
 }
 ```
@@ -160,12 +164,13 @@ GET /races?year=2026&month=5
 ```json
 {
  "finishTime": "1:45:30",
+  "finishPlace": "12/340",
  "bibNumber": "1234",
  "status": "completed"
 }
 ```

-**Допустимые поля:** `date`, `title`, `distanceKm`, `status`, `officialUrl`, `startTime`, `clusterSchedule`, `bibPickup`, `bibNumber`, `finishTime`, `notes`.
+**Допустимые поля:** `date`, `title`, `distanceKm`, `status`, `officialUrl`, `startTime`, `clusterSchedule`, `bibPickup`, `bibNumber`, `finishTime`, `finishPlace`, `notes`.

 **Ответ 200:** обновлённый объект `Race`.

@@ -178,7 +183,7 @@ GET /races?year=2026&month=5
 **Ответ 404:**

 ```json
-{ "error": "not_found" }
+{ "error": "not_found", "details": ["Race not found"] }
 ```

 ---
@@ -192,7 +197,7 @@ GET /races?year=2026&month=5
 **Ответ 404:**

 ```json
-{ "error": "not_found" }
+{ "error": "not_found", "details": ["Race not found"] }
 ```

 ## 4. Модель `Race` (camelCase)
@@ -203,13 +208,14 @@ GET /races?year=2026&month=5
 | `date` | string | да | да | `YYYY-MM-DD` |
 | `title` | string | да | да | Название забега |
 | `distanceKm` | number | да | да | Дистанция в км |
-| `status` | string \| null | нет | да | `"planned"` / `"completed"` |
+| `status` | string \| null | нет | да | `"planned"` / `"registered"` / `"completed"` |
 | `officialUrl` | string \| null | нет | да | URL организатора |
 | `startTime` | string \| null | нет | да | Время старта, напр. `"09:30"` |
 | `clusterSchedule` | string \| null | нет | да | Расписание кластеров |
 | `bibPickup` | string \| null | нет | да | Выдача номеров |
 | `bibNumber` | string \| null | нет | да | Стартовый номер |
-| `finishTime` | string \| null | нет | да | Финишное время `H:MM:SS` |
+| `finishTime` | string \| null | нет | да | Финишное время `H:MM:SS` или `MM:SS` |
+| `finishPlace` | string \| null | нет | да | Место на финише (произвольная строка) |
 | `notes` | string \| null | нет | да | Заметки |
 | `createdAt` | string | — | — | ISO timestamp (read-only) |
 | `updatedAt` | string \| null | — | — | ISO timestamp (read-only) |
@@ -229,6 +235,6 @@ Seed-скрипт (`npm run seed` в `backend/`) выполняет **upsert**
 ## 7. Поведение при недоступной БД

 - `GET /health` — всегда `200` (не проверяет БД).
- `GET /ready` — `503 { "error": "database_unavailable", "db": "disconnected" }`.
+- `GET /ready` — при недоступной БД: `503 { "error": "database_unavailable", "db": "disconnected" }`. В режиме **`CALENDAR_RUN_MOCK_DB`** (dev/CI без Postgres) readiness возвращает успех без реального подключения — см. `docs/backend.md`.
 - Все остальные маршруты — `503 { "error": "database_unavailable" }`.
 - В логах сервера: строка ошибки с контекстом маршрута.
--- a/docs/backend.md
+++ b/docs/backend.md
@@ -62,27 +62,33 @@ npm run build    # компиляция в dist/
 npm start        # запуск из dist/
 ```

-API слушает порт из `API_PORT` (по умолчанию `3001`).
+API слушает порт: **`PORT`** (если задан), иначе **`API_PORT`**, иначе **`3001`**.

 ## Переменные окружения

 | Переменная | Описание | По умолчанию |
 |---|---|---|
-| `DB_HOST` | Хост PostgreSQL | — (обязательна) |
-| `DB_PORT` | Порт PostgreSQL | — (обязательна) |
-| `DB_NAME` | Имя базы данных | — (обязательна) |
-| `DB_USER` | Пользователь БД | — (обязательна) |
-| `DB_PASSWORD` | Пароль БД | — (обязательна) |
+| `DB_HOST` | Хост PostgreSQL | — (обязательна без mock, см. ниже) |
+| `DB_PORT` | Порт PostgreSQL | — (обязательна без mock) |
+| `DB_NAME` | Имя базы данных | — (обязательна без mock) |
+| `DB_USER` | Пользователь БД | — (обязательна без mock) |
+| `DB_PASSWORD` | Пароль БД | — (обязательна без mock) |
+| `CALENDAR_RUN_MOCK_DB` | `1` или `true` — режим без PostgreSQL для HTTP API (dev/CI) | выкл. |
+| `PORT` | Порт API (приоритетнее `API_PORT`) | — |
 | `API_PORT` | Порт API-сервера | `3001` |
 | `CORS_ORIGIN` | Разрешённый origin для CORS | `http://localhost:5173` |

-При отсутствии любой из `DB_*` процесс падает при старте с сообщением `Missing required environment variable: <NAME>`.
+Для локального Vite в корневом `.env.example` также указан **`VITE_API_BASE_URL`** (читает только фронт из `frontend/`). В Docker-стеке базовый URL API задаётся при **сборке** образа фронта (`/api`), не через этот файл.
+
+**Без mock:** при отсутствии любой из `DB_*` процесс падает при старте: `Missing required environment variable: <NAME>`.
+
+**С `CALENDAR_RUN_MOCK_DB=1`:** переменные `DB_*` не обязательны; реальный пул не поднимается. **Не использовать** mock для `npm run db:migrate` и `npm run seed` — нужен настоящий Postgres и корректные `DB_*`.

 ## Поведение при недоступной БД

 - **Старт сервера** — проходит успешно (env валидирован, Express слушает порт).
 - **`GET /health`** — всегда `200 { "status": "ok" }` (liveness, без обращения к БД).
- **`GET /ready`** — пробует подключиться к БД; возвращает `200` если ОК, `503 { "error": "database_unavailable" }` если нет.
+- **`GET /ready`** — при обычном режиме пробует подключиться к БД; `200` если ОК, `503 { "error": "database_unavailable", ... }` если нет. В режиме **`CALENDAR_RUN_MOCK_DB`** readiness считается успешным без реального подключения (удобно для CI/smoke API).
 - **Все остальные маршруты** при ошибке БД возвращают `503 { "error": "database_unavailable" }`.

 ## Структура каталога
@@ -90,11 +96,13 @@ API слушает порт из `API_PORT` (по умолчанию `3001`).
 ```
 backend/
 ├── migrations/
-│   └── 001_create_races.sql
+│   ├── 001_create_races.sql
+│   └── 002_finish_place_and_registered_status.sql
 ├── src/
+│   ├── app.ts             # фабрика Express (тесты)
 │   ├── config.ts          # загрузка и валидация env
-│   ├── db.ts              # pg Pool
-│   ├── index.ts           # точка входа Express
+│   ├── db.ts              # pg Pool или mock
+│   ├── index.ts           # запуск сервера
 │   ├── migrate.ts         # раннер миграций
 │   ├── seed.ts            # разовый импорт CSV
 │   ├── mappers/
@@ -105,3 +113,9 @@ backend/
 ├── package.json
 └── tsconfig.json
 ```
+
+## Docker: стек backend + frontend
+
+Файл [`docker-compose.stack.yml`](../docker-compose.stack.yml) поднимает API и nginx со статикой SPA в **внешней** сети Docker (рядом с уже запущенным Postgres). Переменные — в **корневом** `.env` (шаблон [`.env.example`](../.env.example)): как минимум `DB_*`, `CORS_ORIGIN` (для выдачи фронта на порту 3033 задайте `http://localhost:3033`). Перед первым `up` файл `.env` должен существовать.
+
+Порядок после старта контейнеров: `node dist/migrate.js` и `node dist/seed.js` внутри контейнера `backend` (см. комментарии в compose-файле).
--- a/frontend/.env.example
+++ b/frontend/.env.example
@@ -0,0 +1,2 @@
+# Для локального npm run dev. Полный список переменных — в корневом .env.example репозитория.
+VITE_API_BASE_URL=http://localhost:3001
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -1,9 +1,9 @@
 <!doctype html>
-<html lang="en">
+<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Calendar Run</title>
+    <title>Календарь стартов</title>
  </head>
  <body>
    <div id="root"></div>
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -52,7 +52,6 @@
      "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@babel/code-frame": "^7.29.0",
        "@babel/generator": "^7.29.0",
@@ -1169,7 +1168,6 @@
      "integrity": "sha512-wGdMcf+vPYM6jikpS/qhg6WiqSV/OhG+jeeHT/KlVqxYfD40iYJf9/AE1uQxVWFvU7MipKRkRv8NSHiCGgPr8Q==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "undici-types": "~6.21.0"
      }
@@ -1187,7 +1185,6 @@
      "integrity": "sha512-z9VXpC7MWrhfWipitjNdgCauoMLRdIILQsAEV+ZesIzBq/oUlxk0m3ApZuMFCXdnS4U7KrI+l3WRUEGQ8K1QKw==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@types/prop-types": "*",
        "csstype": "^3.2.2"
@@ -1257,7 +1254,6 @@
        }
      ],
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "baseline-browser-mapping": "^2.10.12",
        "caniuse-lite": "^1.0.30001782",
@@ -1534,7 +1530,6 @@
      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "loose-envify": "^1.1.0"
      },
@@ -1547,7 +1542,6 @@
      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
      "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "loose-envify": "^1.1.0",
        "scheduler": "^0.23.2"
@@ -1730,7 +1724,6 @@
      "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "esbuild": "^0.21.3",
        "postcss": "^8.4.43",
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,7 +1,7 @@
 {
  "name": "calendar-run-frontend",
  "private": true,
-  "version": "0.1.0",
+  "version": "0.2.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
--- a/frontend/src/api/errors.ts
+++ b/frontend/src/api/errors.ts
@@ -35,14 +35,45 @@ function normalizeApiCode(value: string | undefined): ApiErrorCode {
    value === "validation_error" ||
    value === "not_found" ||
    value === "database_unavailable" ||
-    value === "conflict"
+    value === "conflict" ||
+    value === "unknown_error"
  ) {
    return value;
  }
  return "unknown_error";
 }

+function isGatewayStatus(status: number): boolean {
+  return status === 502 || status === 503 || status === 504;
+}
+
+function hasStructuredApiError(payload: unknown): payload is ApiErrorPayload {
+  if (payload === null || typeof payload !== "object" || Array.isArray(payload)) {
+    return false;
+  }
+  return typeof (payload as ApiErrorPayload).error === "string";
+}
+
 export function toApiError(status: number, payload: unknown): ApiError {
+  if (isGatewayStatus(status) && !hasStructuredApiError(payload)) {
+    return new ApiError({
+      code: "network_error",
+      status,
+      message: "Сервер временно недоступен. Попробуйте обновить страницу.",
+    });
+  }
+
+  if (!hasStructuredApiError(payload) && (status === 401 || status === 403 || status === 404)) {
+    return new ApiError({
+      code: "network_error",
+      status,
+      message:
+        status === 404
+          ? "API не найден по этому адресу. Проверьте прокси и префикс /api."
+          : "Запрос отклонён сервером. Проверьте переменную CORS_ORIGIN на бэкенде.",
+    });
+  }
+
  const maybePayload = payload as ApiErrorPayload;
  const code = normalizeApiCode(maybePayload?.error);
  const details = Array.isArray(maybePayload?.details)
@@ -69,6 +100,8 @@ export function getApiErrorMessage(code: ApiErrorCode): string {
      return "Запись с таким идентификатором уже существует.";
    case "network_error":
      return "Не удалось связаться с сервером.";
+    case "unknown_error":
+      return "Сервер не смог обработать запрос. Попробуйте позже или обновите страницу.";
    default:
      return "Произошла неизвестная ошибка.";
  }
--- a/frontend/src/api/health.ts
+++ b/frontend/src/api/health.ts
@@ -0,0 +1,19 @@
+import { requestJson } from "./http";
+
+export type HealthResponse = {
+  status: string;
+  version: string;
+};
+
+export type BackendMetaResponse = {
+  version: string;
+};
+
+export async function getHealth(init?: RequestInit): Promise<HealthResponse> {
+  return requestJson<HealthResponse>("/health", init);
+}
+
+/** Версия бэкенда для футера (отдельный путь от /health — меньше ложных блокировок). */
+export async function getBackendMeta(init?: RequestInit): Promise<BackendMetaResponse> {
+  return requestJson<BackendMetaResponse>("/meta", init);
+}
--- a/frontend/src/api/http.ts
+++ b/frontend/src/api/http.ts
@@ -8,24 +8,56 @@ function buildUrl(path: string): string {
 }

 async function parseResponseBody(response: Response): Promise<unknown> {
-  const contentType = response.headers.get("content-type") ?? "";
-  if (!contentType.includes("application/json")) {
+  const text = await response.text();
+  if (!text.trim()) {
    return null;
  }

+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
    try {
-    return await response.json();
+      return JSON.parse(text) as unknown;
    } catch {
      return null;
    }
+  }
+
+  const trimmed = text.trim();
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    try {
+      return JSON.parse(text) as unknown;
+    } catch {
+      return null;
+    }
+  }
+
+  return null;
+}
+
+const GATEWAY_RETRY_STATUSES = new Set([502, 503, 504]);
+
+function delay(ms: number): Promise<void> {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
 }

 export async function requestJson<T>(path: string, init?: RequestInit): Promise<T> {
+  const method = (init?.method ?? "GET").toUpperCase();
+  const idempotent = method === "GET" || method === "HEAD";
+  const maxAttempts = idempotent ? 3 : 1;
+
+  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
    try {
+      const defaultHeaders: Record<string, string> = {};
+      if (method !== "GET" && method !== "HEAD") {
+        defaultHeaders["Content-Type"] = "application/json";
+      }
+
      const response = await fetch(buildUrl(path), {
        ...init,
        headers: {
-        "Content-Type": "application/json",
+          ...defaultHeaders,
          ...(init?.headers ?? {}),
        },
      });
@@ -37,6 +69,11 @@ export async function requestJson<T>(path: string, init?: RequestInit): Promise<
      const payload = await parseResponseBody(response);

      if (!response.ok) {
+        const retryable = idempotent && GATEWAY_RETRY_STATUSES.has(response.status) && attempt < maxAttempts;
+        if (retryable) {
+          await delay(80 * attempt);
+          continue;
+        }
        throw toApiError(response.status, payload);
      }

@@ -45,11 +82,25 @@ export async function requestJson<T>(path: string, init?: RequestInit): Promise<
      if (error instanceof ApiError) {
        throw error;
      }
-
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw error;
+      }
+      const retryable = idempotent && attempt < maxAttempts;
+      if (retryable) {
+        await delay(80 * attempt);
+        continue;
+      }
      throw new ApiError({
        code: "network_error",
        status: null,
        message: "Не удалось связаться с сервером.",
      });
    }
+  }
+
+  throw new ApiError({
+    code: "network_error",
+    status: null,
+    message: "Не удалось связаться с сервером.",
+  });
 }
--- a/frontend/src/api/index.ts
+++ b/frontend/src/api/index.ts
@@ -1,3 +1,5 @@
 export type { CreateRacePayload, Race, RacesQuery, RaceStatus, UpdateRacePayload } from "./types";
 export { ApiError, getApiErrorMessage } from "./errors";
+export type { BackendMetaResponse, HealthResponse } from "./health";
+export { getBackendMeta, getHealth } from "./health";
 export { getRaceById, getRaces, createRace, updateRace, deleteRace } from "./races";
--- a/frontend/src/api/races.ts
+++ b/frontend/src/api/races.ts
@@ -18,13 +18,17 @@ function normalizeRace(input: unknown): Race {
    isString(race?.date) &&
    isString(race?.title) &&
    typeof race?.distanceKm === "number" &&
-    (race?.status === null || race?.status === "planned" || race?.status === "completed") &&
+    (race?.status === null ||
+      race?.status === "planned" ||
+      race?.status === "registered" ||
+      race?.status === "completed") &&
    isNullableString(race?.officialUrl) &&
    isNullableString(race?.startTime) &&
    isNullableString(race?.clusterSchedule) &&
    isNullableString(race?.bibPickup) &&
    isNullableString(race?.bibNumber) &&
    isNullableString(race?.finishTime) &&
+    isNullableString(race?.finishPlace) &&
    isNullableString(race?.notes) &&
    isString(race?.createdAt) &&
    (race?.updatedAt === null || isString(race?.updatedAt));
@@ -49,6 +53,7 @@ function normalizeRace(input: unknown): Race {
    bibPickup: race.bibPickup,
    bibNumber: race.bibNumber,
    finishTime: race.finishTime,
+    finishPlace: race.finishPlace,
    notes: race.notes,
    createdAt: race.createdAt,
    updatedAt: race.updatedAt,
@@ -72,8 +77,8 @@ function buildRacesQuery(query?: RacesQuery): string {
  return serialized ? `?${serialized}` : "";
 }

-export async function getRaces(query?: RacesQuery): Promise<Race[]> {
-  const response = await requestJson<unknown[]>(`/races${buildRacesQuery(query)}`);
+export async function getRaces(query?: RacesQuery, init?: RequestInit): Promise<Race[]> {
+  const response = await requestJson<unknown[]>(`/races${buildRacesQuery(query)}`, init);
  if (!Array.isArray(response)) {
    throw new ApiError({
      code: "unknown_error",
@@ -85,8 +90,8 @@ export async function getRaces(query?: RacesQuery): Promise<Race[]> {
  return response.map(normalizeRace);
 }

-export async function getRaceById(id: string): Promise<Race> {
-  return normalizeRace(await requestJson<unknown>(`/races/${id}`));
+export async function getRaceById(id: string, init?: RequestInit): Promise<Race> {
+  return normalizeRace(await requestJson<unknown>(`/races/${id}`, init));
 }

 export async function createRace(payload: CreateRacePayload): Promise<Race> {
--- a/frontend/src/api/types.ts
+++ b/frontend/src/api/types.ts
@@ -1,4 +1,4 @@
-export type RaceStatus = "planned" | "completed";
+export type RaceStatus = "planned" | "registered" | "completed";

 export interface Race {
  id: string;
@@ -12,6 +12,7 @@ export interface Race {
  bibPickup: string | null;
  bibNumber: string | null;
  finishTime: string | null;
+  finishPlace: string | null;
  notes: string | null;
  createdAt: string;
  updatedAt: string | null;
@@ -34,6 +35,7 @@ export interface CreateRacePayload {
  bibPickup?: string | null;
  bibNumber?: string | null;
  finishTime?: string | null;
+  finishPlace?: string | null;
  notes?: string | null;
 }

--- a/frontend/src/app/layouts/AppLayout.tsx
+++ b/frontend/src/app/layouts/AppLayout.tsx
@@ -1,11 +1,12 @@
 import { NavLink, Outlet } from "react-router-dom";
+import { AppShellFooter } from "./AppShellFooter";

 export function AppLayout(): JSX.Element {
  return (
    <div className="app-shell">
      <header className="app-shell__header">
-        <div className="app-shell__brand">Calendar Run</div>
-        <nav className="app-shell__nav" aria-label="Primary navigation">
+        <div className="app-shell__brand">Календарь стартов</div>
+        <nav className="app-shell__nav" aria-label="Основная навигация">
          <NavLink
            to="/"
            end
@@ -13,7 +14,7 @@ export function AppLayout(): JSX.Element {
              isActive ? "app-shell__link app-shell__link--active" : "app-shell__link"
            }
          >
-            Dashboard
+            Обзор
          </NavLink>
          <NavLink
            to="/races"
@@ -21,13 +22,22 @@ export function AppLayout(): JSX.Element {
              isActive ? "app-shell__link app-shell__link--active" : "app-shell__link"
            }
          >
-            Races
+            Старты
+          </NavLink>
+          <NavLink
+            to="/races/new"
+            className={({ isActive }) =>
+              isActive ? "app-shell__link app-shell__link--active" : "app-shell__link"
+            }
+          >
+            + Добавить
          </NavLink>
        </nav>
      </header>
      <main className="app-shell__main">
        <Outlet />
      </main>
+      <AppShellFooter />
    </div>
  );
 }
--- a/frontend/src/app/layouts/AppShellFooter.tsx
+++ b/frontend/src/app/layouts/AppShellFooter.tsx
@@ -0,0 +1,47 @@
+import { useEffect, useState } from "react";
+import { getBackendMeta } from "../../api";
+import { FRONTEND_VERSION } from "../../frontendVersion";
+
+function isAbortError(error: unknown): boolean {
+  return (
+    (error instanceof DOMException && error.name === "AbortError") ||
+    (error instanceof Error && error.name === "AbortError")
+  );
+}
+
+export function AppShellFooter(): JSX.Element {
+  const [backendVersion, setBackendVersion] = useState<string | null>(null);
+
+  useEffect(() => {
+    const ac = new AbortController();
+    void getBackendMeta({ signal: ac.signal })
+      .then((meta) => {
+        if (ac.signal.aborted) {
+          return;
+        }
+        const v = meta.version;
+        setBackendVersion(typeof v === "string" && v.length > 0 ? v : "не указана");
+      })
+      .catch((err) => {
+        if (ac.signal.aborted || isAbortError(err)) {
+          return;
+        }
+        setBackendVersion("недоступна");
+      });
+    return () => ac.abort();
+  }, []);
+
+  const backendLabel = backendVersion === null ? "…" : backendVersion;
+
+  return (
+    <footer className="app-shell__footer">
+      <p className="app-shell__footer-versions">
+        Версия клиента: {FRONTEND_VERSION}
+        <span className="app-shell__footer-sep" aria-hidden="true">
+          {" · "}
+        </span>
+        Версия сервера: {backendLabel}
+      </p>
+    </footer>
+  );
+}
--- a/frontend/src/app/router.tsx
+++ b/frontend/src/app/router.tsx
@@ -3,6 +3,7 @@ import { AppLayout } from "./layouts/AppLayout";
 import { DashboardPage } from "../pages/DashboardPage";
 import { RacesPage } from "../pages/RacesPage";
 import { RaceDetailsPage } from "../pages/RaceDetailsPage";
+import { RaceFormPage } from "../pages/RaceFormPage";

 export const appRouter = createBrowserRouter([
  {
@@ -11,7 +12,9 @@ export const appRouter = createBrowserRouter([
    children: [
      { index: true, element: <DashboardPage /> },
      { path: "races", element: <RacesPage /> },
+      { path: "races/new", element: <RaceFormPage /> },
      { path: "races/:raceId", element: <RaceDetailsPage /> },
+      { path: "races/:raceId/edit", element: <RaceFormPage /> },
    ],
  },
 ]);
--- a/frontend/src/components/PaceTrendChart.tsx
+++ b/frontend/src/components/PaceTrendChart.tsx
@@ -0,0 +1,70 @@
+import type { Race } from "../api";
+import { formatRaceDate, isCloseDistance, parseFinishTimeToSeconds, parseRaceDate } from "../lib";
+
+type PaceTrendChartProps = {
+  races: Race[];
+  distanceKm: number;
+};
+
+/** Линейный график: время финиша (минуты) по завершённым стартам выбранной дистанции. */
+export function PaceTrendChart(props: PaceTrendChartProps): JSX.Element {
+  const { races, distanceKm } = props;
+
+  const series = races
+    .filter(
+      (race) =>
+        race.status === "completed" &&
+        isCloseDistance(race.distanceKm, distanceKm) &&
+        parseFinishTimeToSeconds(race.finishTime) != null,
+    )
+    .sort(
+      (a, b) => parseRaceDate(a.date).getTime() - parseRaceDate(b.date).getTime(),
+    )
+    .map((race) => {
+      const seconds = parseFinishTimeToSeconds(race.finishTime)!;
+      return { race, minutes: seconds / 60 };
+    });
+
+  if (series.length < 2) {
+    return (
+      <p className="pace-chart__empty">
+        Нужно минимум два завершённых старта с временем на выбранной дистанции.
+      </p>
+    );
+  }
+
+  const minutes = series.map((s) => s.minutes);
+  const minM = Math.min(...minutes);
+  const maxM = Math.max(...minutes);
+  const range = maxM - minM || 1;
+  const n = series.length;
+
+  const pad = 4;
+  const w = 100;
+  const h = 36;
+  const innerW = w - pad * 2;
+  const innerH = h - pad * 2;
+
+  const points = series
+    .map((s, i) => {
+      const x = pad + (n === 1 ? innerW / 2 : (i / (n - 1)) * innerW);
+      const norm = (maxM - s.minutes) / range;
+      const y = pad + (1 - norm) * innerH;
+      return `${x},${y}`;
+    })
+    .join(" ");
+
+  const last = series[series.length - 1]!;
+
+  return (
+    <div className="pace-chart">
+      <svg className="pace-chart__svg" viewBox={`0 0 ${w} ${h}`} role="img" aria-label="Динамика времени на дистанции">
+        <polyline className="pace-chart__line" fill="none" points={points} />
+      </svg>
+      <p className="pace-chart__caption">
+        Последний пункт: {formatRaceDate(last.race.date)} — {last.race.finishTime} (
+        {last.minutes.toFixed(1)} мин)
+      </p>
+    </div>
+  );
+}
--- a/frontend/src/components/index.ts
+++ b/frontend/src/components/index.ts
@@ -1 +1 @@
-export {};
+export { PaceTrendChart } from "./PaceTrendChart";
--- a/frontend/src/features/index.ts
+++ b/frontend/src/features/index.ts
@@ -1 +0,0 @@
-export {};
--- a/frontend/src/frontendVersion.ts
+++ b/frontend/src/frontendVersion.ts
@@ -0,0 +1,3 @@
+import packageJson from "../package.json";
+
+export const FRONTEND_VERSION: string = packageJson.version;
--- a/frontend/src/lib/index.ts
+++ b/frontend/src/lib/index.ts
@@ -3,8 +3,12 @@ export {
  formatRaceDate,
  getPaceLabel,
  getRaceCountdownLabel,
+  getRaceStatusClassName,
  getRaceStatusLabel,
+  isCloseDistance,
  parseFinishTimeToSeconds,
+  parseRaceDate,
+  raceNeedsResultEntry,
  sortByDateAsc,
  sortByDateDesc,
  splitRacesByDate,
--- a/frontend/src/lib/raceMetrics.ts
+++ b/frontend/src/lib/raceMetrics.ts
@@ -2,8 +2,14 @@ import type { Race } from "../api";

 const MS_IN_DAY = 24 * 60 * 60 * 1000;

-function parseRaceDate(date: string): Date {
-  return new Date(`${date}T00:00:00`);
+/** API date: YYYY-MM-DD или ISO-строка от сериализации (не склеивать с «T00:00:00» повторно). */
+export function parseRaceDate(date: string): Date {
+  const ymd = date.slice(0, 10);
+  if (/^\d{4}-\d{2}-\d{2}$/.test(ymd)) {
+    return new Date(`${ymd}T00:00:00`);
+  }
+  const parsed = new Date(date);
+  return parsed;
 }

 export function parseFinishTimeToSeconds(value: string | null): number | null {
@@ -70,6 +76,22 @@ export function splitRacesByDate(races: Race[], now: Date = new Date()): { upcom
  };
 }

+function pluralizeDays(n: number): string {
+  const mod10 = n % 10;
+  const mod100 = n % 100;
+
+  if (mod100 >= 11 && mod100 <= 19) {
+    return "дней";
+  }
+  if (mod10 === 1) {
+    return "день";
+  }
+  if (mod10 >= 2 && mod10 <= 4) {
+    return "дня";
+  }
+  return "дней";
+}
+
 export function getRaceCountdownLabel(date: string, now: Date = new Date()): string {
  const today = new Date(now);
  today.setHours(0, 0, 0, 0);
@@ -80,13 +102,11 @@ export function getRaceCountdownLabel(date: string, now: Date = new Date()): str
  if (days <= 0) {
    return "сегодня";
  }
-  if (days === 1) {
-    return "через 1 день";
-  }
-  if (days < 5) {
-    return `через ${days} дня`;
-  }
-  return `через ${days} дней`;
+  return `через ${days} ${pluralizeDays(days)}`;
+}
+
+export function isCloseDistance(left: number, right: number): boolean {
+  return Math.abs(left - right) < 0.05;
 }

 export function getPaceLabel(finishTime: string | null, distanceKm: number): string | null {
@@ -102,9 +122,41 @@ export function getPaceLabel(finishTime: string | null, distanceKm: number): str
  return `${String(paceMinutes).padStart(2, "0")}:${String(paceRemainder).padStart(2, "0")} /км`;
 }

-export function getRaceStatusLabel(status: Race["status"]): string {
+function isPastDateNeedingResult(status: Race["status"], raceDate: string): boolean {
+  if (status !== "planned" && status !== "registered") {
+    return false;
+  }
+  const today = new Date();
+  today.setHours(0, 0, 0, 0);
+  return parseRaceDate(raceDate).getTime() < today.getTime();
+}
+
+export function raceNeedsResultEntry(race: Race): boolean {
+  return isPastDateNeedingResult(race.status, race.date);
+}
+
+export function getRaceStatusClassName(status: Race["status"], raceDate?: string): string {
+  const base = "race-card__status";
+  let tier = `${base}--planned`;
+  if (status === "completed") {
+    tier = `${base}--completed`;
+  } else if (status === "registered") {
+    tier = `${base}--registered`;
+  }
+  const needs =
+    raceDate && isPastDateNeedingResult(status, raceDate) ? ` ${base}--needs-result` : "";
+  return `${base} ${tier}${needs}`;
+}
+
+export function getRaceStatusLabel(status: Race["status"], raceDate?: string): string {
+  if (raceDate && isPastDateNeedingResult(status, raceDate)) {
+    return "внесите результат";
+  }
  if (status === "completed") {
    return "пробежал";
  }
+  if (status === "registered") {
+    return "зарегистрирован";
+  }
  return "планирую";
 }
--- a/frontend/src/pages/DashboardPage.tsx
+++ b/frontend/src/pages/DashboardPage.tsx
@@ -1,12 +1,15 @@
 import { useEffect, useMemo, useState } from "react";
 import type { Race } from "../api";
 import { ApiError, getRaces } from "../api";
+import { PaceTrendChart } from "../components";
 import {
  formatDistance,
  formatRaceDate,
  getRaceCountdownLabel,
  getPaceLabel,
+  isCloseDistance,
  parseFinishTimeToSeconds,
+  parseRaceDate,
  splitRacesByDate,
 } from "../lib";

@@ -16,36 +19,34 @@ function getErrorMessage(error: unknown): string {
  if (error instanceof ApiError) {
    return error.message;
  }
-  return "Не удалось загрузить данные dashboard.";
-}
-
-function isSameDistance(left: number, right: number): boolean {
-  return Math.abs(left - right) < 0.05;
+  return "Не удалось загрузить данные обзора.";
 }

 export function DashboardPage(): JSX.Element {
  const [races, setRaces] = useState<Race[]>([]);
  const [isLoading, setIsLoading] = useState<boolean>(true);
  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [chartDistanceKm, setChartDistanceKm] = useState<number>(10);

  useEffect(() => {
+    const ac = new AbortController();
    let isMounted = true;

    async function loadDashboardData(): Promise<void> {
      try {
-        const items = await getRaces();
-        if (!isMounted) {
+        const items = await getRaces(undefined, { signal: ac.signal });
+        if (!isMounted || ac.signal.aborted) {
          return;
        }
        setRaces(items);
        setErrorMessage(null);
      } catch (error) {
-        if (!isMounted) {
+        if (ac.signal.aborted || !isMounted) {
          return;
        }
        setErrorMessage(getErrorMessage(error));
      } finally {
-        if (isMounted) {
+        if (isMounted && !ac.signal.aborted) {
          setIsLoading(false);
        }
      }
@@ -54,6 +55,7 @@ export function DashboardPage(): JSX.Element {
    void loadDashboardData();
    return () => {
      isMounted = false;
+      ac.abort();
    };
  }, []);

@@ -81,7 +83,7 @@ export function DashboardPage(): JSX.Element {
    }

    const currentYear = new Date().getFullYear();
-    const seasonRaces = races.filter((race) => new Date(`${race.date}T00:00:00`).getFullYear() === currentYear);
+    const seasonRaces = races.filter((race) => parseRaceDate(race.date).getFullYear() === currentYear);
    const seasonCompleted = seasonRaces.filter((race) => race.status === "completed");

    return {
@@ -98,7 +100,7 @@ export function DashboardPage(): JSX.Element {
      const candidates = races.filter((race) => {
        return (
          race.status === "completed" &&
-          isSameDistance(race.distanceKm, distanceKm) &&
+          isCloseDistance(race.distanceKm, distanceKm) &&
          Boolean(parseFinishTimeToSeconds(race.finishTime))
        );
      });
@@ -131,12 +133,12 @@ export function DashboardPage(): JSX.Element {
      .filter((race) => race.status === "completed")
      .map((race) => ({
        id: race.id,
-        year: new Date(`${race.date}T00:00:00`).getFullYear(),
+        year: parseRaceDate(race.date).getFullYear(),
        title: race.title,
        distance: formatDistance(race.distanceKm),
        finishTime: race.finishTime ?? "время не указано",
        pace: getPaceLabel(race.finishTime, race.distanceKm) ?? "не удалось вычислить",
-        place: "нет данных",
+        place: race.finishPlace?.trim() ? race.finishPlace : "нет данных",
      }))
      .sort((left, right) => right.year - left.year || left.title.localeCompare(right.title, "ru-RU"));
  }, [races]);
@@ -144,7 +146,7 @@ export function DashboardPage(): JSX.Element {
  if (isLoading) {
    return (
      <section className="page page--dashboard" aria-busy="true">
-        <h1 className="page__title">Dashboard</h1>
+        <h1 className="page__title">Обзор</h1>
        <p className="page__subtitle">Загружаем ваши старты...</p>
      </section>
    );
@@ -153,7 +155,7 @@ export function DashboardPage(): JSX.Element {
  if (errorMessage) {
    return (
      <section className="page page--dashboard" role="alert">
-        <h1 className="page__title">Dashboard</h1>
+        <h1 className="page__title">Обзор</h1>
        <p className="page__subtitle page__subtitle--error">{errorMessage}</p>
      </section>
    );
@@ -161,7 +163,7 @@ export function DashboardPage(): JSX.Element {

  return (
    <section className="page page--dashboard">
-      <h1 className="page__title">Dashboard</h1>
+      <h1 className="page__title">Обзор</h1>
      <p className="page__subtitle">Ключевые метрики по вашему календарю стартов.</p>

      <div className="dashboard-grid" aria-label="Ключевые метрики">
@@ -206,7 +208,7 @@ export function DashboardPage(): JSX.Element {
              <p className="dashboard-card__hint">Лучший темп среди завершённых стартов.</p>
            </>
          ) : (
-            <p className="dashboard-card__empty">Недостаточно данных для PR.</p>
+            <p className="dashboard-card__empty">Недостаточно данных для личного рекорда.</p>
          )}
        </article>

@@ -218,8 +220,32 @@ export function DashboardPage(): JSX.Element {
        </article>
      </div>

+      <section className="dashboard-section" aria-label="Динамика времени на дистанции">
+        <h2 className="dashboard-section__title">Прогресс по времени</h2>
+        <p className="dashboard-section__intro">
+          Линия по завершённым стартам выбранной дистанции: выше — лучше время (короче гонка).
+        </p>
+        <label className="races-filter__field">
+          <span className="races-filter__label">Дистанция для графика</span>
+          <select
+            className="races-filter__select"
+            value={String(chartDistanceKm)}
+            onChange={(event) => {
+              setChartDistanceKm(Number(event.target.value));
+            }}
+          >
+            {PR_DISTANCES.map((d) => (
+              <option key={d} value={d}>
+                {formatDistance(d)}
+              </option>
+            ))}
+          </select>
+        </label>
+        <PaceTrendChart races={races} distanceKm={chartDistanceKm} />
+      </section>
+
      <section className="dashboard-section" aria-label="Личные рекорды по дистанциям">
-        <h2 className="dashboard-section__title">PR по дистанциям</h2>
+        <h2 className="dashboard-section__title">Рекорды по дистанциям</h2>
        <div className="dashboard-grid dashboard-grid--pr">
          {personalRecordsByDistance.map((item) => (
            <article key={item.distanceKm} className="dashboard-card">
@@ -268,7 +294,7 @@ export function DashboardPage(): JSX.Element {
            </table>
          </div>
        ) : (
-          <p className="dashboard-card__empty">Нет completed-стартов для сравнения.</p>
+          <p className="dashboard-card__empty">Нет завершённых стартов для сравнения.</p>
        )}
      </section>
    </section>
--- a/frontend/src/pages/RaceDetailsPage.tsx
+++ b/frontend/src/pages/RaceDetailsPage.tsx
@@ -1,7 +1,14 @@
-import { useEffect, useMemo, useState } from "react";
-import { Link, useParams } from "react-router-dom";
-import { ApiError, getRaceById } from "../api";
-import { formatDistance, formatRaceDate, getPaceLabel, getRaceStatusLabel } from "../lib";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { Link, useNavigate, useParams } from "react-router-dom";
+import { ApiError, deleteRace, getRaceById } from "../api";
+import {
+  formatDistance,
+  formatRaceDate,
+  getPaceLabel,
+  getRaceStatusClassName,
+  getRaceStatusLabel,
+  raceNeedsResultEntry,
+} from "../lib";
 import type { Race } from "../api";

 function getErrorMessage(error: unknown): string {
@@ -11,13 +18,47 @@ function getErrorMessage(error: unknown): string {
  return "Не удалось загрузить карточку старта.";
 }

+function DetailItem(props: { label: string; value: string | null | undefined }): JSX.Element | null {
+  const text = props.value?.trim();
+  if (!text) {
+    return null;
+  }
+  return (
+    <div className="race-details-meta__item">
+      <dt className="race-details-meta__key">{props.label}</dt>
+      <dd className="race-details-meta__value">{text}</dd>
+    </div>
+  );
+}
+
+function DetailLink(props: { label: string; url: string | null | undefined }): JSX.Element | null {
+  const href = props.url?.trim();
+  if (!href) {
+    return null;
+  }
+  return (
+    <div className="race-details-meta__item">
+      <dt className="race-details-meta__key">{props.label}</dt>
+      <dd className="race-details-meta__value">
+        <a href={href} target="_blank" rel="noopener noreferrer" className="race-details-meta__link">
+          {href}
+        </a>
+      </dd>
+    </div>
+  );
+}
+
 export function RaceDetailsPage(): JSX.Element {
  const { raceId } = useParams<{ raceId: string }>();
+  const navigate = useNavigate();
  const [race, setRace] = useState<Race | null>(null);
  const [isLoading, setIsLoading] = useState<boolean>(true);
  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [isDeleting, setIsDeleting] = useState<boolean>(false);
+  const [showDeleteConfirm, setShowDeleteConfirm] = useState<boolean>(false);

  useEffect(() => {
+    const ac = new AbortController();
    let isMounted = true;

    async function loadRace(): Promise<void> {
@@ -28,19 +69,19 @@ export function RaceDetailsPage(): JSX.Element {
      }

      try {
-        const item = await getRaceById(raceId);
-        if (!isMounted) {
+        const item = await getRaceById(raceId, { signal: ac.signal });
+        if (!isMounted || ac.signal.aborted) {
          return;
        }
        setRace(item);
        setErrorMessage(null);
      } catch (error) {
-        if (!isMounted) {
+        if (ac.signal.aborted || !isMounted) {
          return;
        }
        setErrorMessage(getErrorMessage(error));
      } finally {
-        if (isMounted) {
+        if (isMounted && !ac.signal.aborted) {
          setIsLoading(false);
        }
      }
@@ -49,6 +90,7 @@ export function RaceDetailsPage(): JSX.Element {
    void loadRace();
    return () => {
      isMounted = false;
+      ac.abort();
    };
  }, [raceId]);

@@ -59,6 +101,22 @@ export function RaceDetailsPage(): JSX.Element {
    return getPaceLabel(race.finishTime, race.distanceKm);
  }, [race]);

+  const handleDelete = useCallback(async () => {
+    if (!raceId) {
+      return;
+    }
+    setIsDeleting(true);
+    try {
+      await deleteRace(raceId);
+      navigate("/races", { replace: true });
+    } catch (error) {
+      setErrorMessage(error instanceof ApiError ? error.message : "Не удалось удалить старт.");
+      setShowDeleteConfirm(false);
+    } finally {
+      setIsDeleting(false);
+    }
+  }, [raceId, navigate]);
+
  if (isLoading) {
    return (
      <section className="page page--race-details" aria-busy="true">
@@ -91,17 +149,56 @@ export function RaceDetailsPage(): JSX.Element {
            {formatRaceDate(race.date)} · {formatDistance(race.distanceKm)}
          </p>
        </div>
-        <span
-          className={
-            isCompleted
-              ? "race-card__status race-card__status--completed"
-              : "race-card__status race-card__status--planned"
-          }
-        >
-          {getRaceStatusLabel(race.status)}
-        </span>
+        <span className={getRaceStatusClassName(race.status, race.date)}>{getRaceStatusLabel(race.status, race.date)}</span>
      </div>

+      {raceNeedsResultEntry(race) ? (
+        <p className="race-details-past-hint" role="status">
+          Дата старта уже прошла —{" "}
+          <Link className="race-details-past-hint__link" to={`/races/${race.id}/edit`}>
+            внесите результат или обновите статус
+          </Link>
+          .
+        </p>
+      ) : null}
+
+      <div className="race-details-actions">
+        <Link className="btn btn--primary" to={`/races/${race.id}/edit`}>
+          Редактировать
+        </Link>
+        <button
+          className="btn btn--danger"
+          type="button"
+          onClick={() => setShowDeleteConfirm(true)}
+        >
+          Удалить
+        </button>
+      </div>
+
+      {showDeleteConfirm ? (
+        <div className="confirm-banner" role="alertdialog" aria-label="Подтверждение удаления">
+          <p className="confirm-banner__text">Удалить «{race.title}»? Это действие необратимо.</p>
+          <div className="confirm-banner__actions">
+            <button
+              className="btn btn--danger"
+              type="button"
+              disabled={isDeleting}
+              onClick={handleDelete}
+            >
+              {isDeleting ? "Удаляем…" : "Да, удалить"}
+            </button>
+            <button
+              className="btn btn--secondary"
+              type="button"
+              disabled={isDeleting}
+              onClick={() => setShowDeleteConfirm(false)}
+            >
+              Отмена
+            </button>
+          </div>
+        </div>
+      ) : null}
+
      <div className="race-details-grid">
        <article className="race-details-card">
          <h2 className="race-details-card__title">Основная информация</h2>
@@ -116,13 +213,18 @@ export function RaceDetailsPage(): JSX.Element {
            </div>
            <div className="race-details-meta__item">
              <dt className="race-details-meta__key">Статус</dt>
-              <dd className="race-details-meta__value">{getRaceStatusLabel(race.status)}</dd>
+              <dd className="race-details-meta__value">{getRaceStatusLabel(race.status, race.date)}</dd>
            </div>
+            <DetailLink label="Сайт организатора" url={race.officialUrl} />
+            <DetailItem label="Время старта" value={race.startTime} />
+            <DetailItem label="Расписание кластеров" value={race.clusterSchedule} />
+            <DetailItem label="Выдача номеров" value={race.bibPickup} />
+            <DetailItem label="Стартовый номер" value={race.bibNumber} />
          </dl>
        </article>

        <article className="race-details-card">
-          <h2 className="race-details-card__title">Completed-метрики</h2>
+          <h2 className="race-details-card__title">Результаты</h2>
          {isCompleted ? (
            <dl className="race-details-meta">
              <div className="race-details-meta__item">
@@ -133,10 +235,7 @@ export function RaceDetailsPage(): JSX.Element {
                <dt className="race-details-meta__key">Темп</dt>
                <dd className="race-details-meta__value">{paceLabel ?? "не удалось вычислить"}</dd>
              </div>
-              <div className="race-details-meta__item">
-                <dt className="race-details-meta__key">Стартовый номер</dt>
-                <dd className="race-details-meta__value">{race.bibNumber ?? "не указан"}</dd>
-              </div>
+              <DetailItem label="Место" value={race.finishPlace} />
            </dl>
          ) : (
            <p className="race-details-card__empty">
--- a/frontend/src/pages/RaceFormPage.tsx
+++ b/frontend/src/pages/RaceFormPage.tsx
@@ -0,0 +1,422 @@
+import { useCallback, useEffect, useState } from "react";
+import { Link, useNavigate, useParams } from "react-router-dom";
+import { ApiError, createRace, getRaceById, updateRace } from "../api";
+import type { CreateRacePayload, Race, RaceStatus, UpdateRacePayload } from "../api";
+
+function slugify(text: string): string {
+  return text
+    .toLowerCase()
+    .replace(/[«»"]/g, "")
+    .replace(/[^a-zа-яё0-9]+/gi, "-")
+    .replace(/(^-|-$)/g, "")
+    .substring(0, 60);
+}
+
+function generateId(date: string, title: string): string {
+  return `${date}-${slugify(title)}`;
+}
+
+const STATUS_OPTIONS: { value: string; label: string }[] = [
+  { value: "", label: "Не указан" },
+  { value: "planned", label: "Планирую" },
+  { value: "registered", label: "Зарегистрирован" },
+  { value: "completed", label: "Пробежал" },
+];
+
+interface FormData {
+  date: string;
+  title: string;
+  distanceKm: string;
+  status: string;
+  officialUrl: string;
+  startTime: string;
+  clusterSchedule: string;
+  bibPickup: string;
+  bibNumber: string;
+  finishTime: string;
+  finishPlace: string;
+  notes: string;
+}
+
+const EMPTY_FORM: FormData = {
+  date: "",
+  title: "",
+  distanceKm: "",
+  status: "planned",
+  officialUrl: "",
+  startTime: "",
+  clusterSchedule: "",
+  bibPickup: "",
+  bibNumber: "",
+  finishTime: "",
+  finishPlace: "",
+  notes: "",
+};
+
+function raceToFormData(race: Race): FormData {
+  const dateValue = race.date.length >= 10 ? race.date.slice(0, 10) : race.date;
+  return {
+    date: dateValue,
+    title: race.title,
+    distanceKm: String(race.distanceKm),
+    status: race.status ?? "",
+    officialUrl: race.officialUrl ?? "",
+    startTime: race.startTime ?? "",
+    clusterSchedule: race.clusterSchedule ?? "",
+    bibPickup: race.bibPickup ?? "",
+    bibNumber: race.bibNumber ?? "",
+    finishTime: race.finishTime ?? "",
+    finishPlace: race.finishPlace ?? "",
+    notes: race.notes ?? "",
+  };
+}
+
+function emptyToNull(value: string): string | null {
+  const trimmed = value.trim();
+  return trimmed === "" ? null : trimmed;
+}
+
+function validateForm(form: FormData): string[] {
+  const errors: string[] = [];
+  if (!form.date.trim()) {
+    errors.push("Дата обязательна.");
+  }
+  if (!form.title.trim()) {
+    errors.push("Название обязательно.");
+  }
+  const km = parseFloat(form.distanceKm);
+  if (Number.isNaN(km) || km <= 0) {
+    errors.push("Дистанция должна быть положительным числом.");
+  }
+  return errors;
+}
+
+export function RaceFormPage(): JSX.Element {
+  const { raceId } = useParams<{ raceId: string }>();
+  const navigate = useNavigate();
+  const isEditMode = Boolean(raceId);
+
+  const [form, setForm] = useState<FormData>(EMPTY_FORM);
+  const [isLoading, setIsLoading] = useState<boolean>(isEditMode);
+  const [isSaving, setIsSaving] = useState<boolean>(false);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [validationErrors, setValidationErrors] = useState<string[]>([]);
+
+  useEffect(() => {
+    if (!raceId) {
+      return;
+    }
+
+    let isMounted = true;
+
+    async function loadRace(): Promise<void> {
+      try {
+        const race = await getRaceById(raceId!);
+        if (!isMounted) {
+          return;
+        }
+        setForm(raceToFormData(race));
+        setErrorMessage(null);
+      } catch (error) {
+        if (!isMounted) {
+          return;
+        }
+        setErrorMessage(error instanceof ApiError ? error.message : "Не удалось загрузить данные старта.");
+      } finally {
+        if (isMounted) {
+          setIsLoading(false);
+        }
+      }
+    }
+
+    void loadRace();
+    return () => {
+      isMounted = false;
+    };
+  }, [raceId]);
+
+  const handleChange = useCallback(
+    (event: React.ChangeEvent<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>) => {
+      const { name, value } = event.target;
+      setForm((prev) => ({ ...prev, [name]: value }));
+    },
+    [],
+  );
+
+  const handleSubmit = useCallback(
+    async (event: React.FormEvent) => {
+      event.preventDefault();
+      setErrorMessage(null);
+
+      const errors = validateForm(form);
+      setValidationErrors(errors);
+      if (errors.length > 0) {
+        return;
+      }
+
+      setIsSaving(true);
+
+      try {
+        const statusValue: RaceStatus | null =
+          form.status === "planned" || form.status === "registered" || form.status === "completed"
+            ? form.status
+            : null;
+
+        if (isEditMode && raceId) {
+          const payload: UpdateRacePayload = {
+            date: form.date.trim(),
+            title: form.title.trim(),
+            distanceKm: parseFloat(form.distanceKm),
+            status: statusValue,
+            officialUrl: emptyToNull(form.officialUrl),
+            startTime: emptyToNull(form.startTime),
+            clusterSchedule: emptyToNull(form.clusterSchedule),
+            bibPickup: emptyToNull(form.bibPickup),
+            bibNumber: emptyToNull(form.bibNumber),
+            finishTime: emptyToNull(form.finishTime),
+            finishPlace: emptyToNull(form.finishPlace),
+            notes: emptyToNull(form.notes),
+          };
+
+          await updateRace(raceId, payload);
+          navigate(`/races/${raceId}`);
+        } else {
+          const id = generateId(form.date.trim(), form.title.trim());
+          const payload: CreateRacePayload = {
+            id,
+            date: form.date.trim(),
+            title: form.title.trim(),
+            distanceKm: parseFloat(form.distanceKm),
+            status: statusValue,
+            officialUrl: emptyToNull(form.officialUrl),
+            startTime: emptyToNull(form.startTime),
+            clusterSchedule: emptyToNull(form.clusterSchedule),
+            bibPickup: emptyToNull(form.bibPickup),
+            bibNumber: emptyToNull(form.bibNumber),
+            finishTime: emptyToNull(form.finishTime),
+            finishPlace: emptyToNull(form.finishPlace),
+            notes: emptyToNull(form.notes),
+          };
+
+          const created = await createRace(payload);
+          navigate(`/races/${created.id}`);
+        }
+      } catch (error) {
+        if (error instanceof ApiError) {
+          setErrorMessage(error.details.length > 0 ? error.details.join("; ") : error.message);
+        } else {
+          setErrorMessage("Произошла ошибка при сохранении.");
+        }
+      } finally {
+        setIsSaving(false);
+      }
+    },
+    [form, isEditMode, raceId, navigate],
+  );
+
+  const pageTitle = isEditMode ? "Редактирование старта" : "Новый старт";
+
+  if (isLoading) {
+    return (
+      <section className="page page--race-form" aria-busy="true">
+        <h1 className="page__title">{pageTitle}</h1>
+        <p className="page__subtitle">Загружаем данные...</p>
+      </section>
+    );
+  }
+
+  return (
+    <section className="page page--race-form">
+      <h1 className="page__title">{pageTitle}</h1>
+
+      {errorMessage ? (
+        <p className="page__subtitle page__subtitle--error" role="alert">{errorMessage}</p>
+      ) : null}
+
+      {validationErrors.length > 0 ? (
+        <ul className="form-errors" role="alert">
+          {validationErrors.map((msg) => (
+            <li key={msg} className="form-errors__item">{msg}</li>
+          ))}
+        </ul>
+      ) : null}
+
+      <form className="race-form" onSubmit={handleSubmit} noValidate>
+        <fieldset className="race-form__group">
+          <legend className="race-form__legend">Основная информация</legend>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Дата *</span>
+            <input
+              className="race-form__input"
+              type="date"
+              name="date"
+              value={form.date}
+              onChange={handleChange}
+              required
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Название *</span>
+            <input
+              className="race-form__input"
+              type="text"
+              name="title"
+              value={form.title}
+              onChange={handleChange}
+              required
+              placeholder="Казанский марафон"
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Дистанция, км *</span>
+            <input
+              className="race-form__input"
+              type="number"
+              name="distanceKm"
+              value={form.distanceKm}
+              onChange={handleChange}
+              required
+              min="0.1"
+              step="0.001"
+              placeholder="21.1"
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Статус</span>
+            <select
+              className="race-form__input"
+              name="status"
+              value={form.status}
+              onChange={handleChange}
+            >
+              {STATUS_OPTIONS.map((opt) => (
+                <option key={opt.value} value={opt.value}>{opt.label}</option>
+              ))}
+            </select>
+          </label>
+        </fieldset>
+
+        <fieldset className="race-form__group">
+          <legend className="race-form__legend">Организация</legend>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Сайт организатора</span>
+            <input
+              className="race-form__input"
+              type="url"
+              name="officialUrl"
+              value={form.officialUrl}
+              onChange={handleChange}
+              placeholder="https://…"
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Время старта</span>
+            <input
+              className="race-form__input"
+              type="text"
+              name="startTime"
+              value={form.startTime}
+              onChange={handleChange}
+              placeholder="09:30"
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Расписание кластеров</span>
+            <input
+              className="race-form__input"
+              type="text"
+              name="clusterSchedule"
+              value={form.clusterSchedule}
+              onChange={handleChange}
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Выдача номеров</span>
+            <input
+              className="race-form__input"
+              type="text"
+              name="bibPickup"
+              value={form.bibPickup}
+              onChange={handleChange}
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Стартовый номер</span>
+            <input
+              className="race-form__input"
+              type="text"
+              name="bibNumber"
+              value={form.bibNumber}
+              onChange={handleChange}
+              placeholder="1234"
+            />
+          </label>
+        </fieldset>
+
+        <fieldset className="race-form__group">
+          <legend className="race-form__legend">Результаты</legend>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Финишное время</span>
+            <input
+              className="race-form__input"
+              type="text"
+              name="finishTime"
+              value={form.finishTime}
+              onChange={handleChange}
+              placeholder="1:45:30"
+            />
+          </label>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Место на финише</span>
+            <input
+              className="race-form__input"
+              type="text"
+              name="finishPlace"
+              value={form.finishPlace}
+              onChange={handleChange}
+              placeholder="12/340"
+            />
+          </label>
+        </fieldset>
+
+        <fieldset className="race-form__group">
+          <legend className="race-form__legend">Дополнительно</legend>
+
+          <label className="race-form__field">
+            <span className="race-form__label">Заметки</span>
+            <textarea
+              className="race-form__input race-form__input--textarea"
+              name="notes"
+              value={form.notes}
+              onChange={handleChange}
+              rows={4}
+            />
+          </label>
+        </fieldset>
+
+        <div className="race-form__actions">
+          <button className="btn btn--primary" type="submit" disabled={isSaving}>
+            {isSaving ? "Сохраняем…" : isEditMode ? "Сохранить" : "Создать"}
+          </button>
+          <Link
+            className="btn btn--secondary"
+            to={isEditMode && raceId ? `/races/${raceId}` : "/races"}
+          >
+            Отмена
+          </Link>
+        </div>
+      </form>
+    </section>
+  );
+}
--- a/frontend/src/pages/RacesPage.tsx
+++ b/frontend/src/pages/RacesPage.tsx
@@ -1,8 +1,41 @@
 import { useEffect, useMemo, useState } from "react";
 import { Link } from "react-router-dom";
-import type { Race } from "../api";
+import type { Race, RacesQuery } from "../api";
 import { ApiError, getRaces } from "../api";
-import { formatDistance, formatRaceDate, getRaceStatusLabel, splitRacesByDate } from "../lib";
+import {
+  formatDistance,
+  formatRaceDate,
+  getRaceStatusClassName,
+  getRaceStatusLabel,
+  splitRacesByDate,
+} from "../lib";
+
+const MONTH_OPTIONS: { value: string; label: string }[] = [
+  { value: "", label: "Все месяцы" },
+  { value: "1", label: "Январь" },
+  { value: "2", label: "Февраль" },
+  { value: "3", label: "Март" },
+  { value: "4", label: "Апрель" },
+  { value: "5", label: "Май" },
+  { value: "6", label: "Июнь" },
+  { value: "7", label: "Июль" },
+  { value: "8", label: "Август" },
+  { value: "9", label: "Сентябрь" },
+  { value: "10", label: "Октябрь" },
+  { value: "11", label: "Ноябрь" },
+  { value: "12", label: "Декабрь" },
+];
+
+function yearSelectOptions(): number[] {
+  const current = new Date().getFullYear();
+  const start = current - 2;
+  const end = current + 4;
+  const years: number[] = [];
+  for (let y = start; y <= end; y += 1) {
+    years.push(y);
+  }
+  return years;
+}

 function getErrorMessage(error: unknown): string {
  if (error instanceof ApiError) {
@@ -31,15 +64,7 @@ function RaceList(props: { title: string; races: Race[] }): JSX.Element {
                  {formatRaceDate(race.date)} · {formatDistance(race.distanceKm)}
                </p>
              </div>
-              <span
-                className={
-                  race.status === "completed"
-                    ? "race-card__status race-card__status--completed"
-                    : "race-card__status race-card__status--planned"
-                }
-              >
-                {getRaceStatusLabel(race.status)}
-              </span>
+              <span className={getRaceStatusClassName(race.status, race.date)}>{getRaceStatusLabel(race.status, race.date)}</span>
            </li>
          ))}
        </ul>
@@ -54,25 +79,46 @@ export function RacesPage(): JSX.Element {
  const [races, setRaces] = useState<Race[]>([]);
  const [isLoading, setIsLoading] = useState<boolean>(true);
  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [yearFilter, setYearFilter] = useState<string>("");
+  const [monthFilter, setMonthFilter] = useState<string>("");
+
+  const listQuery = useMemo((): RacesQuery | undefined => {
+    const q: RacesQuery = {};
+    if (yearFilter !== "") {
+      const y = parseInt(yearFilter, 10);
+      if (!Number.isNaN(y)) {
+        q.year = y;
+      }
+    }
+    if (monthFilter !== "") {
+      const m = parseInt(monthFilter, 10);
+      if (!Number.isNaN(m)) {
+        q.month = m;
+      }
+    }
+    return Object.keys(q).length > 0 ? q : undefined;
+  }, [yearFilter, monthFilter]);

  useEffect(() => {
+    const ac = new AbortController();
    let isMounted = true;

    async function loadRaces(): Promise<void> {
+      setIsLoading(true);
      try {
-        const items = await getRaces();
-        if (!isMounted) {
+        const items = await getRaces(listQuery, { signal: ac.signal });
+        if (!isMounted || ac.signal.aborted) {
          return;
        }
        setRaces(items);
        setErrorMessage(null);
      } catch (error) {
-        if (!isMounted) {
+        if (ac.signal.aborted || !isMounted) {
          return;
        }
        setErrorMessage(getErrorMessage(error));
      } finally {
-        if (isMounted) {
+        if (isMounted && !ac.signal.aborted) {
          setIsLoading(false);
        }
      }
@@ -81,21 +127,13 @@ export function RacesPage(): JSX.Element {
    void loadRaces();
    return () => {
      isMounted = false;
+      ac.abort();
    };
-  }, []);
+  }, [listQuery]);

  const { upcoming, past } = useMemo(() => splitRacesByDate(races), [races]);

-  if (isLoading) {
-    return (
-      <section className="page page--races" aria-busy="true">
-        <h1 className="page__title">Календарь стартов</h1>
-        <p className="page__subtitle">Загружаем данные...</p>
-      </section>
-    );
-  }
-
-  if (errorMessage) {
+  if (errorMessage && races.length === 0 && !isLoading) {
    return (
      <section className="page page--races" role="alert">
        <h1 className="page__title">Календарь стартов</h1>
@@ -109,6 +147,54 @@ export function RacesPage(): JSX.Element {
      <h1 className="page__title">Календарь стартов</h1>
      <p className="page__subtitle">Будущие и прошедшие старты в одном месте.</p>

+      {errorMessage && !isLoading ? (
+        <p className="page__subtitle page__subtitle--error" role="alert" style={{ marginTop: "var(--space-4)" }}>
+          {errorMessage}
+        </p>
+      ) : null}
+
+      <div className="races-filter" role="search" aria-label="Фильтр по дате">
+        <label className="races-filter__field">
+          <span className="races-filter__label">Год</span>
+          <select
+            className="races-filter__select"
+            value={yearFilter}
+            onChange={(event) => {
+              setYearFilter(event.target.value);
+            }}
+          >
+            <option value="">Все года</option>
+            {yearSelectOptions().map((y) => (
+              <option key={y} value={String(y)}>
+                {y}
+              </option>
+            ))}
+          </select>
+        </label>
+        <label className="races-filter__field">
+          <span className="races-filter__label">Месяц</span>
+          <select
+            className="races-filter__select"
+            value={monthFilter}
+            onChange={(event) => {
+              setMonthFilter(event.target.value);
+            }}
+          >
+            {MONTH_OPTIONS.map((opt) => (
+              <option key={opt.value || "all"} value={opt.value}>
+                {opt.label}
+              </option>
+            ))}
+          </select>
+        </label>
+      </div>
+
+      {isLoading ? (
+        <p className="page__subtitle" aria-busy="true">
+          Загружаем данные...
+        </p>
+      ) : null}
+
      <div className="race-lists">
        <RaceList title="Будущие" races={upcoming} />
        <RaceList title="Прошедшие" races={past} />
--- a/frontend/src/styles/global.css
+++ b/frontend/src/styles/global.css
@@ -27,7 +27,7 @@ a {
 .app-shell {
  min-height: 100vh;
  display: grid;
-  grid-template-rows: auto 1fr;
+  grid-template-rows: auto 1fr auto;
 }

 .app-shell__header {
@@ -64,7 +64,9 @@ a {
  outline: none;
 }

-.app-shell__link--active {
+.app-shell__link--active,
+.app-shell__link--active:hover,
+.app-shell__link--active:focus-visible {
  color: var(--color-surface);
  background: var(--color-accent);
 }
@@ -75,6 +77,24 @@ a {
  padding: var(--space-6);
 }

+.app-shell__footer {
+  margin-top: auto;
+  padding: var(--space-3) var(--space-6);
+  border-top: 1px solid var(--color-border);
+  background: var(--color-surface);
+}
+
+.app-shell__footer-versions {
+  margin: 0;
+  text-align: center;
+  font-size: var(--font-size-caption);
+  color: var(--color-text-muted);
+}
+
+.app-shell__footer-sep {
+  user-select: none;
+}
+
 .page {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
@@ -144,6 +164,14 @@ a {
  font-size: var(--font-size-h2);
 }

+.dashboard-section__intro {
+  margin: calc(var(--space-2) * -1) 0 var(--space-4);
+  max-width: 42rem;
+  color: var(--color-text-muted);
+  font-size: var(--font-size-caption);
+  line-height: 1.5;
+}
+
 .dashboard-grid--pr {
  margin-top: 0;
 }
@@ -258,6 +286,99 @@ a {
  color: var(--color-success);
 }

+.race-card__status--registered {
+  background: #fff4e0;
+  color: #8a5a00;
+}
+
+.race-card__status--needs-result {
+  outline: 1px solid var(--color-warning);
+}
+
+.race-details-past-hint {
+  margin: 0 0 var(--space-4);
+  padding: var(--space-3) var(--space-4);
+  border-radius: var(--radius-md);
+  border: 1px solid var(--color-warning);
+  background: #fffaf0;
+  color: var(--color-text);
+  font-size: var(--font-size-caption);
+}
+
+.race-details-past-hint__link {
+  color: var(--color-accent);
+  font-weight: 600;
+  text-decoration: underline;
+}
+
+.race-details-past-hint__link:hover,
+.race-details-past-hint__link:focus-visible {
+  outline: none;
+}
+
+.races-filter {
+  margin-top: var(--space-5);
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-4);
+  align-items: flex-end;
+}
+
+.races-filter__field {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-1);
+  min-width: 10rem;
+}
+
+.races-filter__label {
+  font-size: var(--font-size-caption);
+  font-weight: 600;
+  color: var(--color-text-muted);
+}
+
+.races-filter__select {
+  font: inherit;
+  padding: var(--space-2) var(--space-3);
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--color-border);
+  background: var(--color-surface);
+  color: var(--color-text);
+}
+
+.pace-chart {
+  margin-top: var(--space-4);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-md);
+  padding: var(--space-4);
+  background: #fcfdff;
+}
+
+.pace-chart__svg {
+  display: block;
+  width: 100%;
+  max-width: 560px;
+  height: auto;
+}
+
+.pace-chart__line {
+  stroke: var(--color-accent);
+  stroke-width: 1.5;
+  vector-effect: non-scaling-stroke;
+}
+
+.pace-chart__caption {
+  margin: var(--space-3) 0 0;
+  font-size: var(--font-size-caption);
+  color: var(--color-text-muted);
+}
+
+.pace-chart__empty {
+  margin: var(--space-2) 0 0;
+  color: var(--color-text-muted);
+  font-size: var(--font-size-body);
+}
+
 .page-link {
  margin-top: var(--space-4);
  display: inline-flex;
@@ -330,6 +451,175 @@ a {
  color: var(--color-text);
 }

+/* ─── Buttons ──────────────────────────────────────────── */
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--space-2) var(--space-4);
+  border: 1px solid transparent;
+  border-radius: var(--radius-sm);
+  font: inherit;
+  font-weight: 600;
+  font-size: var(--font-size-caption);
+  cursor: pointer;
+  text-decoration: none;
+  white-space: nowrap;
+  transition: background 0.15s, color 0.15s;
+}
+
+.btn:disabled {
+  opacity: 0.55;
+  cursor: not-allowed;
+}
+
+.btn--primary {
+  background: var(--color-accent);
+  color: var(--color-surface);
+}
+
+.btn--primary:hover:not(:disabled) {
+  background: #1766be;
+}
+
+.btn--secondary {
+  background: var(--color-surface);
+  color: var(--color-text);
+  border-color: var(--color-border);
+}
+
+.btn--secondary:hover:not(:disabled) {
+  background: #eef2f6;
+}
+
+.btn--danger {
+  background: var(--color-error);
+  color: var(--color-surface);
+}
+
+.btn--danger:hover:not(:disabled) {
+  background: #a82e2e;
+}
+
+/* ─── Confirm banner ───────────────────────────────────── */
+
+.confirm-banner {
+  margin-top: var(--space-4);
+  padding: var(--space-4);
+  border: 1px solid var(--color-error);
+  border-radius: var(--radius-md);
+  background: #fef2f2;
+}
+
+.confirm-banner__text {
+  margin: 0 0 var(--space-3);
+  font-weight: 600;
+  color: var(--color-error);
+}
+
+.confirm-banner__actions {
+  display: flex;
+  gap: var(--space-3);
+}
+
+/* ─── Race details actions ─────────────────────────────── */
+
+.race-details-actions {
+  margin-top: var(--space-4);
+  display: flex;
+  gap: var(--space-3);
+}
+
+.race-details-meta__link {
+  color: var(--color-accent);
+  word-break: break-all;
+}
+
+.race-details-meta__link:hover {
+  text-decoration: underline;
+}
+
+/* ─── Race form ────────────────────────────────────────── */
+
+.race-form {
+  margin-top: var(--space-6);
+}
+
+.race-form__group {
+  margin: 0 0 var(--space-6);
+  padding: var(--space-5);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-md);
+  background: #fcfdff;
+}
+
+.race-form__legend {
+  font-size: var(--font-size-body);
+  font-weight: 700;
+  color: var(--color-text);
+  padding: 0 var(--space-2);
+}
+
+.race-form__field {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-1);
+  margin-top: var(--space-4);
+}
+
+.race-form__field:first-of-type {
+  margin-top: var(--space-3);
+}
+
+.race-form__label {
+  font-size: var(--font-size-caption);
+  font-weight: 600;
+  color: var(--color-text-muted);
+}
+
+.race-form__input {
+  font: inherit;
+  padding: var(--space-2) var(--space-3);
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--color-border);
+  background: var(--color-surface);
+  color: var(--color-text);
+}
+
+.race-form__input:focus {
+  outline: 2px solid var(--color-accent);
+  outline-offset: -1px;
+  border-color: var(--color-accent);
+}
+
+.race-form__input--textarea {
+  resize: vertical;
+  min-height: 5rem;
+}
+
+.race-form__actions {
+  display: flex;
+  gap: var(--space-3);
+  align-items: center;
+}
+
+.form-errors {
+  margin: var(--space-3) 0 0;
+  padding: var(--space-3) var(--space-5);
+  border: 1px solid var(--color-error);
+  border-radius: var(--radius-sm);
+  background: #fef2f2;
+  color: var(--color-error);
+  font-size: var(--font-size-caption);
+}
+
+.form-errors__item {
+  margin: var(--space-1) 0;
+}
+
+/* ─── Responsive ───────────────────────────────────────── */
+
@media (max-width: 900px) {
  .dashboard-grid,
  .race-lists,
@@ -340,4 +630,9 @@ a {
  .race-details-header {
    flex-direction: column;
  }
+
+  .race-form__actions {
+    flex-direction: column;
+    align-items: stretch;
+  }
 }
--- a/frontend/src/styles/tokens.css
+++ b/frontend/src/styles/tokens.css
@@ -16,6 +16,7 @@
  --font-size-caption: 0.875rem;
  --line-height-base: 1.5;

+  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
--- a/frontend/src/vite-env.d.ts
+++ b/frontend/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
--- a/frontend/vite.config.ts
+++ b/frontend/vite.config.ts
@@ -2,5 +2,5 @@ import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react";

 export default defineConfig({
-  plugins: [react()]
+  plugins: [react()],
 });
Author	SHA1	Message	Date
Anton	83bc603b95	feat: /meta для версии в футере и устойчивый разбор JSON Some checks failed CI / build-and-test (pull_request) Has been cancelled Details	2026-04-08 10:32:52 +03:00
admin	f8b4ce7111	Merge pull request 'fix(api): дублировать маршруты под /api и убрать Content-Type у GET' (#16 ) from fix/api-prefix-routing into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #16	2026-04-08 07:21:03 +00:00
Anton	53b9561a54	fix(api): дублировать маршруты под /api и убрать Content-Type у GET Some checks failed CI / build-and-test (pull_request) Has been cancelled Details	2026-04-08 10:20:17 +03:00
admin	7e9c20d4bf	Merge pull request 'fix: прод — CORS, версия API, ошибки клиента и подсказка по прошедшим стартам' (#15 ) from fix/prod-cors-health-status-hints into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #15	2026-04-07 22:21:49 +00:00
Vaka.pro	e0ed0b6435	fix: прод — CORS, версия API, ошибки клиента и подсказка по прошедшим стартам Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - CORS_ORIGIN: несколько origin через запятую; комментарии в .env.example - Версия бэкенда: APP_VERSION, безопасное чтение package.json, футер при пустой версии - Сообщения API: unknown_error и ответы 401/403/404 без JSON; отладочный лог при !ok - Статус «внесите результат» для прошедшей даты + блок на карточке старта и стили	2026-04-08 01:21:11 +03:00
admin	8442c761c2	Merge pull request 'fix(frontend): bundle app version via package.json import instead of Vite define' (#14 ) from fix/vite-frontend-version-define into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #14	2026-04-07 21:55:25 +00:00
Vaka.pro	87d6505fbf	fix(frontend): bundle app version via package.json import instead of Vite define Some checks failed CI / build-and-test (pull_request) Has been cancelled Details	2026-04-08 00:45:24 +03:00
admin	99ae7410ce	Merge pull request 'feat: русский UI, версии в футере, даты и устойчивость загрузки API' (#13 ) from feat/ru-ui-footer-versions-dates-api into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #13	2026-04-07 21:40:47 +00:00
Vaka.pro	42ee36d0a2	feat: русский UI, версии в футере, даты и устойчивость загрузки API Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - API: дата старта всегда YYYY-MM-DD; фронт: parseRaceDate без двойного T00:00:00 - GET /health с version из package.json; Vite define __FRONTEND_VERSION__ - Футер с версиями клиента/сервера (BEM), сетка app-shell на три ряда - AbortController для карточки старта; ретраи GET при 502–504 и понятные ошибки шлюза - Русские подписи навигации/страниц, lang=ru, без английских фраз в интерфейсе	2026-04-08 00:40:03 +03:00
admin	fc995ed07d	Merge pull request 'fix(seed): resolve CSV path for Docker and mount import in stack compose; deleted plans; adds extra files to gitignore' (#12 ) from fix/seed-csv-path-docker-import-mount into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #12	2026-04-07 21:22:53 +00:00
Vaka.pro	0f0c7c2607	fix(seed): resolve CSV path for Docker and mount import in stack compose; deleted plans; adds extra files to gitignore Some checks failed CI / build-and-test (pull_request) Has been cancelled Details	2026-04-08 00:22:11 +03:00
admin	ef423b322f	Merge pull request 'chore: delete empty features module, fix RaceRow timestamp types' (#11 ) from chore/phase4-cleanup-types into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #11	2026-04-07 15:38:45 +00:00
admin	d77dc205dc	Merge pull request 'feat: CRUD UI — race form, detail fields, edit/delete actions' (#10 ) from feat/phase3-crud-ui into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #10	2026-04-07 15:38:14 +00:00
admin	8a7e87385a	Merge pull request 'docs: fix README dev/production commands, update FRONTEND_PLAN status, remove broken links' (#9 ) from docs/phase2-fix-documentation into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #9	2026-04-07 15:37:41 +00:00
admin	b92fad6939	Merge pull request 'fix: phase 1 bugs — CSS tokens, pluralization, error handling, cross-platform tests' (#8 ) from fix/phase1-bugs-and-critical-fixes into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #8	2026-04-07 15:37:11 +00:00
Anton	7260fb59ea	chore: delete empty features module, fix RaceRow timestamp types Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - Remove dead frontend/src/features/index.ts (empty export, unused) - RaceRow: created_at/updated_at typed as Date to match pg TIMESTAMPTZ runtime - rowToDto: explicit toISOString() conversion instead of relying on JSON.stringify - Mock DB: return Date objects for timestamp fields to match real pg behavior Made-with: Cursor	2026-04-07 18:35:11 +03:00
Anton	4b63af8da5	feat: CRUD UI — race form, detail fields, edit/delete actions Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - RaceDetailsPage: show all non-null fields (officialUrl, startTime, clusterSchedule, bibPickup) - RaceDetailsPage: add edit link and delete button with confirmation banner - RaceFormPage: universal create/edit form with validation, auto-generated id for new races - Router: add /races/new and /races/:raceId/edit routes - AppLayout: add navigation link to create new race - CSS: buttons (primary/secondary/danger), form fields, confirm banner, responsive layout Made-with: Cursor	2026-04-07 18:13:22 +03:00
Anton	f74ce6ed88	docs: fix README dev/production commands, update FRONTEND_PLAN status, remove broken links Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - README: separate dev (npm run dev) and production (npm run build && npm start) steps - FRONTEND_PLAN: mark backend-dependency-task as completed (finishPlace already in API) - Remove dead references to missing agent-frontend-ui-instructions.md from PLAN.md and FRONTEND_PLAN.md Made-with: Cursor	2026-04-07 17:51:02 +03:00
Anton	3b8f41f905	fix: phase 1 bugs — CSS tokens, pluralization, error handling, cross-platform tests Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - Add missing --space-1 CSS token used by filter and detail components - Fix active nav link losing styles on hover (CSS specificity) - Correct Russian day pluralization (21 день, 22 дня, 25 дней) - Show filter error banner even when stale race data is present - Add cross-env for Windows-compatible npm test - Add global JSON error handler in Express for malformed request bodies - Replace stateless mock DB with in-memory store for correct DELETE/UPDATE behavior Made-with: Cursor	2026-04-07 17:46:46 +03:00
admin	b422223c03	Merge pull request 'chore: drop agent/plan docs, unify .env for Docker stack' (#7 ) from chore/cleanup-docker-docs-env into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #7	2026-04-06 21:31:33 +00:00
Vaka.pro	007d899721	chore: drop agent/plan docs, unify .env for Docker stack Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - Remove PLAN/agent instruction files; single root .env.example for DB + API - Stack compose uses env_file .env; delete stack env example duplicate - Refresh README, backend docs, API doc; trim gitignore/dockerignore Made-with: Cursor	2026-04-07 00:30:29 +03:00
admin	2cf01186e9	Merge pull request 'chore(docker): stack compose with env_file, no secrets in repo' (#6 ) from feature/docker-stack into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #6	2026-04-06 20:26:37 +00:00
Vaka.pro	2849b16e36	chore(docker): stack compose with env_file, no secrets in repo Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - docker-compose.stack.env for DB_* and CORS (gitignored) - docker-compose.stack.env.example with placeholders - .dockerignore excludes local stack env from build context Made-with: Cursor	2026-04-06 23:03:45 +03:00
admin	d187bc776e	Merge pull request 'feat: align docs with code, finish_place, registered status, UI filters, tests, CI' (#5 ) from feature/plan-docs-product-tests into main Some checks failed CI / build-and-test (push) Has been cancelled Details Reviewed-on: #5	2026-04-06 19:41:20 +00:00
Vaka.pro	a2dcf67396	feat: align docs with code, finish_place, registered status, UI filters, tests, CI Some checks failed CI / build-and-test (pull_request) Has been cancelled Details - Add PLAN.md and sync backend docs, .env.example, API doc (404 details) - Document mock DB and PORT/API_PORT in docs/backend.md; README monorepo + frontend/.env.example - Migration 002: finish_place column, status registered; mapper and mock DB updated - Frontend: registered status, finishPlace, calendar year/month filters, pace sparkline - Extract createApp for tests; supertest + tsx; GitHub Actions CI Made-with: Cursor	2026-04-06 22:20:31 +03:00
admin	1ffc3a65eb	Merge pull request 'feat(dashboard): add PR by distance and race comparison table' (#4 ) from feat/frontend-task-5-pr-comparison into main Reviewed-on: #4	2026-04-06 16:10:27 +00:00