@mashka818/exam-de-template 1.0.0 → 1.0.2

package/exam-guides/commented-code/server/routes/admin.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/routes/admin.js
+ * GET /requests?status= — фильтр. PATCH /requests/:id/status
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * ADMIN — /api/admin (только role=admin, логин adminka)
@@ -27,16 +34,29 @@ const router = Router();
 
 const ALLOWED_STATUSES = ['in_progress', 'completed', 'cancelled']; // БАНКЕТАМ.НЕТ: убрать 'cancelled'
 
-// GET /api/admin/requests — все заявки для панели администратора
-router.get('/requests', authRequired, adminRequired, async (_req, res) => {
+// GET /api/admin/requests — все заявки; ?status=new|in_progress|completed|cancelled (без all)
+const FILTER_STATUSES = ['new', 'in_progress', 'completed', 'cancelled'];
+
+router.get('/requests', authRequired, adminRequired, async (req, res) => {
   try {
+    const { status } = req.query;
+    const params = [];
+    let where = 'WHERE 1=1';
+
+    if (status && status !== 'all' && FILTER_STATUSES.includes(status)) {
+      params.push(status);
+      where += ` AND r.status = $${params.length}`;
+    }
+
     const { rows } = await pool.query(
       `SELECT r.*, st.name AS service_name, u.full_name AS user_full_name,
               u.phone AS user_phone, u.email AS user_email
        FROM requests r
        LEFT JOIN service_types st ON st.id = r.service_type_id
        JOIN users u ON u.id = r.user_id
-       ORDER BY r.created_at DESC`
+       ${where}
+       ORDER BY r.created_at DESC`,
+      params
     );
     res.json(
       rows.map((row) => ({

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

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/routes/auth.js
+ * POST /register, POST /login, GET /me
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * AUTH — /api/auth

package/exam-guides/commented-code/server/routes/requests.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/routes/requests.js
+ * GET /mine, POST / — заявки пользователя. STATUS_LABELS — подписи статусов
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * REQUESTS — /api/requests (только role=user)

package/exam-guides/commented-code/server/routes/services.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/routes/services.js
+ * GET /api/services — справочник для select на форме п.4
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * SERVICES — GET /api/services

package/exam-guides/commented-code/server/utils/validation.js

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: server/utils/validation.js
+ * Как client/src/utils/validation.js — те же правила!
+ * =============================================================================
+ */
+
 /**
  * =============================================================================
  * ВАЛИДАЦИЯ НА СЕРВЕРЕ (обязательно дублировать на клиенте)

package/exam-project/EXAM_COMMANDS.txt

@@ -0,0 +1,47 @@
+================================================================================
+ЭКЗАМЕН — одна команда, две папки
+================================================================================
+Нужны: Node.js, PostgreSQL, интернет, пакет на npm (см. NPM_PACKAGE.md)
+
+Пакет: @mashka818/exam-de-template
+
+--------------------------------------------------------------------------------
+НА ЭКЗАМЕНЕ
+--------------------------------------------------------------------------------
+
+  mkdir C:\DE\work
+  cd C:\DE\work
+  npx @mashka818/exam-de-template@1.0.1 init
+
+  Появятся:
+    exam-project\   — правите и запускаете ЗДЕСЬ
+    exam-guides\    — шпоры (удалить перед сдачей)
+
+  cd exam-project
+  copy server\.env.example server\.env
+  notepad server\.env
+  npm run db:init
+  npm run dev
+
+  Сайт: http://localhost:5173
+
+--------------------------------------------------------------------------------
+ПЕРЕД СДАЧЕЙ
+--------------------------------------------------------------------------------
+
+  cd ..
+  rmdir /s /q exam-guides
+
+  (остаётся только exam-project — его и показываете)
+
+--------------------------------------------------------------------------------
+ДОМА (один раз)
+--------------------------------------------------------------------------------
+
+  npm run sync:project
+  cd exam-project
+  npm publish --access public
+
+  Подробно: NPM_PACKAGE.md
+
+================================================================================

package/exam-project/README.md

@@ -1,6 +1,7 @@
-# Проект для экзамена (сдаёте эту папку)
+# exam-project — работайте здесь
 
-Чистый рабочий шаблон без шпор в коде.
+В каждом файле кода вверху блок **ФАЙЛ:** — что менять на экзамене.
+Полная карта: **КАРТА_ЭКЗАМЕНА.md**
 
 ```powershell
 npm run install:all
@@ -9,8 +10,4 @@ npm run db:init
 npm run dev
 ```
 
-Сайт: http://localhost:5173
-
-**Перед сдачей:** удалите соседнюю папку **exam-guides** (целиком).
-
-Дома обновить из копии с комментариями: в корне репозитория `npm run sync:project`
+Перед сдачей: удалите папку **exam-guides** (если рядом). При желании уберите лишние комментарии из кода.

package/exam-project/THEME_BANQUETAM_NET.md

@@ -0,0 +1,106 @@
+# Тема «Банкетам.Нет» — что менять в шаблоне (только текст и логика по комментариям)
+
+> **Подробный гайд** (как удалять/добавлять кнопки, картинки, секции, новую страницу): **[GUIDE_PAGES.md](GUIDE_PAGES.md)**
+
+Сейчас в коде тема **«Мой Не Сам» (клининг)**. На экзамене ищите в файлах метку **`БАНКЕТАМ.НЕТ:`** — там подсказка, что заменить.
+
+---
+
+## Быстрая таблица замен
+
+| Сейчас (клининг) | Банкетам.Нет |
+|------------------|--------------|
+| Мой Не Сам | **Банкетам.Нет** |
+| Заявка / requests | **Бронирование / заявка на зал** |
+| Вид услуги | **Помещение** (зал, ресторан, летняя веранда, закрытая веранда) |
+| Дата и время уборки | **Дата начала банкета** (формат **ДД.ММ.ГГГГ**) |
+| adminka / password | **Admin26 / Demo20** |
+| Статус «В работе» | **Банкет назначен** |
+| Статус «Выполнено» | **Банкет завершен** |
+| Отменено | по заданию может не быть — убрать кнопку или оставить |
+| Пароль ≥ 6 | **Пароль ≥ 8** |
+| Логин | **латиница + цифры, ≥ 6**, уникальный |
+| Слайдер 3 слайда, 5 сек | **4 слайда, 3 сек** (HeroSlider.jsx, images.js) |
+| «Иная услуга» | обычно **не нужна** — убрать чекбокс |
+| Личный кабинет п.3 | история + **отзывы** (только после смены статуса админом) |
+| Админ-панель | **фильтры, сортировка, пагинация**, уведомления |
+
+---
+
+## Пункты задания → файлы
+
+### п.1 Регистрация (`/register`)
+- `RegisterPage.jsx` — подписи полей, ссылка «Уже зарегистрированы?» → наоборот: на login «**Еще не зарегистрированы? Регистрация**»
+- `client/src/utils/validation.js` + `server/utils/validation.js` — логин `[a-zA-Z0-9]{6,}`, пароль `min 8`
+- `server/routes/auth.js` — INSERT users
+
+### п.2 Вход (`/login`)
+- `LoginPage.jsx` — текст ошибок, ссылка на регистрацию
+- `server/routes/auth.js` — POST /login
+
+### п.3 Личный кабинет (`/requests`)
+- `RequestsPage.jsx` — «история бронирований», **слайдер** (можно вынести компонент с лендинга)
+- **ДОБАВИТЬ:** таблица/поле `reviews` в БД, форма отзыва если статус ≠ `new` (после действия админа)
+- `server/db/schema.sql` — комментарий про `reviews`
+
+### п.4 Оформление заявки (`/requests/form`)
+- `RequestFormPage.jsx` — select помещений, дата **ДД.ММ.ГГГГ**, оплата
+- `server/db/seed.sql` — 4 типа помещений
+- убрать/не показывать «Иная услуга»
+
+### п.5 Админ (`/admin`)
+- `server/db/init.js` — **Admin26** / **Demo20**
+- `AdminPage.jsx` — статусы только «Банкет назначен», «Банкет завершен» (+ изначально «Новая»)
+- **ДОБАВИТЬ:** фильтр по статусу, сортировка, пагинация (комментарии в AdminPage.jsx)
+
+### Лендинг (`/`)
+- `LandingPage.jsx`, `HeroSlider.jsx` — тексты про банкеты, **4** картинки, интервал **3000** мс
+- `client/public/images/` — slide-1…slide-4.png
+
+### Модуль 2
+- HTML-макеты 390×844 в Figma, не обязательно в репозитории
+- `RESPONSIVE.md` — мобильный дизайн
+
+### Модуль 3
+- `schema.sql` — отзывы, при необходимости убрать `cancelled`
+- `index.css` — микроанимации уже есть (animate-fade-up)
+
+---
+
+## Статусы в БД (schema.sql + routes)
+
+```
+new              → «Новая»
+in_progress      → «Банкет назначен»   (переименовать LABEL, не обязательно ключ)
+completed        → «Банкет завершен»
+cancelled        → убрать из CHECK или не показывать в админке
+```
+
+В `server/routes/requests.js` и `admin.js` — `STATUS_LABELS`.  
+В `RequestsPage.jsx` — `statusColors`.
+
+---
+
+## Помещения (seed.sql)
+
+```sql
+('Банкетный зал'),
+('Ресторан'),
+('Летняя веранда'),
+('Закрытая веранда')
+```
+
+---
+
+## Порядок работы на экзамене (≈30–60 мин только тексты)
+
+1. `Layout.jsx` + `LandingLayout.jsx` — название **Банкетам.Нет**
+2. `init.js` — Admin26 / Demo20 → `npm run db:init`
+3. `seed.sql` — помещения
+4. `validation.js` (×2) — логин/пароль
+5. Все `pages/*.jsx` — заголовки и кнопки
+6. `STATUS_LABELS` + админ-кнопки
+7. Картинки в `public/images/` + `images.js`
+8. По времени: отзывы, фильтры админа, 4-й слайд
+
+Удачи на ДЭ.

package/exam-project/client/index.html

@@ -1,3 +1,10 @@
+/**
+ * =============================================================================
+ * ФАЙЛ: client/index.html
+ * <title> — название вкладки браузера
+ * =============================================================================
+ */
+
 <!DOCTYPE html>
 <html lang="ru">
   <head>