Урок 013 минуты чтения
Как собрать учебный проект Express, PostgreSQL и Drizzle?
На этой странице
Кратко
Собери один небольшой API пользователей и задач. В нём должны быть проверка входа, миграции, связи, ошибки, тесты и вызов из Vue.
Вопрос
Как собрать учебный проект на Express, PostgreSQL и Drizzle, который не стыдно показать на собеседовании?
Возможности проекта
- создать пользователя;
- получить список и одного пользователя;
- изменить имя;
- удалить пользователя;
- создать задачу пользователя;
- получить пользователя вместе с задачами;
- запретить повторную почту;
- вернуть понятную ошибку для неверных данных.
Зависимости
npm install express cors dotenv helmet express-rate-limit zod
npm install drizzle-orm pg
npm install --save-dev \
typescript tsx \
@types/node @types/express @types/cors @types/pg \
drizzle-kit vitest supertest @types/supertestИтоговая структура
express-api/
├── drizzle/
├── src/
│ ├── app.ts
│ ├── server.ts
│ ├── config/
│ │ └── env.ts
│ ├── db/
│ │ ├── index.ts
│ │ └── schema.ts
│ ├── errors/
│ │ └── app-error.ts
│ ├── middleware/
│ │ ├── error-handler.ts
│ │ └── not-found-handler.ts
│ └── modules/
│ ├── users/
│ │ ├── users.schema.ts
│ │ ├── users.routes.ts
│ │ ├── users.controller.ts
│ │ ├── users.service.ts
│ │ └── users.repository.ts
│ └── tasks/
├── tests/
├── .env.example
├── compose.yml
├── drizzle.config.ts
├── package.json
└── tsconfig.jsonПорядок реализации
- Запусти PostgreSQL.
- Создай Express-проект и
/api/health. - Проверь конфигурацию через Zod.
- Опиши
usersиtasksв Drizzle. - Создай и прочитай первую миграцию.
- Примени миграцию к локальной базе.
- Напиши репозитории.
- Добавь службы и прикладные ошибки.
- Подключи контроллеры и маршруты.
- Добавь CORS, Helmet и ограничения.
- Проверь запросы через Postman.
- Напиши модульные и интеграционные тесты.
- Подключи Vue через общую функцию
apiRequest.
Минимальные проверки
[ ] POST /users возвращает 201
[ ] неверная почта возвращает 400
[ ] повторная почта возвращает 409
[ ] неизвестный пользователь возвращает 404
[ ] задача с неизвестным userId запрещена
[ ] удаление пользователя обрабатывает связанные задачи по выбранному правилу
[ ] список имеет limit
[ ] миграции применяются к пустой базе
[ ] сервер закрывает пул при остановкеЧто показать в README проекта
- используемый стек;
- требования к Node.js и PostgreSQL;
- пример
.env; - команды запуска и миграций;
- таблицу маршрутов;
- команды тестов;
- несколько примеров запросов и ответов;
- принятые архитектурные решения.
Что важно помнить
- Начинают со схемы данных и договора API, а не с файлов и папок.
- Миграции, проверка входа, обработчик ошибок и тесты входят в первую версию.
- API проверяют через
curlили Postman отдельно от Vue. - README с командами запуска, переменными окружения и примерами запросов — часть результата.
Мини-шпаргалка
- Один законченный CRUD полезнее десяти пустых заготовок.
- Начинай со схемы данных и договора API.
- Миграции и тесты входят в проект, а не добавляются «когда-нибудь».
- Проверяй API отдельно от Vue.
- Документация запуска является частью результата.
Документация
Express: Installing, Express: Hello world, Drizzle: Get started with PostgreSQL, Drizzle: Connect to PostgreSQL.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.