@mashka818/exam-de-template 1.0.0

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

@@ -0,0 +1,71 @@
+/**
+ * =============================================================================
+ * ВАЛИДАЦИЯ НА КЛИЕНТЕ (мгновенные ошибки на форме)
+ * =============================================================================
+ * Должна совпадать с 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}$/;
+export const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export const FIO_REGEX = /^[А-Яа-яЁё\s-]+$/;
+
+/** Регистрация — поля users */
+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 символов'; // БАНКЕТАМ.НЕТ: 8
+  if (!form.fullName?.trim()) errors.fullName = 'ФИО обязательно';
+  else if (!FIO_REGEX.test(form.fullName.trim())) errors.fullName = 'Только кириллица и пробелы';
+  if (!form.phone?.trim()) errors.phone = 'Телефон обязателен';
+  else if (!PHONE_REGEX.test(form.phone.trim())) errors.phone = 'Формат: +7(XXX)-XXX-XX-XX';
+  if (!form.email?.trim()) errors.email = 'Email обязателен';
+  else if (!EMAIL_REGEX.test(form.email.trim())) errors.email = 'Некорректный email';
+  return errors;
+}
+
+/** Новая заявка — поля requests */
+export function validateRequestForm(form) {
+  const errors = {};
+  if (!form.address?.trim()) errors.address = 'Адрес обязателен';
+  if (!form.contactPhone?.trim()) errors.contactPhone = 'Телефон обязателен';
+  else if (!PHONE_REGEX.test(form.contactPhone.trim()))
+    errors.contactPhone = 'Формат: +7(XXX)-XXX-XX-XX';
+  if (!form.scheduledAt) errors.scheduledAt = 'Укажите дату и время';
+  if (!form.paymentType) errors.paymentType = 'Выберите оплату';
+  if (form.isCustomService) {
+    if (!form.customService?.trim()) errors.customService = 'Опишите услугу';
+  } else if (!form.serviceTypeId) {
+    errors.serviceTypeId = 'Выберите услугу';
+  }
+  return errors;
+}
+
+/** Маска телефона при вводе — можно оставить для любой темы с тем же форматом */
+export function formatPhoneInput(value) {
+  const digits = value.replace(/\D/g, '').slice(0, 11);
+  if (!digits.length) return '';
+  let d = digits;
+  if (d[0] === '8') d = '7' + d.slice(1);
+  if (d[0] !== '7') d = '7' + d;
+  const p = d.slice(1);
+  let out = '+7';
+  if (p.length > 0) out += `(${p.slice(0, 3)}`;
+  if (p.length >= 3) out += `)-${p.slice(3, 6)}`;
+  if (p.length >= 6) out += `-${p.slice(6, 8)}`;
+  if (p.length >= 8) out += `-${p.slice(8, 10)}`;
+  return out;
+}

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

@@ -0,0 +1,31 @@
+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: {
+    port: 5173,
+    proxy: {
+      '/api': {
+        target: 'http://localhost:3001',
+        changeOrigin: true,
+      },
+    },
+  },
+});

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

@@ -0,0 +1,67 @@
+/**
+ * =============================================================================
+ * ИНИЦИАЛИЗАЦИЯ БД: 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';
+import bcrypt from 'bcryptjs';
+import dotenv from 'dotenv';
+import { pool } from './pool.js';
+
+dotenv.config();
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+async function runSqlFile(filename) {
+  const sql = fs.readFileSync(path.join(__dirname, filename), 'utf8');
+  await pool.query(sql);
+}
+
+async function seedAdmin() {
+  // --- Учётка админа по заданию ДЭ (п.5) — менять здесь ---
+  // БАНКЕТАМ.НЕТ: const login = 'Admin26'; const password = 'Demo20';
+  const login = 'adminka';
+  const password = 'password';
+  const hash = await bcrypt.hash(password, 10);
+
+  await pool.query(
+    `INSERT INTO users (login, password_hash, full_name, phone, email, role)
+     VALUES ($1, $2, $3, $4, $5, 'admin')
+     ON CONFLICT (login) DO UPDATE SET
+       password_hash = EXCLUDED.password_hash,
+       role = 'admin'`,
+    [login, hash, 'Администратор системы', '+7(000)-000-00-00', 'admin@moynesam.local'] // БАНКЕТАМ.НЕТ: email admin@banketam.net
+  );
+  console.log('Админ: логин adminka, пароль password'); // БАНКЕТАМ.НЕТ: Admin26 / Demo20
+}
+
+async function main() {
+  try {
+    await runSqlFile('schema.sql');
+    await runSqlFile('seed.sql');
+    await seedAdmin();
+    console.log('База данных готова.');
+  } catch (err) {
+    console.error('Ошибка инициализации:', err.message);
+    process.exit(1);
+  } finally {
+    await pool.end();
+  }
+}
+
+main();

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

@@ -0,0 +1,23 @@
+/**
+ * =============================================================================
+ * 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';
+
+dotenv.config();
+
+const { Pool } = pg;
+
+export const pool = new Pool({
+  connectionString: process.env.DATABASE_URL,
+});

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

@@ -0,0 +1,53 @@
+-- =============================================================================
+-- СХЕМА БД — при смене темы переименуйте БД и таблицы по смыслу предметной области
+-- Тема сейчас: клининг «Мой Не Сам» → заявки на уборку (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,
+  login VARCHAR(64) NOT NULL UNIQUE,
+  password_hash VARCHAR(255) NOT NULL,
+  full_name VARCHAR(255) NOT NULL,
+  phone VARCHAR(32) NOT NULL,
+  email VARCHAR(255) NOT NULL,
+  role VARCHAR(20) NOT NULL DEFAULT 'user' CHECK (role IN ('user', 'admin')),
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Справочник видов услуг — при другой теме замените названия и список в seed
+-- БАНКЕТАМ.НЕТ: по смыслу «помещения», таблицу можно не переименовывать (меньше правок в SQL)
+CREATE TABLE IF NOT EXISTS service_types (
+  id SERIAL PRIMARY KEY,
+  name VARCHAR(255) NOT NULL UNIQUE
+);
+
+-- Заявки заказчика — ядро предметной области
+-- Поля: 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,
+  user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  address TEXT NOT NULL,
+  contact_phone VARCHAR(32) NOT NULL,
+  service_type_id INTEGER REFERENCES service_types(id),
+  custom_service TEXT,
+  scheduled_at TIMESTAMPTZ NOT NULL,
+  payment_type VARCHAR(20) NOT NULL CHECK (payment_type IN ('cash', 'card')),
+  status VARCHAR(20) NOT NULL DEFAULT 'new'
+    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);
+CREATE INDEX IF NOT EXISTS idx_requests_status ON requests(status);

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

@@ -0,0 +1,15 @@
+-- =============================================================================
+-- 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
+  ('Общий клининг'),
+  ('Генеральная уборка'),
+  ('Послестроительная уборка'),
+  ('Химчистка ковров и мебели')
+ON CONFLICT (name) DO NOTHING;

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

@@ -0,0 +1,45 @@
+/**
+ * =============================================================================
+ * 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';
+
+import authRoutes from './routes/auth.js';
+import servicesRoutes from './routes/services.js';
+import requestsRoutes from './routes/requests.js';
+import adminRoutes from './routes/admin.js';
+
+dotenv.config();
+
+const app = express();
+const PORT = process.env.PORT || 3001;
+
+app.use(cors({ origin: true, credentials: true }));
+app.use(express.json());
+
+// --- Подключение API (при смене темы файлы можно переименовать, пути оставить) ---
+app.use('/api/auth', authRoutes);
+app.use('/api/services', servicesRoutes);
+app.use('/api/requests', requestsRoutes);
+app.use('/api/admin', adminRoutes);
+
+app.get('/api/health', (_req, res) => res.json({ ok: true }));
+
+app.listen(PORT, () => {
+  console.log(`API: http://localhost:${PORT}`);
+});

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

@@ -0,0 +1,38 @@
+/**
+ * =============================================================================
+ * 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) {
+  const header = req.headers.authorization;
+  if (!header?.startsWith('Bearer ')) {
+    return res.status(401).json({ message: 'Требуется авторизация' });
+  }
+
+  try {
+    const token = header.slice(7);
+    req.user = jwt.verify(token, process.env.JWT_SECRET);
+    next();
+  } catch {
+    return res.status(401).json({ message: 'Сессия истекла, войдите снова' });
+  }
+}
+
+export function adminRequired(req, res, next) {
+  if (req.user?.role !== 'admin') {
+    return res.status(403).json({ message: 'Доступ только для администратора' });
+  }
+  next();
+}