Skip to content

About

Каталог городских мероприятий на Next.js. Исполняемый пример к курсу JS Next на Хекслете.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Каталог городских мероприятий на Next.js для курса «JS: Next» на Хекслете. Приложение показывает события, сохраняет условия поиска в URL, принимает заявки и разрешает организатору менять только свои события.

Требования

Запуск

Клонируйте репозиторий и подготовьте приложение.

git clone https://github.com/hexlet-components/js-next-example.git
cd js-next-example
make setup

В .env.local появятся адрес готового API и настройка cookie для локального HTTP.

EVENTS_API_URL=http://localhost:4000
COOKIE_SECURE=false

В первом терминале запустите готовый API.

make api

Программа напечатает Events API http://localhost:4000. API работает отдельным процессом, хранит учебные данные в памяти и возвращает исходное состояние после перезапуска.

Во втором терминале из каталога репозитория запустите приложение.

make dev

Откройте http://localhost:3000/events. Список содержит шесть мероприятий. Поиск «Прогулка» находит три события, а вторая страница показывает «Прогулку по парку».

Учебные сценарии

Адрес Что проверить
/events Список, поиск и пагинация с сохранением параметров в URL
/events/1 Карточка, интерактивная кнопка и заявка с новым счётчиком
/events/missing Сообщение об отсутствующем событии
/login Вход организатора
/events/1/edit Изменение своего события, отказ без сессии и для чужого владельца
Организатор Почта Пароль Свои события
Анна anna@example.com password123 1, 3, 5
Борис boris@example.com password123 2, 4, 6

Сессия действует час. Next.js сохраняет токен в HttpOnly-cookie и проверяет пользователя при открытии редактирования и внутри действия сохранения. API повторно проверяет владельца. После выхода форма в старой вкладке больше не сохраняет изменения.

Локальная настройка COOKIE_SECURE=false нужна для HTTP. На публичном HTTPS-адресе используется COOKIE_SECURE=true. Этот учебный API слушает только 127.0.0.1 и предназначен для локальных примеров.

Готовый API для своего приложения

API находится в api/server.mjs и не требует установки пакетов. Его можно использовать отдельно от готового фронтенда, сохраняя тот же контракт, что в уроках.

node api/server.mjs

Перед запросами Next.js должен получить EVENTS_API_URL=http://localhost:4000 из своего файла .env.local. Браузер обращается к страницам Next.js, серверные компоненты и действия обращаются к API.

Запрос Назначение
GET /events?q=&page=1&pageSize=2 Список { items, total, page, pageSize }
GET /events/:id Карточка или 404
POST /events/:id/applications Заявка с полями name и email, ответ 201 или 422
POST /sessions Вход с email и password, ответ { token } или 401
GET /session Пользователь по токену сессии
DELETE /session Отзыв сессии
PATCH /events/:id Изменение title владельцем, отказ 401 или 403

Запросы сессии и редактирования передают токен заголовком Authorization: Bearer <token>. Данные, идентификаторы и ответы совпадают с примерами курса.

Ожидание и отказ API

Остановите обычный процесс API сочетанием Ctrl+C. Задержка позволяет увидеть сообщение загрузки.

API_DELAY_MS=1500 make api

Режим отказа возвращает 503 при чтении событий.

API_FAIL=1 make api

После запуска API обычной командой make api кнопка «Попробовать снова» возвращает карточку. Перезапуск сбрасывает данные и сессии.

Сборка и проверки

Остановите dev-сервер и соберите приложение. API продолжает работать в другом терминале.

make build
make start

Для проверки используются production-сборка, тесты контракта API и браузерные сценарии. Каждый тест получает API с исходными данными, процессы останавливаются после прогона.

make lint
make typecheck
make build
pnpm exec playwright install chromium
make test

Проверки форматов, ссылок, опечаток и workflows собраны в mise. Команда mise run check запускает тот же набор, что workflow Check. Workflow CI также собирает приложение и выполняет тесты.

В osv-scanner.toml записано временное исключение до 17.12.2026 для ReDoS в picomatch. Пакет используют только Knip и Stylelint с шаблонами файлов из репозитория. Исправленная версия пока не выпущена, runtime-зависимости приложения этой находки не содержат.

Состав

Каталог Содержимое
app/ Страницы App Router, состояния маршрутов и серверные действия
components/ Клиентские кнопки и формы
lib/ Серверное чтение событий и проверка сессии
api/ Готовый локальный API со стартовыми данными
tests/api/ Проверки HTTP-контракта API
tests/browser/ Проверки пользовательских действий в собранном приложении

About

Каталог городских мероприятий на Next.js. Исполняемый пример к курсу JS Next на Хекслете.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages