chore: delete empty features module, fix RaceRow timestamp types

- 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
feat: CRUD UI — race form, detail fields, edit/delete actions
2026-04-07 18:35:11 +03:00 · 2026-04-07 18:13:22 +03:00 · 2026-04-07 17:51:02 +03:00
11 changed files with 731 additions and 38 deletions
--- a/FRONTEND_PLAN.md
+++ b/FRONTEND_PLAN.md
@@ -1,7 +1,7 @@
 ---

 name: Frontend implementation plan
-overview: Собрать минималистичный frontend для календаря забегов по UI-инструкции, строго в рамках текущего API-контракта, с отдельной внешней задачей на недостающие backend-поля для completed-забегов.
+overview: Собрать минималистичный frontend для календаря забегов по UI-инструкции, строго в рамках текущего API-контракта.
 todos:

 - id: frontend-structure
@@ -20,8 +20,8 @@ status: completed
 content: Сделать блок PR и сравнение стартов с fallback для отсутствующего поля place
 status: completed
 - id: backend-dependency-task
-content: Подготовить отдельную задачу для другого агента на расширение API полем place и последующую интеграцию во frontend
-status: pending
+content: "Расширение API полем finishPlace: миграция 002, маппер, DTO, фронтенд-интеграция — выполнено"
+status: completed
 isProject: false

 ---
@@ -30,7 +30,7 @@ isProject: false

 ## Исходные опоры

- UI и UX принципы берём строго из [d:\vaka.pro\calendar_run\agent-frontend-ui-instructions.md](d:/vaka.pro/calendar_run/agent-frontend-ui-instructions.md): минимализм, воздух, акцент на данных, спокойная палитра, быстрые сценарии.
+- UI и UX принципы: минимализм, воздух, акцент на данных, спокойная палитра, быстрые сценарии (дизайн-токены в `frontend/src/styles/tokens.css`).
 - Продуктовые ограничения и структура экранов сверяем с [d:\vaka.pro\calendar_run\PLAN.md](d:/vaka.pro/calendar_run/PLAN.md).
 - Интеграционный контракт берём из [d:\vaka.pro\calendar_run\docs\backend-api-for-frontend.md](d:/vaka.pro/calendar_run/docs/backend-api-for-frontend.md).
 - Общий контекст запуска/окружения — [d:\vaka.pro\calendar_run\README.md](d:/vaka.pro/calendar_run/README.md) и [d:\vaka.pro\calendar_run\docs\backend.md](d:/vaka.pro/calendar_run/docs/backend.md).
@@ -40,7 +40,7 @@ isProject: false
 - Только frontend + интеграция с текущим API.
 - Статус `зарегистрирован` трактуется как UI-вариант `planned` (без изменения backend-контракта).
 - Для completed-забегов обязательно показываем `темп`; считаем на фронте из `finishTime` и `distanceKm`.
- Для completed-забегов поле `место` обязательно по UX, но в API отсутствует: выделяем отдельную задачу другому агенту на расширение backend (`place`) и считаем это внешней зависимостью.
+- Для completed-забегов поле `место` (`finishPlace`) доступно в API (миграция 002, маппер, DTO); фронтенд отображает его в карточке и таблице сравнения.

 ## Архитектура frontend

@@ -61,14 +61,13 @@ isProject: false
  - Переключение `Будущие` / `Прошедшие`.
  - Карточка старта: `title`, `date`, `distanceKm`, статус-лейбл.
 - Карточка старта:
-  - Базовые поля + `finishTime`, вычисляемый `pace`, `notes`.
-  - `place` — вывод включается после backend-расширения.
+  - Базовые поля + `finishTime`, вычисляемый `pace`, `finishPlace`, `notes`.
 - PR блок:
  - Дистанции: 5K, 10K, 21.1, 42.2 (согласно UI-инструкции).
  - Расчёт по completed-забегам с валидным `finishTime`.
 - Сравнение стартов (ключевая фича):
-  - Таблица/карточки по годам с `time`, `pace`, `place`.
-  - До появления `place` в API — graceful-degradation: колонка в состоянии «нет данных».
+  - Таблица/карточки по годам с `time`, `pace`, `finishPlace`.
+  - Если `finishPlace` не заполнено — graceful-degradation: колонка в состоянии «нет данных».

 ## UX и визуальные требования

@@ -78,10 +77,10 @@ isProject: false
 - Консистентные состояния загрузки/ошибок/пустых данных.
 - A11y-базис: фокус-стили, клавиатурная навигация, контраст, корректная разметка интерактивных элементов.

-## Отдельная зависимая задача (другой агент)
+## Зависимая задача (выполнена)

- Создать отдельную backend-задачу: добавить поле `place` в модель `Race` (миграция + API + документация контракта).
- После доставки backend-изменения: обновить frontend-типы, формы и блок сравнения, заменить placeholder на реальное значение.
+- Поле `finishPlace` добавлено в модель `Race`: миграция `002_finish_place_and_registered_status.sql`, маппер `race.ts`, DTO, API-документация.
+- Frontend-типы, карточка и блок сравнения используют `finishPlace`.

 ## Порядок реализации

@@ -91,7 +90,6 @@ isProject: false
 4. Реализовать карточку старта с вычислением `pace` на клиенте.
 5. Реализовать PR и блок сравнения стартов с fallback для `place`.
 6. Добавить состояния пустых данных/ошибок/загрузки и а11y-полировку.
-7. Подготовить handoff-note с зависимостью на backend-задачу (`place`) и интеграционным чеклистом.

 ## Definition of Done для frontend

@@ -99,4 +97,4 @@ isProject: false
 - API-интеграция работает по текущему контракту без локальных обходов хранилища.
 - `pace` считается корректно для completed-забегов.
 - `registered` не ломает модель: визуально интерпретируется в рамках `planned`.
- Для `place` есть явная внешняя задача и безопасный fallback в UI.
+- `finishPlace` интегрирован; при отсутствии значения — безопасный fallback в UI.
--- a/PLAN.md
+++ b/PLAN.md
@@ -55,7 +55,7 @@ PostgreSQL: `snake_case` столбцы, маппинг в `[backend/src/mappers
 - Маршруты: дашборд (`/`), список стартов (`/races`), карточка (`/races/:id`).
 - Дашборд: ближайший старт, последний результат, PR, сезон, PR по ключевым дистанциям, сравнение завершённых стартов, при необходимости — лёгкая визуализация прогресса.
 - Список: будущие / прошедшие; фильтрация по году и месяцу через API.
- Стили: BEM и дизайн-токены; ориентир по духу — `[agent-frontend-ui-instructions.md](agent-frontend-ui-instructions.md)`.
+- Стили: BEM и дизайн-токены (см. `frontend/src/styles/tokens.css`).

 ## Критерии готовности текущей итерации

--- a/README.md
+++ b/README.md
@@ -14,7 +14,8 @@
 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. `npm run build && npm run dev`
+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 не использовать**.

--- 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] ?? ""),
@@ -108,7 +108,7 @@ function createMockPool(): Pool {
      if (!existing) {
        return emptyResult();
      }
-      const updated = { ...existing, updated_at: new Date().toISOString() };
+      const updated = { ...existing, updated_at: new Date() };
      store.set(id, updated);
      return {
        rows: [updated as unknown as T],
--- a/backend/src/mappers/race.ts
+++ b/backend/src/mappers/race.ts
@@ -1,4 +1,7 @@
-/** 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;
@@ -13,8 +16,8 @@ export interface RaceRow {
  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). */
@@ -36,6 +39,10 @@ export interface RaceDto {
  updatedAt: string | null;
 }

+function toISOString(value: Date | string): string {
+  return value instanceof Date ? value.toISOString() : String(value);
+}
+
 /** Convert a DB row to the API DTO (camelCase). */
 export function rowToDto(row: RaceRow): RaceDto {
  return {
@@ -52,8 +59,8 @@ export function rowToDto(row: RaceRow): RaceDto {
    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,
  };
 }

--- a/frontend/src/app/layouts/AppLayout.tsx
+++ b/frontend/src/app/layouts/AppLayout.tsx
@@ -23,6 +23,14 @@ export function AppLayout(): JSX.Element {
          >
            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">
--- 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/features/index.ts
+++ b/frontend/src/features/index.ts
@@ -1 +0,0 @@
-export {};
--- a/frontend/src/pages/RaceDetailsPage.tsx
+++ b/frontend/src/pages/RaceDetailsPage.tsx
@@ -1,6 +1,6 @@
-import { useEffect, useMemo, useState } from "react";
-import { Link, useParams } from "react-router-dom";
-import { ApiError, getRaceById } from "../api";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { Link, useNavigate, useParams } from "react-router-dom";
+import { ApiError, deleteRace, getRaceById } from "../api";
 import {
  formatDistance,
  formatRaceDate,
@@ -17,11 +17,44 @@ 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(() => {
    let isMounted = true;
@@ -65,6 +98,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">
@@ -100,6 +149,43 @@ export function RaceDetailsPage(): JSX.Element {
        <span className={getRaceStatusClassName(race.status)}>{getRaceStatusLabel(race.status)}</span>
      </div>

+      <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,11 +202,16 @@ export function RaceDetailsPage(): JSX.Element {
              <dt className="race-details-meta__key">Статус</dt>
              <dd className="race-details-meta__value">{getRaceStatusLabel(race.status)}</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">
@@ -131,16 +222,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.finishPlace?.trim() ? race.finishPlace : "не указано"}
-                </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,421 @@
+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 {
+  return {
+    date: race.date,
+    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://example.com"
+            />
+          </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/styles/global.css
+++ b/frontend/src/styles/global.css
@@ -408,6 +408,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,
@@ -418,4 +587,9 @@ a {
  .race-details-header {
    flex-direction: column;
  }
+
+  .race-form__actions {
+    flex-direction: column;
+    align-items: stretch;
+  }
 }