@mashka818/exam-de-template 1.0.0 → 1.0.2

package/exam-project/client/src/pages/AdminPage.jsx

@@ -1,27 +1,56 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/AdminPage.jsx | URL: /admin | п.5
+ * Фильтр filterStatus → api.adminGetRequests({ status }). Кнопки статусов → PATCH.
+ * Сервер: server/routes/admin.js
+ * =============================================================================
+ */
 
-import { useEffect, useState } from 'react';
+/**
+ * =============================================================================
+ * АДМИН-ПАНЕЛЬ (/admin) — п.5 задания ДЭ
+ * =============================================================================
+ * ФИЛЬТР ПО СТАТУСУ:
+ *   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
+ *
+ * ЗАМЕНИТЕ: кнопки статусов, admin-banner, логин админа в server/db/init.js
+ * БАНКЕТАМ.НЕТ: подписи опций фильтра и кнопок — «Банкет назначен» и т.д.
+ * =============================================================================
+ */
+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('');
@@ -32,6 +61,7 @@ export default function AdminPage() {
     }
     try {
       await api.adminUpdateStatus(id, { status, cancelReason });
+      setMessage('Статус обновлён');
       load();
     } catch (e) {
       setMessage(e.data?.message || e.message);
@@ -43,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) => (
@@ -75,7 +134,6 @@ export default function AdminPage() {
                 {new Date(r.scheduledAt).toLocaleString('ru-RU')} · {r.paymentLabel}
               </p>
 
-              
               <div className="mt-3 flex flex-wrap gap-2">
                 {r.status === 'new' && (
                   <button

package/exam-project/client/src/pages/LandingPage.jsx

@@ -1,4 +1,27 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/LandingPage.jsx | URL: /
+ * Лендинг: слайдер, тексты perks, блок услуг. Не путать с Layout.jsx
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * ЛЕНДИНГ (/) — главная для гостей
+ * =============================================================================
+ * Слайдер, о клининге, услуги, футер с фото-заглушками.
+ * Картинки: config/images.js → public/images/
+ * БАНКЕТАМ.НЕТ: тексты про банкеты; perks и «Наши услуги» = 4 помещения;
+ * LandingLayout brandName → Банкетам.Нет; слайдер 4×3 сек (HeroSlider).
+ *
+ * СТРУКТУРА: LandingLayout → HeroSlider → секции → SiteFooter
+ * perks[] — карточки преимуществ (массив строк, менять под тему)
+ * DEFAULT_SERVICE_NAMES — подписи на лендинге (дубль seed.sql; синхронизировать)
+ * cabinetPath — куда ведёт CTA для вошедшего пользователя
+ *
+ * GUIDE_PAGES.md §5 | config/images.js (aboutCleaning, homeHero…)
+ * =============================================================================
+ */
 import { Link } from 'react-router-dom';
 import { useAuth } from '../context/AuthContext.jsx';
 import LandingLayout from '../components/landing/LandingLayout.jsx';

package/exam-project/client/src/pages/LoginPage.jsx

@@ -1,4 +1,30 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/LoginPage.jsx | URL: /login | п.2
+ * login + password → AuthContext.login → admin: /admin, user: /requests
+ * Админ: server/db/init.js (adminka или Admin26)
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * АВТОРИЗАЦИЯ (/login) — п.2 задания ДЭ
+ * =============================================================================
+ * ЗАМЕНИТЕ:
+ *   сообщения об ошибке — уже есть «Неверный логин или пароль»
+ *   adminka/password — заданы в server/db/init.js (не на этой странице)
+ *   картинку — login-banner в public/images/
+ * Отличительная черта: тёмная шапка (variant="login")
+ * БАНКЕТАМ.НЕТ (п.2): ссылка «Еще не зарегистрированы? Регистрация» (сейчас «Создать аккаунт»).
+ * БАНКЕТАМ.НЕТ: подсказка админа Admin26 / Demo20 внизу формы.
+ *
+ * ПОТОК: login({ login, password }) → JWT в localStorage
+ *        user.role === 'admin' → /admin, иначе → /requests
+ * Админ создаётся в server/db/init.js (не на этой странице)
+ *
+ * GUIDE_PAGES.md §2.2 | server/db/init.js (adminka / Admin26)
+ * =============================================================================
+ */
 import { useState } from 'react';
 import { Link, useNavigate } from 'react-router-dom';
 import Layout from '../components/Layout.jsx';
@@ -49,11 +75,11 @@ export default function LoginPage() {
             Войти
           </button>
         </form>
-        
+        {/* БАНКЕТАМ.НЕТ: текст ссылки → «Еще не зарегистрированы? Регистрация» */}
         <p className="text-center text-sm mt-4">
           <Link to="/register" className="text-teal-700 underline">Создать аккаунт</Link>
         </p>
-        
+        {/* БАНКЕТАМ.НЕТ: Admin26 / Demo20 */}
         <p className="text-xs text-slate-500 mt-6 text-center">
           Админ: логин <code>adminka</code>, пароль <code>password</code>
         </p>

package/exam-project/client/src/pages/RegisterPage.jsx

@@ -1,4 +1,32 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: 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 задания ДЭ
+ * =============================================================================
+ * ЗАМЕНИТЕ:
+ *   label полей — если в теме другие данные пользователя (не ФИО, а «Название фирмы»)
+ *   валидацию — utils/validation.js (сервер + клиент)
+ *   API-тело — те же поля уходят в POST /api/auth/register
+ *   картинку — register-banner в public/images/
+ * Отличительная черта: бирюзовая шапка (variant="register")
+ * БАНКЕТАМ.НЕТ (п.1): логин латиница+цифры ≥6, пароль ≥8; ссылка «Уже есть аккаунт? Вход».
+ * БАНКЕТАМ.НЕТ: brand в Layout → «Банкетам.Нет».
+ *
+ * ПОТОК: form state → validateRegistration → register() из AuthContext
+ *        → POST /api/auth/register → navigate('/requests')
+ * Ошибки: errors.xxx под полями; serverError — общая строка сверху
+ * inputClass — стиль полей; при ошибке добавьте className input-error
+ *
+ * GUIDE_PAGES.md §2.1 | server/routes/auth.js
+ * =============================================================================
+ */
 import { useState } from 'react';
 import { Link, useNavigate } from 'react-router-dom';
 import Layout from '../components/Layout.jsx';
@@ -87,7 +115,7 @@ export default function RegisterPage() {
           </button>
         </form>
 
-        
+        {/* БАНКЕТАМ.НЕТ: на странице регистрации — ссылка «Уже зарегистрированы? Вход» (сейчас «Уже есть аккаунт?») */}
         <p className="text-center text-sm mt-4 text-slate-600">
           Уже есть аккаунт? <Link to="/login" className="text-teal-700 underline">Войти</Link>
         </p>

package/exam-project/client/src/pages/RequestFormPage.jsx

@@ -1,4 +1,29 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/RequestFormPage.jsx | URL: /requests/form | п.4
+ * Форма заявки: api.getServices() + api.createRequest(). Поля form state → validation → POST
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * п.4 ЗАДАНИЯ — «Страница формирования заявки»  (/requests/form)
+ * =============================================================================
+ * Поля: адрес, контактные данные (телефон), дата/время, вид услуги, оплата.
+ * «Иная услуга» — чекбокс + текст (модуль ПУ).
+ * После отправки — редирект на п.3 (/requests).
+ * БАНКЕТАМ.НЕТ (п.4): select помещение; дата type="text" placeholder ДД.ММ.ГГГГ (не datetime-local).
+ * БАНКЕТАМ.НЕТ: убрать блок «Иная услуга» (isCustomService).
+ * БАНКЕТАМ.НЕТ: заголовок «Оформление бронирования», label «Помещение».
+ *
+ * services: api.getServices() → select option (id, name) из service_types
+ * submit: validateRequestForm → api.createRequest(form) → navigate('/requests')
+ * paymentType: 'cash' | 'card' — значения как в schema CHECK
+ * isCustomService — модуль ПУ; для Банкетам.Нет удалить блок и поля в API
+ *
+ * GUIDE_PAGES.md §2.4 | server/routes/requests.js POST /
+ * =============================================================================
+ */
 import { useEffect, useState } from 'react';
 import { Link, useNavigate } from 'react-router-dom';
 import Layout from '../components/Layout.jsx';
@@ -79,7 +104,7 @@ export default function RequestFormPage() {
         className="bg-white rounded-2xl shadow-lg p-6 animate-fade-up border border-cyan-100"
         noValidate
       >
-        
+        {/* БАНКЕТАМ.НЕТ: «Оформление бронирования» */}
         <h1 className="text-xl font-bold text-cyan-900 mb-1">Формирование заявки</h1>
         <p className="text-sm text-slate-500 mb-6">Все поля обязательны</p>
 
@@ -130,7 +155,7 @@ export default function RequestFormPage() {
           </FormField>
         )}
 
-        
+        {/* БАНКЕТАМ.НЕТ: удалить весь блок «Иная услуга» — в задании только select помещений */}
         <label className="flex items-center gap-2 mb-4 cursor-pointer">
           <input
             type="checkbox"

package/exam-project/client/src/pages/RequestsPage.jsx

@@ -1,4 +1,29 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/pages/RequestsPage.jsx | URL: /requests | п.3
+ * История: api.getMyRequests(). Кнопка на /requests/form. statusLabel с сервера.
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * п.3 ЗАДАНИЯ — «Страница создания заявки»  (/requests)
+ * =============================================================================
+ * История заявок + кнопка перехода на /requests/form (п.4)
+ * БАНКЕТАМ.НЕТ (п.3): «Личный кабинет» — история бронирований + слайдер (HeroSlider).
+ * БАНКЕТАМ.НЕТ: блок отзыва под заявкой, если status !== 'new' (после админа).
+ * БАНКЕТАМ.НЕТ: statusColors — подписи «Банкет назначен» / «Банкет завершен».
+ *
+ * ДАННЫЕ: useEffect → api.getMyRequests() → GET /api/requests/mine
+ * statusLabel приходит с сервера (requests.js STATUS_LABELS)
+ * Кнопка «Новая заявка» → Link to="/requests/form" (п.4)
+ *
+ * БАНКЕТАМ.НЕТ (отзывы): под карточкой textarea + кнопка, если status !== 'new'
+ *   → api.postReview + route на сервере + таблица reviews в schema.sql
+ *
+ * GUIDE_PAGES.md §2.3 | THEME_BANQUETAM_NET.md
+ * =============================================================================
+ */
 import { useEffect, useState } from 'react';
 import { Link } from 'react-router-dom';
 import Layout from '../components/Layout.jsx';
@@ -31,7 +56,7 @@ export default function RequestsPage() {
         <p className="text-white/70 text-xs mb-1">Пункт 3 задания</p>
         <PageImage imageKey="requestsBanner" className="w-full h-20 object-cover rounded-xl mb-4" />
 
-        
+        {/* БАНКЕТАМ.НЕТ: заголовок «Личный кабинет» */}
         <h1 className="text-xl font-bold text-white drop-shadow mb-1">Создание заявки</h1>
         <p className="text-white/80 text-sm mb-6">
           История ваших заявок и переход к оформлению новой

package/exam-project/client/src/utils/validation.js

@@ -1,4 +1,29 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/src/utils/validation.js
+ * Валидация форм на клиенте. ДУБЛИРОВАТЬ в server/utils/validation.js!
+ * register → RegisterPage | request → RequestFormPage
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * ВАЛИДАЦИЯ НА КЛИЕНТЕ (мгновенные ошибки на форме)
+ * =============================================================================
+ * Должна совпадать с server/utils/validation.js
+ * ЗАМЕНИТЕ регулярки и сообщения, если в задании другие правила.
+ * БАНКЕТАМ.НЕТ: см. server/utils/validation.js (логин, пароль 8, дата ДД.ММ.ГГГГ).
+ *
+ * ВАЖНО: любое изменение здесь — продублировать в server/utils/validation.js
+ * Иначе форма пройдёт на клиенте, но сервер вернёт 400.
+ *
+ * validateRegistration — RegisterPage submit
+ * validateRequestForm — RequestFormPage submit
+ * formatPhoneInput — onChange телефона (маска +7(999)-999-99-99)
+ *
+ * GUIDE_PAGES.md §7.1 | THEME_BANQUETAM_NET.md
+ * =============================================================================
+ */
 
 /** Телефон строго в формате задания — менять вместе с подсказкой на форме */
 export const PHONE_REGEX = /^\+7\(\d{3}\)-\d{3}-\d{2}-\d{2}$/;
@@ -10,7 +35,7 @@ export function validateRegistration(form) {
   const errors = {};
   if (!form.login?.trim()) errors.login = 'Логин обязателен';
   if (!form.password) errors.password = 'Пароль обязателен';
-  else if (form.password.length < 6) errors.password = 'Минимум 6 символов';
+  else if (form.password.length < 6) errors.password = 'Минимум 6 символов'; // БАНКЕТАМ.НЕТ: 8
   if (!form.fullName?.trim()) errors.fullName = 'ФИО обязательно';
   else if (!FIO_REGEX.test(form.fullName.trim())) errors.fullName = 'Только кириллица и пробелы';
   if (!form.phone?.trim()) errors.phone = 'Телефон обязателен';

package/exam-project/client/vite.config.js

@@ -1,8 +1,29 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: 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';
 
-
+/**
+ * =============================================================================
+ * vite.config.js — СБОРКА И DEV-СЕРВЕР ФРОНТА
+ * =============================================================================
+ * port: 5173 — адрес сайта http://localhost:5173
+ * proxy /api → http://localhost:3001 — поэтому в api.js пишем fetch('/api/...')
+ *
+ * Картинки: всё из client/public/ отдаётся как /имя-файла (папка images → /images/...)
+ *
+ * Если сменили PORT в server/.env (например 3002) — поменяйте target ниже.
+ * production build: npm run build → папка client/dist
+ *
+ * GUIDE_PAGES.md §3.1
+ * =============================================================================
+ */
 export default defineConfig({
   plugins: [react(), tailwindcss()],
   server: {

package/exam-project/scripts/unpack-template.js

@@ -32,7 +32,8 @@ function shouldSkipFile(relPath) {
   const base = path.basename(relPath);
   if (SKIP_ROOT_FILES.has(base)) return true;
   if (base.endsWith('.tgz')) return true;
-  if (relPath.replace(/\\/g, '/').includes('server/.env')) return true;
+  const norm = relPath.replace(/\\/g, '/');
+  if (norm === 'server/.env') return true;
   return false;
 }
 

package/exam-project/server/.env.example

@@ -0,0 +1,8 @@
+# Скопируйте этот файл в .env и подставьте свои значения
+
+PORT=3001
+
+# postgresql://ЛОГИН:ПАРОЛЬ@ХОСТ:ПОРТ/ИМЯ_БАЗЫ
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/moy_ne_sam
+
+JWT_SECRET=change-me-on-exam-day-use-long-random-string

package/exam-project/server/db/init.js

@@ -1,4 +1,28 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/db/init.js
+ * npm run db:init — schema+seed+админ. Логин/пароль админа ЗДЕСЬ (seedAdmin).
+ * =============================================================================
+ */
 
+/**
+ * =============================================================================
+ * ИНИЦИАЛИЗАЦИЯ БД: npm run db:init
+ * =============================================================================
+ * Читает schema.sql + seed.sql, создаёт админа adminka/password
+ * ЗАМЕНИТЕ: login/password в seedAdmin(), ФИО и email админа
+ *
+ * КОМАНДА: из корня проекта npm run db:init
+ *   1) Читает schema.sql (таблицы)
+ *   2) Читает seed.sql (услуги)
+ *   3) seedAdmin() — UPSERT админа (ON CONFLICT login)
+ *
+ * Перед запуском: CREATE DATABASE в psql + DATABASE_URL в server/.env
+ * БАНКЕТАМ.НЕТ: login Admin26, password Demo20 в seedAdmin()
+ *
+ * README.md | GUIDE_PAGES.md §8.5
+ * =============================================================================
+ */
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -17,7 +41,7 @@ async function runSqlFile(filename) {
 
 async function seedAdmin() {
   // --- Учётка админа по заданию ДЭ (п.5) — менять здесь ---
-
+  // БАНКЕТАМ.НЕТ: const login = 'Admin26'; const password = 'Demo20';
   const login = 'adminka';
   const password = 'password';
   const hash = await bcrypt.hash(password, 10);
@@ -28,9 +52,9 @@ async function seedAdmin() {
      ON CONFLICT (login) DO UPDATE SET
        password_hash = EXCLUDED.password_hash,
        role = 'admin'`,
-    [login, hash, 'Администратор системы', '+7(000)-000-00-00', 'admin@moynesam.local']
+    [login, hash, 'Администратор системы', '+7(000)-000-00-00', 'admin@moynesam.local'] // БАНКЕТАМ.НЕТ: email admin@banketam.net
   );
-  console.log('Админ: логин adminka, пароль password');
+  console.log('Админ: логин adminka, пароль password'); // БАНКЕТАМ.НЕТ: Admin26 / Demo20
 }
 
 async function main() {

package/exam-project/server/db/pool.js

@@ -1,4 +1,23 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: server/db/pool.js
+ * Подключение БД. Только server/.env → DATABASE_URL
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * pool.js — ПОДКЛЮЧЕНИЕ К PostgreSQL
+ * =============================================================================
+ * Менять ТОЛЬКО server/.env → DATABASE_URL
+ *   postgresql://ЛОГИН:ПАРОЛЬ@localhost:5432/ИМЯ_БАЗЫ
+ *
+ * БАНКЕТАМ.НЕТ: CREATE DATABASE banketam_net; и /banketam_net в URL
+ * Импорт pool везде: import { pool } from '../db/pool.js';
+ *
+ * GUIDE_PAGES.md §8 | README.md (разбор строки подключения)
+ * =============================================================================
+ */
 import pg from 'pg';
 import dotenv from 'dotenv';
 

package/exam-project/server/db/schema.sql

@@ -1,6 +1,20 @@
+-- =============================================================================
+-- ФАЙЛ: server/db/schema.sql
+-- Таблицы users, service_types, requests. Статусы CHECK. npm run db:init
+-- =============================================================================
+
+-- =============================================================================
 -- СХЕМА БД — при смене темы переименуйте БД и таблицы по смыслу предметной области
 -- Тема сейчас: клининг «Мой Не Сам» → заявки на уборку (requests)
 -- Другая тема: заявки → orders / bookings / applications
+-- =============================================================================
+-- БАНКЕТАМ.НЕТ: users — без изменений структуры (ФИО, телефон, email, login, password).
+-- БАНКЕТАМ.НЕТ: service_types → помещения (зал, ресторан, веранды).
+-- БАНКЕТАМ.НЕТ: requests → бронирования; address можно оставить или переименовать в comment_only.
+-- БАНКЕТАМ.НЕТ: scheduled_at → дата начала банкета.
+-- БАНКЕТАМ.НЕТ: статусы CHECK → 'new','in_progress','completed' (без cancelled при необходимости).
+-- БАНКЕТАМ.НЕТ: Модуль 3 — ДОБАВИТЬ таблицу reviews (request_id, user_id, text, rating, created_at).
+-- =============================================================================
 
 CREATE TABLE IF NOT EXISTS users (
   id SERIAL PRIMARY KEY,
@@ -14,6 +28,7 @@ CREATE TABLE IF NOT EXISTS users (
 );
 
 -- Справочник видов услуг — при другой теме замените названия и список в seed
+-- БАНКЕТАМ.НЕТ: по смыслу «помещения», таблицу можно не переименовывать (меньше правок в SQL)
 CREATE TABLE IF NOT EXISTS service_types (
   id SERIAL PRIMARY KEY,
   name VARCHAR(255) NOT NULL UNIQUE
@@ -21,6 +36,7 @@ CREATE TABLE IF NOT EXISTS service_types (
 
 -- Заявки заказчика — ядро предметной области
 -- Поля: address (адрес/комментарий), scheduled_at (дата услуги), payment_type cash|card
+-- service_type_id ИЛИ custom_service — «иная услуга»; БАНКЕТАМ.НЕТ: только service_type_id
 -- status: new → админ меняет на in_progress / completed (подписи в requests.js STATUS_LABELS)
 CREATE TABLE IF NOT EXISTS requests (
   id SERIAL PRIMARY KEY,
@@ -35,6 +51,7 @@ CREATE TABLE IF NOT EXISTS requests (
     CHECK (status IN ('new', 'in_progress', 'completed', 'cancelled')),
   cancel_reason TEXT, -- БАНКЕТАМ.НЕТ: поле можно не использовать (в задании нет «отмены»)
   created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+  -- БАНКЕТАМ.НЕТ: ALTER TABLE requests ADD COLUMN review_text TEXT; — отзыв после смены статуса админом
 );
 
 CREATE INDEX IF NOT EXISTS idx_requests_user_id ON requests(user_id);

package/exam-project/server/db/seed.sql

@@ -1,8 +1,16 @@
+-- =============================================================================
+-- ФАЙЛ: server/db/seed.sql
+-- Список услуг в service_types. Менять VALUES под тему.
+-- =============================================================================
+
+-- =============================================================================
 -- SEED — начальные записи в service_types (справочник для формы п.4)
+-- =============================================================================
 -- Выполняется из init.js при npm run db:init
 -- ON CONFLICT DO NOTHING — повторный init не дублирует строки
 --
 -- Синхронизируйте с client/src/constants/services.js (лендинг)
+-- БАНКЕТАМ.НЕТ: замените VALUES на четыре помещения:
 --   ('Банкетный зал'), ('Ресторан'), ('Летняя веранда'), ('Закрытая веранда')
 INSERT INTO service_types (name) VALUES
   ('Общий клининг'),

package/exam-project/server/index.js

@@ -1,4 +1,27 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: server/index.js
+ * Старт API :3001. Роуты /api/auth, /services, /requests, /admin
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * EXPRESS — точка входа сервера
+ * =============================================================================
+ * PORT, DATABASE_URL, JWT_SECRET — в server/.env
+ * Префикс /api обычно не меняют. Роуты подключаются из папки routes/
+ * БАНКЕТАМ.НЕТ: DATABASE_URL в .env — имя БД например banketam_net
+ *
+ * ЗАПУСК: npm run dev (корень) или node index.js из server/
+ * Порядок: dotenv → cors → express.json() → роуты → listen(PORT)
+ *
+ * Новый роут: import + app.use('/api/xxx', xxxRoutes)
+ * Health-check: GET /api/health → { ok: true } — проверка что API жив
+ *
+ * GUIDE_PAGES.md §8 | README.md
+ * =============================================================================
+ */
 import express from 'express';
 import cors from 'cors';
 import dotenv from 'dotenv';

package/exam-project/server/middleware/auth.js

@@ -1,4 +1,25 @@
-
+/**
+ * =============================================================================
+ * ФАЙЛ: server/middleware/auth.js
+ * JWT. authRequired — user routes. adminRequired — /api/admin
+ * =============================================================================
+ */
+
+/**
+ * =============================================================================
+ * JWT middleware
+ * =============================================================================
+ * JWT_SECRET — server/.env
+ * role в токене: user | admin — из таблицы users
+ *
+ * authRequired — вешать на роуты /requests, /admin (заголовок Authorization: Bearer ...)
+ * adminRequired — только для /api/admin/* (роль admin после входа Admin26)
+ *
+ * На фронте: ProtectedRoute role="user" | "admin" (client/src/components/ProtectedRoute.jsx)
+ *
+ * JWT_SECRET в server/.env — обязательно задать перед экзаменом
+ * =============================================================================
+ */
 import jwt from 'jsonwebtoken';
 
 export function authRequired(req, res, next) {