Каталог городских мероприятий на Next.js для курса «JS: Next» на Хекслете. Приложение показывает события, сохраняет условия поиска в URL, принимает заявки и разрешает организатору менять только свои события.
- Node.js 26 или новее и pnpm 12. Установка Node.js описана в инструкции Хекслета, установка pnpm в официальной инструкции.
- Make для коротких команд из этого README. Те же команды можно выполнять через pnpm.
Клонируйте репозиторий и подготовьте приложение.
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/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 сочетанием 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/ | Проверки пользовательских действий в собранном приложении |