@mashka818/exam-de-template 1.0.1 → 1.0.2

package/exam-guides/commented-code/client/src/App.jsx

@@ -1,3 +1,17 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: 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)

package/exam-guides/commented-code/client/src/api.js

@@ -1,3 +1,12 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: 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 (все вызовы бэкенда в одном файле)
@@ -64,8 +73,13 @@ export const api = {
   // БАНКЕТАМ.НЕТ: postReview: (id, body) => request(`/requests/${id}/review`, { method: 'POST', body: JSON.stringify(body) }),
 
   // --- Админ → server/routes/admin.js (п.5) ---
-  // БАНКЕТАМ.НЕТ: adminGetRequests: (params) => request(`/admin/requests?status=${params.status}`)
-  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-guides/commented-code/client/src/components/FormField.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/FormField.jsx
+ * Обёртка label+input+ошибка. Менять label на страницах, не здесь.
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * FormField.jsx — ПОЛЕ ФОРМЫ (label + input + ошибка)

package/exam-guides/commented-code/client/src/components/Layout.jsx

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/Layout.jsx
+ * Шапка всех страниц кроме лендинга. Менять: brandName, brandTagline, headerStyles, logo в images.js
+ * variant со страницы: register | login | dashboard | admin
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * LAYOUT — общая обёртка всех страниц (шапка + контент)

package/exam-guides/commented-code/client/src/components/PageImage.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/PageImage.jsx
+ * Картинки: <PageImage imageKey="logo" />. Ключи в config/images.js
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * PageImage.jsx — КАРТИНКА НА СТРАНИЦЕ (единый способ)

package/exam-guides/commented-code/client/src/components/ProtectedRoute.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/ProtectedRoute.jsx
+ * Защита маршрутов. role="user" | "admin". Без входа → /login
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * ЗАЩИТА МАРШРУТОВ — только для авторизованных

package/exam-guides/commented-code/client/src/components/UserNav.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/UserNav.jsx
+ * Вкладки в шапке заказчика: /requests и /requests/form. Менять подписи ссылок.
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * UserNav.jsx — ВКЛАДКИ В ШАПКЕ (только заказчик, variant="dashboard")

package/exam-guides/commented-code/client/src/components/landing/HeroSlider.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/landing/HeroSlider.jsx
+ * Слайдер лендинга. SLIDE_KEYS + slideText + PNG slide-1… в images.js. Интервал setInterval (Банкетам: 3000, 4 слайда).
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * HeroSlider.jsx — СЛАЙДЕР НА ЛЕНДИНГЕ (модуль 2 / М2)

package/exam-guides/commented-code/client/src/components/landing/LandingLayout.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/landing/LandingLayout.jsx
+ * Шапка лендинга /. brandName, ссылки Вход/Регистрация.
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * LandingLayout.jsx — ШАПКА ЛЕНДИНГА (без Layout.jsx)

package/exam-guides/commented-code/client/src/components/landing/SiteFooter.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/components/landing/SiteFooter.jsx
+ * Подвал лендинга. footerPhoto1-3 в images.js. Тексты компании.
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * SiteFooter.jsx — ПОДВАЛ ЛЕНДИНГА

package/exam-guides/commented-code/client/src/config/images.js

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/config/images.js
+ * КАРТИНКИ: только менять file и alt. Файлы PNG лежат в client/public/images/
+ * На экзамене: экспорт Figma → тот же файл (logo.png, slide-1.png…). Пути в коде не пишем — PageImage imageKey
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * КОНФИГУРАЦИЯ ИЗОБРАЖЕНИЙ
@@ -6,8 +14,8 @@
  * В коде подключаются через URL: /images/имя-файла
  *
  * НА ЭКЗАМЕНЕ:
- * 1) Экспорт из Figma → PNG в public/images/
- * 2) Если имя файла другое — поменяйте только этот файл
+ * 1) Экспорт из Figma → PNG в public/images/ (только PNG, не SVG)
+ * 2) Имя файла как ниже (logo.png, slide-1.png…) — замените файл, config не трогайте
  * 3) alt — для доступности; замените текст под новую тему
  * БАНКЕТАМ.НЕТ: slide4; alt про банкеты/залы; logo «Банкетам.Нет»
  *
@@ -31,64 +39,54 @@ export const IMAGES_BASE = '/images';
 export const IMAGES = {
   // Шапка на всех страницах → логотип компании / портала
   logo: {
-    file: 'logo.svg', // ЗАМЕНИТЕ на logo.png после экспорта из Figma
-    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-guides/commented-code/client/src/constants/services.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/constants/services.js
+ * Подписи услуг на лендинге. Синхронизировать с server/db/seed.sql
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * constants/services.js — НАЗВАНИЯ УСЛУГ НА ЛЕНДИНГЕ (только отображение)

package/exam-guides/commented-code/client/src/context/AuthContext.jsx

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/context/AuthContext.jsx
+ * login / register / logout / user. JWT в localStorage (api.js TOKEN_KEY).
+ * После входа: user.role → 'user' | 'admin'
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * КОНТЕКСТ АВТОРИЗАЦИИ — user, login, register, logout

package/exam-guides/commented-code/client/src/index.css

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/index.css
+ * Цвета бренда: @theme --color-brand. Анимации: animate-fade-up, animate-slide-in.
+ * Ошибки полей: .field-error, .input-error на input
+ * =============================================================================
+ */
+
 @import 'tailwindcss';
 
 /**

package/exam-guides/commented-code/client/src/main.jsx

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/main.jsx
+ * ТОЧКА ВХОДА React. Обычно НЕ МЕНЯЮТ.
+ * Цепочка: index.html #root → main.jsx → AuthProvider → App.jsx
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * main.jsx — ТОЧКА ВХОДА REACT (запуск приложения в браузере)

package/exam-guides/commented-code/client/src/pages/AdminPage.jsx

@@ -1,50 +1,56 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/AdminPage.jsx | URL: /admin | п.5
+ * Фильтр filterStatus → api.adminGetRequests({ status }). Кнопки статусов → PATCH.
+ * Сервер: server/routes/admin.js
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * АДМИН-ПАНЕЛЬ (/admin) — п.5 задания ДЭ
  * =============================================================================
- * ЗАМЕНИТЕ:
- *   логин/пароль админа — server/db/init.js (seedAdmin)
- *   кнопки статусов — должны совпадать с CHECK в schema.sql
- *   API — PATCH /api/admin/requests/:id/status
- *   картинку — admin-banner
- * Отличительная черта: фиолетовая шапка (variant="admin")
- * БАНКЕТАМ.НЕТ (п.5): кнопки только «Банкет назначен» / «Банкет завершен»; без «Отменить».
- * БАНКЕТАМ.НЕТ (М2): useState filterStatus, sortBy, page — select + table + «Страница 1 из N».
- * БАНКЕТАМ.НЕТ: toast/alert при успешной смене статуса (message уже есть).
- *
- * load(): adminGetRequests() — таблица всех заявок
- * updateStatus(id, status): PATCH /api/admin/requests/:id/status
- * cancelled + cancelReason — для клининга; БАНКЕТАМ.НЕТ убрать кнопку «Отменить»
+ * ФИЛЬТР ПО СТАТУСУ:
+ *   filterStatus — значение select (all / new / in_progress / completed / cancelled)
+ *   load() → api.adminGetRequests({ status }) → GET /api/admin/requests?status=...
+ *   На сервере: server/routes/admin.js — WHERE r.status = $1
  *
- * ФИЛЬТР/СОРТ/СТРАНИЦЫ (М2): готовый пример кода — GUIDE_PAGES.md §8.4
- *   filterStatus state → query ?status= на сервере → admin.js WHERE
- *
- * GUIDE_PAGES.md §2.5 | server/routes/admin.js
+ * ЗАМЕНИТЕ: кнопки статусов, admin-banner, логин админа в server/db/init.js
+ * БАНКЕТАМ.НЕТ: подписи опций фильтра и кнопок — «Банкет назначен» и т.д.
  * =============================================================================
  */
-import { useEffect, useState } from 'react';
+import { useCallback, useEffect, useState } from 'react';
 import Layout from '../components/Layout.jsx';
 import PageImage from '../components/PageImage.jsx';
 import { api } from '../api.js';
 
+const STATUS_FILTER_OPTIONS = [
+  { value: 'all', label: 'Все заявки' },
+  { value: 'new', label: 'Новая' },
+  { value: 'in_progress', label: 'В работе' },
+  { value: 'completed', label: 'Выполнено' },
+  { value: 'cancelled', label: 'Отменено' },
+];
+
 export default function AdminPage() {
   const [requests, setRequests] = useState([]);
   const [loading, setLoading] = useState(true);
+  const [filterStatus, setFilterStatus] = useState('all');
   const [cancelReasons, setCancelReasons] = useState({});
   const [message, setMessage] = useState('');
 
-  const load = () => {
+  const load = useCallback(() => {
     setLoading(true);
     api
-      .adminGetRequests()
+      .adminGetRequests({ status: filterStatus })
       .then(setRequests)
       .catch((e) => setMessage(e.message))
       .finally(() => setLoading(false));
-  };
+  }, [filterStatus]);
 
   useEffect(() => {
     load();
-  }, []);
+  }, [load]);
 
   const updateStatus = async (id, status) => {
     setMessage('');
@@ -55,6 +61,7 @@ export default function AdminPage() {
     }
     try {
       await api.adminUpdateStatus(id, { status, cancelReason });
+      setMessage('Статус обновлён');
       load();
     } catch (e) {
       setMessage(e.data?.message || e.message);
@@ -66,10 +73,39 @@ export default function AdminPage() {
       <div className="animate-fade-up">
         <PageImage imageKey="adminBanner" className="w-full h-20 object-cover rounded-xl mb-4" />
 
-        {/* БАНКЕТАМ.НЕТ: фильтр/сортировка/пагинация — см. комментарий в шапке файла */}
         <h2 className="text-xl font-bold text-white mb-4">Панель администратора</h2>
+
+        {/* Фильтр: меняйте label в STATUS_FILTER_OPTIONS; value = status в БД */}
+        <div className="mb-4 flex flex-wrap items-center gap-2">
+          <label htmlFor="admin-filter-status" className="text-white/90 text-sm">
+            Статус:
+          </label>
+          <select
+            id="admin-filter-status"
+            value={filterStatus}
+            onChange={(e) => setFilterStatus(e.target.value)}
+            className="rounded-lg border border-violet-200 px-3 py-1.5 text-sm text-slate-800 bg-white"
+          >
+            {STATUS_FILTER_OPTIONS.map((opt) => (
+              <option key={opt.value} value={opt.value}>
+                {opt.label}
+              </option>
+            ))}
+          </select>
+          <button
+            type="button"
+            onClick={load}
+            className="text-xs px-2 py-1.5 rounded-lg bg-white/20 text-white hover:bg-white/30"
+          >
+            Обновить
+          </button>
+        </div>
+
         {message && <p className="text-amber-200 text-sm mb-3">{message}</p>}
         {loading && <p className="text-white/70">Загрузка…</p>}
+        {!loading && requests.length === 0 && (
+          <p className="text-white/70 text-sm">Нет заявок с выбранным статусом</p>
+        )}
 
         <div className="space-y-4">
           {requests.map((r) => (
@@ -98,7 +134,6 @@ export default function AdminPage() {
                 {new Date(r.scheduledAt).toLocaleString('ru-RU')} · {r.paymentLabel}
               </p>
 
-              {/* БАНКЕТАМ.НЕТ: кнопки «Банкет назначен» (in_progress) и «Банкет завершен» (completed); убрать «Отменить» */}
               <div className="mt-3 flex flex-wrap gap-2">
                 {r.status === 'new' && (
                   <button

package/exam-guides/commented-code/client/src/pages/LandingPage.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/LandingPage.jsx | URL: /
+ * Лендинг: слайдер, тексты perks, блок услуг. Не путать с Layout.jsx
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * ЛЕНДИНГ (/) — главная для гостей

package/exam-guides/commented-code/client/src/pages/LoginPage.jsx

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/LoginPage.jsx | URL: /login | п.2
+ * login + password → AuthContext.login → admin: /admin, user: /requests
+ * Админ: server/db/init.js (adminka или Admin26)
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * АВТОРИЗАЦИЯ (/login) — п.2 задания ДЭ

package/exam-guides/commented-code/client/src/pages/RegisterPage.jsx

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/RegisterPage.jsx | URL: /register | п.1
+ * Поля: login, password, fullName, phone, email → POST /api/auth/register
+ * Менять: label, banner imageKey registerBanner, validation.js
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * РЕГИСТРАЦИЯ (/register) — п.1 задания ДЭ

package/exam-guides/commented-code/client/src/pages/RequestFormPage.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/RequestFormPage.jsx | URL: /requests/form | п.4
+ * Форма заявки: api.getServices() + api.createRequest(). Поля form state → validation → POST
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * п.4 ЗАДАНИЯ — «Страница формирования заявки»  (/requests/form)

package/exam-guides/commented-code/client/src/pages/RequestsPage.jsx

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/RequestsPage.jsx | URL: /requests | п.3
+ * История: api.getMyRequests(). Кнопка на /requests/form. statusLabel с сервера.
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * п.3 ЗАДАНИЯ — «Страница создания заявки»  (/requests)

package/exam-guides/commented-code/client/src/utils/validation.js

@@ -1,3 +1,11 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/utils/validation.js
+ * Валидация форм на клиенте. ДУБЛИРОВАТЬ в server/utils/validation.js!
+ * register → RegisterPage | request → RequestFormPage
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * ВАЛИДАЦИЯ НА КЛИЕНТЕ (мгновенные ошибки на форме)

package/exam-guides/commented-code/client/vite.config.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/vite.config.js
+ * Порт 5173. proxy /api → :3001 (если сменили PORT в server/.env — поменять target)
+ * =============================================================================
+ */
+
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 import tailwindcss from '@tailwindcss/vite';

package/exam-guides/commented-code/server/db/init.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/db/init.js
+ * npm run db:init — schema+seed+админ. Логин/пароль админа ЗДЕСЬ (seedAdmin).
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * ИНИЦИАЛИЗАЦИЯ БД: npm run db:init

package/exam-guides/commented-code/server/db/pool.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/db/pool.js
+ * Подключение БД. Только server/.env → DATABASE_URL
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * pool.js — ПОДКЛЮЧЕНИЕ К PostgreSQL

package/exam-guides/commented-code/server/db/schema.sql

@@ -1,3 +1,8 @@
+-- =============================================================================
+-- ФАЙЛ: server/db/schema.sql
+-- Таблицы users, service_types, requests. Статусы CHECK. npm run db:init
+-- =============================================================================
+
 -- =============================================================================
 -- СХЕМА БД — при смене темы переименуйте БД и таблицы по смыслу предметной области
 -- Тема сейчас: клининг «Мой Не Сам» → заявки на уборку (requests)

package/exam-guides/commented-code/server/db/seed.sql

@@ -1,3 +1,8 @@
+-- =============================================================================
+-- ФАЙЛ: server/db/seed.sql
+-- Список услуг в service_types. Менять VALUES под тему.
+-- =============================================================================
+
 -- =============================================================================
 -- SEED — начальные записи в service_types (справочник для формы п.4)
 -- =============================================================================

package/exam-guides/commented-code/server/index.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/index.js
+ * Старт API :3001. Роуты /api/auth, /services, /requests, /admin
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * EXPRESS — точка входа сервера

package/exam-guides/commented-code/server/middleware/auth.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/middleware/auth.js
+ * JWT. authRequired — user routes. adminRequired — /api/admin
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * JWT middleware