@howwweld/exam

CLI-генератор учебных full-stack проектов для подготовки к веб-разработке на демонстрационном экзамене.

Пакет называется @howwweld/exam и предоставляет бинарную команду exam.

@howwweld/create-exam - старый deprecated/legacy пакет. Для этой версии его использовать не нужно.

Использование после публикации

По умолчанию используется шаблон default:

pnpm dlx @howwweld/exam my-project

Выбор шаблона:

pnpm dlx @howwweld/exam my-project --template default
pnpm dlx @howwweld/exam my-project --template simple
pnpm dlx @howwweld/exam my-project --template banquet
pnpm dlx @howwweld/exam my-project --template default-v2
pnpm dlx @howwweld/exam my-project --template simple-v2
pnpm dlx @howwweld/exam my-project --template banquet-v2

После глобальной или локальной установки:

exam my-project
exam my-project --template default-v2
exam my-project --template simple-v2
exam my-project --template banquet-v2

Короткий вариант выбора шаблона:

exam my-project -t simple
exam my-project -t banquet-v2

Шаблоны

default

Структурированный шаблон с разделением на routes, services, middleware и shared config. Подходит для подготовки и повторного использования, содержит подробную документацию и дополнительные варианты CSS-оформления.

simple

Более прямой шаблон проекта Конференции.РФ: меньше файлов, простой Express server, HTML/CSS/vanilla JS, Prisma и SQLite. Подходит, когда нужна менее абстрактная структура.

banquet

Конкретный проект Банкетам.Нет: портал бронирования помещений для банкетов. Основан на структуре simple, использует HTML/CSS/vanilla JS, Express, Prisma и SQLite.

default-v2

Та же функциональность, что у default, но с более насыщенным визуальным layout: верхняя навигация, блоки помещений, обновленный слайдер, footer и контакты-заглушки.

simple-v2

Та же функциональность, что у simple, но с альтернативным простым оформлением, header/footer, социальными placeholder-ссылками и обзорными визуальными блоками.

banquet-v2

Та же функциональность, что у banquet, но с теплым banquet/event оформлением, footer, социальными placeholder-ссылками и шестью блоками помещений для банкетной тематики.

Все шаблоны используют HTML, CSS, vanilla JavaScript, Node.js, Express, Prisma и SQLite. В шаблонах нет React, Vue, Vite, TypeScript, Tailwind, Bootstrap, Docker, Puppeteer, Mermaid CLI или prisma-erd-generator.

Локальная проверка CLI

cd exam/exam
npm link
exam test-default --template default
exam test-simple --template simple
exam test-banquet --template banquet
exam test-default-v2 --template default-v2
exam test-simple-v2 --template simple-v2
exam test-banquet-v2 --template banquet-v2

Проверка через tarball:

cd exam/exam
pnpm pack
pnpm dlx ./howwweld-exam-0.1.2.tgz test-simple --template simple
pnpm dlx ./howwweld-exam-0.1.2.tgz test-banquet-v2 --template banquet-v2

Проверка сгенерированного проекта

Windows:

cd test-simple
copy .env.example .env
pnpm install
pnpm prisma:generate
pnpm prisma:migrate
pnpm db:seed
pnpm erd
pnpm check
pnpm dev

Linux/macOS:

cd test-simple
cp .env.example .env
pnpm install
pnpm prisma:generate
pnpm prisma:migrate
pnpm db:seed
pnpm erd
pnpm check
pnpm dev

Откройте http://localhost:3000.

Чеклист перед публикацией

1. Проверьте имя пакета в package.json: @howwweld/exam.
2. Проверьте бинарную команду: exam.
3. Проверьте генерацию всех шаблонов: default, simple, banquet, default-v2, simple-v2, banquet-v2.
4. Выполните проверку через pnpm pack или npm pack --dry-run.
5. Убедитесь, что в пакет не попадают node_modules, .env, базы данных и сгенерированные ERD-файлы.

Ручная публикация

Пакет подготовлен к публикации, но публикацию нужно выполнить вручную:

cd exam/exam
npm login
npm publish --access public

Этот репозиторий не выполняет публикацию автоматически.