@mashka818/exam-de-template 1.0.0 → 1.0.2

package/exam-project/client/src/App.jsx

@@ -1,4 +1,38 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/App.jsx
+ * МАРШРУТЫ (react-router). Пункты ДЭ = пути ниже.
+ *   /           → pages/LandingPage.jsx
+ *   /register   → RegisterPage.jsx (п.1)
+ *   /login      → LoginPage.jsx (п.2)
+ *   /requests   → RequestsPage.jsx (п.3)
+ *   /requests/form → RequestFormPage.jsx (п.4)
+ *   /admin      → AdminPage.jsx (п.5)
+ * Новая страница: import + <Route path="..." element={...} />
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * App.jsx — МАРШРУТЫ REACT (react-router-dom)
+ * =============================================================================
+ * Каждый пункт задания ДЭ = отдельный path + страница в pages/
+ *
+ *   п.1  /register         → RegisterPage.jsx
+ *   п.2  /login            → LoginPage.jsx
+ *   п.3  /requests         → RequestsPage.jsx (история + кнопка на форму)
+ *   п.4  /requests/form    → RequestFormPage.jsx (форма заявки)
+ *   п.5  /admin            → AdminPage.jsx (только role=admin)
+ *   /    LandingPage.jsx   — лендинг для всех (гость и после входа по логотипу)
+ *
+ * ProtectedRoute role="user"|"admin" — без токена редирект на /login
+ * /requests/new → редирект на /requests/form (старый путь, можно не трогать)
+ * path="*" → на главную /
+ *
+ * НОВАЯ СТРАНИЦА: import + <Route path="/about" element={...} /> — см. GUIDE_PAGES.md §6
+ * БАНКЕТАМ.НЕТ: пути те же; тексты и логика — в pages/, не здесь
+ * =============================================================================
+ */
 import { Routes, Route, Navigate } from 'react-router-dom';
 import ProtectedRoute from './components/ProtectedRoute.jsx';
 import LandingPage from './pages/LandingPage.jsx';

package/exam-project/client/src/api.js

@@ -1,4 +1,33 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/api.js
+ * ВСЕ запросы к бэкенду. Прокси: client/vite.config.js → localhost:3001
+ * Добавить метод: 1) server/routes/... 2) строка в export const api 3) вызов на странице
+ * Ошибки формы: catch (e) → e.data.errors
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * HTTP-ЗАПРОСЫ К API (все вызовы бэкенда в одном файле)
+ * =============================================================================
+ * Пути /api/... проксируются Vite на localhost:3001 (vite.config.js).
+ * При смене темы endpoints чаще всего те же; меняют тела запросов в routes на сервере.
+ *
+ * TOKEN_KEY — ключ в localStorage; можно не менять.
+ * БАНКЕТАМ.НЕТ: добавить postReview(requestId, { text }) → POST /api/requests/:id/review
+ *
+ * КАК ДОБАВИТЬ НОВЫЙ ЗАПРОС:
+ *   1) Метод в server/routes/...
+ *   2) Строка в export const api = { ... }
+ *   3) Вызов на странице: await api.myMethod(...)
+ *
+ * Ошибки с сервера: catch (err) { err.data?.errors } — объект полей для формы
+ *                     err.data?.message — одна строка (логин неверный)
+ *
+ * GUIDE_PAGES.md §8 | THEME_BANQUETAM_NET.md
+ * =============================================================================
+ */
 
 const TOKEN_KEY = 'exam_token';
 
@@ -41,10 +70,16 @@ export const api = {
   // --- Заявки пользователя → server/routes/requests.js (п.3 mine, п.4 POST) ---
   getMyRequests: () => request('/requests/mine'),
   createRequest: (body) => request('/requests', { method: 'POST', body: JSON.stringify(body) }),
+  // БАНКЕТАМ.НЕТ: postReview: (id, body) => request(`/requests/${id}/review`, { method: 'POST', body: JSON.stringify(body) }),
 
   // --- Админ → server/routes/admin.js (п.5) ---
-
-  adminGetRequests: () => request('/admin/requests'),
+  // params.status: 'all' | 'new' | 'in_progress' | 'completed' | 'cancelled'
+  adminGetRequests: (params = {}) => {
+    const q = new URLSearchParams();
+    if (params.status && params.status !== 'all') q.set('status', params.status);
+    const qs = q.toString();
+    return request(`/admin/requests${qs ? `?${qs}` : ''}`);
+  },
   adminUpdateStatus: (id, body) =>
     request(`/admin/requests/${id}/status`, { method: 'PATCH', body: JSON.stringify(body) }),
 };

package/exam-project/client/src/components/FormField.jsx

@@ -1,4 +1,25 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/FormField.jsx
+ * Обёртка label+input+ошибка. Менять label на страницах, не здесь.
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * FormField.jsx — ПОЛЕ ФОРМЫ (label + input + ошибка)
+ * =============================================================================
+ * САМ КОМПОНЕНТ не меняют. Меняют на страницах (RegisterPage, RequestFormPage):
+ *   <FormField label="ФИО" error={errors.fullName}>
+ *     <input ... />
+ *   </FormField>
+ *
+ * error={errors.xxx} — текст с validateRegistration / validateRequestForm (validation.js).
+ * Добавить новое поле: label + children (input/select/textarea) + ключ в errors на странице.
+ *
+ * GUIDE_PAGES.md §2.4, §7.1
+ * =============================================================================
+ */
 export default function FormField({ label, error, children, className = '' }) {
   return (
     <label className={`block mb-4 ${className}`}>

package/exam-project/client/src/components/Layout.jsx

@@ -1,12 +1,42 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/Layout.jsx
+ * Шапка всех страниц кроме лендинга. Менять: brandName, brandTagline, headerStyles, logo в images.js
+ * variant со страницы: register | login | dashboard | admin
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * LAYOUT — общая обёртка всех страниц (шапка + контент)
+ * =============================================================================
+ * ЗАМЕНИТЕ при другой теме:
+ *   brandName    — название портала («Мой Не Сам» → «Автосервис», «Курсы»…)
+ *   brandTagline — короткий слоган под логотипом
+ *   headerStyles — цвета шапки по разделам (каждый раздел — своя «черта» по заданию)
+ *   logo         — картинка в config/images.js → file: 'logo.png'
+ *
+ * АДАПТИВ (мобильный / ПК):
+ *   Сейчас: max-w-lg — узкая колонка (~390–512px), как макет 390×844.
+ *   Для ПК добавьте lg:max-w-5xl lg:px-8 к header и main (см. RESPONSIVE.md).
+ * БАНКЕТАМ.НЕТ: brandName = 'Банкетам.Нет'; brandTagline = 'Бронирование банкетных залов'.
+ *
+ * variant со страницы: register | login | dashboard | admin | default
+ *   → разный цвет шапки (отличительные черты по заданию)
+ * UserNav — только user + variant dashboard (п.3/п.4 в шапке)
+ * Link to="/" на логотипе — после входа возврат на лендинг
+ *
+ * GUIDE_PAGES.md §2 | RESPONSIVE.md (max-w-lg / lg:max-w-5xl)
+ * =============================================================================
+ */
 import { Link, useNavigate } from 'react-router-dom';
 import { useAuth } from '../context/AuthContext.jsx';
 import PageImage from './PageImage.jsx';
 import UserNav from './UserNav.jsx';
 
 // --- Тексты бренда (менять на экзамене в первую очередь) ---
-const brandName = 'Мой Не Сам';
-const brandTagline = 'Клининг без хлопот';
+const brandName = 'Мой Не Сам'; // БАНКЕТАМ.НЕТ: 'Банкетам.Нет'
+const brandTagline = 'Клининг без хлопот'; // БАНКЕТАМ.НЕТ: 'Бронирование банкетных залов'
 
 // --- Стили шапки: variant передаётся со страницы (register, login, dashboard, admin) ---
 const headerStyles = {
@@ -23,7 +53,7 @@ export default function Layout({ children, variant = 'default' }) {
 
   return (
     <div className="min-h-screen flex flex-col">
-      
+      {/* === ШАПКА: логотип-картинка + название === */}
       <header className={`${headerStyles[variant]} shadow-sm animate-fade-up`}>
         <div className="mx-auto w-full max-w-lg lg:max-w-5xl px-4 lg:px-8 py-3 flex items-center justify-between gap-3">
           <Link to="/" className="flex items-center gap-2 min-w-0">
@@ -52,7 +82,7 @@ export default function Layout({ children, variant = 'default' }) {
         </div>
       </header>
 
-      
+      {/* max-w-lg — мобильный макет; lg:max-w-5xl — шире на ПК (см. RESPONSIVE.md) */}
       <main className="flex-1 mx-auto w-full max-w-lg lg:max-w-5xl px-4 lg:px-8 py-6 lg:py-10">
         {children}
       </main>

package/exam-project/client/src/components/PageImage.jsx

@@ -1,4 +1,27 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/PageImage.jsx
+ * Картинки: <PageImage imageKey="logo" />. Ключи в config/images.js
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * PageImage.jsx — КАРТИНКА НА СТРАНИЦЕ (единый способ)
+ * =============================================================================
+ * КАК МЕНЯТЬ КАРТИНКУ:
+ *   1) Файл в client/public/images/ (например banner.png)
+ *   2) Запись в client/src/config/images.js: myKey: { file: 'banner.png', alt: '...' }
+ *   3) На странице: <PageImage imageKey="myKey" className="w-full h-40 object-cover" />
+ *
+ * НЕ пишите <img src="/images/..."> напрямую в pages — иначе на экзамене запутаетесь.
+ *
+ * className — размер: h-9 (логотип), h-40 (баннер), rounded-full (аватар в футере).
+ * onError — скрывает битую картинку; при отладке временно закомментируйте.
+ *
+ * GUIDE_PAGES.md §3 | БАНКЕТАМ.НЕТ: slide-1…4, footer-photo-1…3
+ * =============================================================================
+ */
 import { imageAlt, imageUrl } from '../config/images.js';
 
 export default function PageImage({ imageKey, className = 'w-full h-auto rounded-xl object-cover' }) {

package/exam-project/client/src/components/ProtectedRoute.jsx

@@ -1,4 +1,26 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/ProtectedRoute.jsx
+ * Защита маршрутов. role="user" | "admin". Без входа → /login
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * ЗАЩИТА МАРШРУТОВ — только для авторизованных
+ * =============================================================================
+ * role="user"  — обычный заказчик (/requests)
+ * role="admin" — панель админа (/admin)
+ * При другой теме роли те же: user | admin (server/db/schema.sql users.role)
+ * БАНКЕТАМ.НЕТ: user → /requests (личный кабинет), admin → /admin
+ *
+ * loading — пока читается токен из localStorage и вызывается /api/auth/me
+ * !user — гость → /login
+ * user.role !== role — админ зашёл на /requests → редирект на /admin и наоборот
+ *
+ * Менять редко. Новый раздел «только для менеджера» — добавить role в БД + сюда.
+ * =============================================================================
+ */
 import { Navigate } from 'react-router-dom';
 import { useAuth } from '../context/AuthContext.jsx';
 

package/exam-project/client/src/components/UserNav.jsx

@@ -1,4 +1,24 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/UserNav.jsx
+ * Вкладки в шапке заказчика: /requests и /requests/form. Менять подписи ссылок.
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * UserNav.jsx — ВКЛАДКИ В ШАПКЕ (только заказчик, variant="dashboard")
+ * =============================================================================
+ * Показывается в Layout.jsx когда user.role === 'user' и variant === 'dashboard'.
+ * NavLink подсвечивает активный раздел (isActive → bg-white/30).
+ *
+ * ЗАМЕНИТЕ: текст ссылок и title (подсказка при наведении).
+ * Пути /requests и /requests/form — по заданию ДЭ, обычно не меняют.
+ *
+ * БАНКЕТАМ.НЕТ: «Личный кабинет» → /requests; «Новое бронирование» → /requests/form
+ * GUIDE_PAGES.md §2.3
+ * =============================================================================
+ */
 import { NavLink } from 'react-router-dom';
 
 const linkClass = ({ isActive }) =>

package/exam-project/client/src/components/landing/HeroSlider.jsx

@@ -1,8 +1,29 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/landing/HeroSlider.jsx
+ * Слайдер лендинга. SLIDE_KEYS + slideText + PNG slide-1… в images.js. Интервал setInterval (Банкетам: 3000, 4 слайда).
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * HeroSlider.jsx — СЛАЙДЕР НА ЛЕНДИНГЕ (модуль 2 / М2)
+ * =============================================================================
+ * 1) SLIDE_KEYS — ключи из config/images.js (slide1, slide2…)
+ * 2) slideText — заголовок и подзаголовок на каждом слайде
+ * 3) public/images/slide-1.png … — файлы картинок (имена в images.js → file)
+ * 4) setInterval — автопрокрутка (БАНКЕТАМ.НЕТ: 3000 мс, 4 слайда)
+ *
+ * Кнопки ‹ › и точки внизу — переключение вручную (go, setIndex).
+ * БАНКЕТАМ.НЕТ: скопировать <HeroSlider /> в RequestsPage для п.3
+ *
+ * GUIDE_PAGES.md §3.2 | config/images.js (slide1…slide4)
+ * =============================================================================
+ */
 import { useEffect, useState } from 'react';
 import { imageAlt, imageUrl } from '../../config/images.js';
 
-const SLIDE_KEYS = ['slide1', 'slide2', 'slide3'];
+const SLIDE_KEYS = ['slide1', 'slide2', 'slide3']; // БАНКЕТАМ.НЕТ: добавить 'slide4'
 
 const slideText = {
   slide1: { title: 'Общий клининг', subtitle: 'Поддерживаем порядок регулярно' },
@@ -16,7 +37,7 @@ export default function HeroSlider() {
   useEffect(() => {
     const timer = setInterval(() => {
       setIndex((i) => (i + 1) % SLIDE_KEYS.length);
-    }, 5000);
+    }, 5000); // БАНКЕТАМ.НЕТ: 3000
     return () => clearInterval(timer);
   }, []);
 

package/exam-project/client/src/components/landing/LandingLayout.jsx

@@ -1,9 +1,31 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/landing/LandingLayout.jsx
+ * Шапка лендинга /. brandName, ссылки Вход/Регистрация.
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * LandingLayout.jsx — ШАПКА ЛЕНДИНГА (без Layout.jsx)
+ * =============================================================================
+ * Отдельная шапка для главной / — не путать с Layout на /register, /login…
+ * Клик по логотипу → всегда / (даже если пользователь вошёл).
+ *
+ * Гость: кнопки «Вход» / «Регистрация»
+ * user: ссылка в кабинет (/requests или /admin) + «Выйти»
+ *
+ * ЗАМЕНИТЕ: brandName, cabinetLabel («Мои заявки» → «Личный кабинет»)
+ * БАНКЕТАМ.НЕТ: brandName = 'Банкетам.Нет'
+ *
+ * GUIDE_PAGES.md §5 (лендинг)
+ * =============================================================================
+ */
 import { Link } from 'react-router-dom';
 import PageImage from '../PageImage.jsx';
 import { useAuth } from '../../context/AuthContext.jsx';
 
-const brandName = 'Мой Не Сам';
+const brandName = 'Мой Не Сам'; // БАНКЕТАМ.НЕТ: 'Банкетам.Нет'
 
 export default function LandingLayout({ children }) {
   const { user, logout } = useAuth();

package/exam-project/client/src/components/landing/SiteFooter.jsx

@@ -1,4 +1,24 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/landing/SiteFooter.jsx
+ * Подвал лендинга. footerPhoto1-3 в images.js. Тексты компании.
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * SiteFooter.jsx — ПОДВАЛ ЛЕНДИНГА
+ * =============================================================================
+ * Три круглых фото: imageKey footerPhoto1, footerPhoto2, footerPhoto3
+ *   → PNG в client/public/images/ → записи в config/images.js
+ *
+ * footerLinks — якоря (сейчас все на /; можно сделать id секций на LandingPage)
+ * ЗАМЕНИТЕ: название компании, описание, copyright год
+ *
+ * БАНКЕТАМ.НЕТ: «Банкетам.Нет», текст про банкетные залы
+ * GUIDE_PAGES.md §5.3
+ * =============================================================================
+ */
 import { Link } from 'react-router-dom';
 import PageImage from '../PageImage.jsx';
 

package/exam-project/client/src/config/images.js

@@ -1,4 +1,33 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/config/images.js
+ * КАРТИНКИ: только менять file и alt. Файлы PNG лежат в client/public/images/
+ * На экзамене: экспорт Figma → тот же файл (logo.png, slide-1.png…). Пути в коде не пишем — PageImage imageKey
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * КОНФИГУРАЦИЯ ИЗОБРАЖЕНИЙ
+ * =============================================================================
+ * Все картинки лежат в: client/public/images/
+ * В коде подключаются через URL: /images/имя-файла
+ *
+ * НА ЭКЗАМЕНЕ:
+ * 1) Экспорт из Figma → PNG в public/images/ (только PNG, не SVG)
+ * 2) Имя файла как ниже (logo.png, slide-1.png…) — замените файл, config не трогайте
+ * 3) alt — для доступности; замените текст под новую тему
+ * БАНКЕТАМ.НЕТ: slide4; alt про банкеты/залы; logo «Банкетам.Нет»
+ *
+ * Ключ (logo, slide1…) — НЕ переименовывайте без правки PageImage imageKey на страницах
+ * file — имя файла в public/images/
+ * imageUrl('logo') / imageAlt('logo') — если нужен прямой доступ без PageImage
+ *
+ * Слайды: slide-1.png … slide-4.png | Футер: footer-photo-1.png …
+ *
+ * GUIDE_PAGES.md §3 | PageImage.jsx
+ * =============================================================================
+ */
 
 /** Базовый путь. Менять не нужно, если папка называется images */
 export const IMAGES_BASE = '/images';
@@ -10,64 +39,54 @@ export const IMAGES_BASE = '/images';
 export const IMAGES = {
   // Шапка на всех страницах → логотип компании / портала
   logo: {
-    file: 'logo.svg',
-    alt: 'Логотип «Мой Не Сам»', // → название вашей организации
+    file: 'logo.png',
+    alt: 'Логотип «Мой Не Сам»',
   },
 
-  // Главная (/) — иллюстрация услуги
   homeHero: {
-    file: 'home-hero.svg',
+    file: 'home-hero.png',
     alt: 'Клининговые услуги на дому',
   },
 
-  // Регистрация (/register)
   registerBanner: {
-    file: 'register-banner.svg',
+    file: 'register-banner.png',
     alt: 'Регистрация нового заказчика',
   },
 
-  // Вход (/login)
   loginBanner: {
-    file: 'login-banner.svg',
+    file: 'login-banner.png',
     alt: 'Вход в личный кабинет',
   },
 
-  // Список заявок (/requests)
   requestsBanner: {
-    file: 'requests-banner.svg',
+    file: 'requests-banner.png',
     alt: 'История заявок на уборку',
   },
 
-  // Новая заявка (/requests/new)
   newRequestBanner: {
-    file: 'new-request-banner.svg',
+    file: 'new-request-banner.png',
     alt: 'Оформление заявки на услугу',
   },
 
-  // Админ-панель (/admin)
   adminBanner: {
-    file: 'admin-banner.svg',
+    file: 'admin-banner.png',
     alt: 'Панель администратора',
   },
 
-  // Пустой список заявок
   emptyRequests: {
-    file: 'empty-requests.svg',
+    file: 'empty-requests.png',
     alt: 'Заявок пока нет',
   },
 
-  // --- Лендинг: слайдер (HeroSlider.jsx) ---
-  slide1: { file: 'slide-1.svg', alt: 'Общий клининг' },
-  slide2: { file: 'slide-2.svg', alt: 'Генеральная уборка' },
-  slide3: { file: 'slide-3.svg', alt: 'Химчистка ковров и мебели' },
+  slide1: { file: 'slide-1.png', alt: 'Общий клининг' },
+  slide2: { file: 'slide-2.png', alt: 'Генеральная уборка' },
+  slide3: { file: 'slide-3.png', alt: 'Химчистка ковров и мебели' },
 
-  // Лендинг: блок «О клининге»
-  aboutCleaning: { file: 'about-cleaning.svg', alt: 'Профессиональный клининг' },
+  aboutCleaning: { file: 'about-cleaning.png', alt: 'Профессиональный клининг' },
 
-  // Лендинг: футер — 3 фото (команда / офис / работы)
-  footerPhoto1: { file: 'footer-photo-1.svg', alt: 'Сотрудник 1' },
-  footerPhoto2: { file: 'footer-photo-2.svg', alt: 'Сотрудник 2' },
-  footerPhoto3: { file: 'footer-photo-3.svg', alt: 'Сотрудник 3' },
+  footerPhoto1: { file: 'footer-photo-1.png', alt: 'Сотрудник 1' },
+  footerPhoto2: { file: 'footer-photo-2.png', alt: 'Сотрудник 2' },
+  footerPhoto3: { file: 'footer-photo-3.png', alt: 'Сотрудник 3' },
 };
 
 /** Собрать полный URL для тега <img src="..."> */

package/exam-project/client/src/constants/services.js

@@ -1,6 +1,25 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/constants/services.js
+ * Подписи услуг на лендинге. Синхронизировать с server/db/seed.sql
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * constants/services.js — НАЗВАНИЯ УСЛУГ НА ЛЕНДИНГЕ (только отображение)
+ * =============================================================================
+ * Реальный список для формы п.4 берётся из API GET /api/services (seed.sql).
+ * Этот массив — для блока «Наши услуги» на LandingPage.jsx.
+ *
+ * При смене темы: обновите И seed.sql И этот файл одинаковым списком.
+ * БАНКЕТАМ.НЕТ: четыре помещения (зал, ресторан, веранды)
+ *
+ * GUIDE_PAGES.md §5.2 | server/db/seed.sql
+ * =============================================================================
+ */
 export const DEFAULT_SERVICE_NAMES = [
-  'Общий клининг',
+  'Общий клининг', // БАНКЕТАМ.НЕТ: заменить весь массив на 4 помещения
   'Генеральная уборка',
   'Послестроительная уборка',
   'Химчистка ковров и мебели',

package/exam-project/client/src/context/AuthContext.jsx

@@ -1,4 +1,29 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/context/AuthContext.jsx
+ * login / register / logout / user. JWT в localStorage (api.js TOKEN_KEY).
+ * После входа: user.role → 'user' | 'admin'
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * КОНТЕКСТ АВТОРИЗАЦИИ — user, login, register, logout
+ * =============================================================================
+ * Хранит JWT в localStorage (api.js setToken).
+ * При смене темы логика не меняется; поля user приходят с сервера (fullName, role…).
+ *
+ * КАК РАБОТАЕТ:
+ *   login/register → api.js → setToken в localStorage → setUser
+ *   logout → очистка токена → редирект на /login (на странице)
+ *   user.role: 'user' | 'admin' — после входа Admin26 попадёт в /admin (см. LoginPage navigate)
+ *
+ * useAuth() на страницах: const { user, login, register, logout } = useAuth();
+ * БАНКЕТАМ.НЕТ: без изменений, если структура users та же.
+ *
+ * GUIDE_PAGES.md §7 | api.js
+ * =============================================================================
+ */
 import { createContext, useContext, useEffect, useState } from 'react';
 import { api, getToken, setToken } from '../api.js';
 

package/exam-project/client/src/index.css

@@ -1,6 +1,33 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/index.css
+ * Цвета бренда: @theme --color-brand. Анимации: animate-fade-up, animate-slide-in.
+ * Ошибки полей: .field-error, .input-error на input
+ * =============================================================================
+ */
+
 @import 'tailwindcss';
 
-
+/**
+ * =============================================================================
+ * ГЛОБАЛЬНЫЕ СТИЛИ
+ * =============================================================================
+ * @theme — цвета бренда (ЗАМЕНИТЕ --color-brand под новую тему)
+ * .animate-* — анимации для модуля №3
+ * .field-error / .input-error — ошибки валидации на формах
+ *
+ * АДАПТИВ: ширина колонки задаётся в Layout.jsx (max-w-lg + lg:max-w-5xl).
+ * Подробная инструкция — файл RESPONSIVE.md в корне проекта.
+ * БАНКЕТАМ.НЕТ (М3): микроанимации уже есть; цвета @theme можно сменить на «банкетную» палитру.
+ *
+ * КАК ПОДКЛЮЧИТЬ К СТРАНИЦЕ:
+ *   animate-fade-up на блоках (Layout header, карточки)
+ *   .field-error на <p> под полем; .input-error на <input> при ошибке
+ *   className="input-error" — см. RegisterPage inputClass + errors
+ *
+ * GUIDE_PAGES.md §3.3 | COMMENTS_GUIDE.md
+ * =============================================================================
+ */
 
 @theme {
   --color-brand: #0d9488;

package/exam-project/client/src/main.jsx

@@ -1,4 +1,23 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/main.jsx
+ * ТОЧКА ВХОДА React. Обычно НЕ МЕНЯЮТ.
+ * Цепочка: index.html #root → main.jsx → AuthProvider → App.jsx
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * main.jsx — ТОЧКА ВХОДА REACT (запуск приложения в браузере)
+ * =============================================================================
+ * Обычно НЕ МЕНЯЮТ при смене темы.
+ *
+ * Цепочка: index.html (#root) → main.jsx → AuthProvider → App.jsx (маршруты).
+ *
+ * Если добавили глобальный контекст (тема, язык) — оберните <App /> ещё одним Provider.
+ * Подробнее: GUIDE_PAGES.md §6 (новая страница — маршрут всё равно в App.jsx).
+ * =============================================================================
+ */
 import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
 import { BrowserRouter } from 'react-router-dom';