Промпт для Full-stack разработки и создания артефактов

Контекст и цель

Запрос пользователя: «Нужна форма подписки на рассылку: поле Email, кнопка 'Подписаться', валидация на фронте и сохранение в базу PostgreSQL через Node.js API».

Цель: Реализовать MVP функционала сбора email-адресов с защитой от некорректного ввода и сохранением в БД.

Основной артефакт: Спецификация реализации

1. Стек и Схема БД

• Frontend: React + HTML5 Validation.
• Backend: Node.js (Express) + Prisma ORM.
• DB: PostgreSQL. Таблица Subscribers (id, email, created_at).

2. API Endpoints

• POST /api/subscribe: Принимает { "email": string }.
• Логика: Проверка на существование, запись, возврат 201 Created.

3. Пример кода (Full-stack snippet)

// Backend (Express + Prisma)
app.post('/api/subscribe', async (req, res) => {
  const { email } = req.body;
  try {
    const user = await prisma.subscriber.create({ data: { email } });
    res.status(201).json(user);
  } catch (e) {
    res.status(400).json({ error: "Email already exists" });
  }
});

Допущения и ограничения

• Допущение: CORS настроен для фронтенда; БД уже развернута.
• Ограничение: Нет подтверждения через письмо (Double Opt-in) в текущей итерации.
• Зависимость: Наличие установленного Node.js и PostgreSQL.

Критерии приемки (DoD)

• [ ] Поле ввода блокирует отправку при пустом email или неверном формате (HTML5 validation).
• [ ] API возвращает 400 ошибку при дубликате email.
• [ ] Данные успешно сохраняются в таблицу Subscribers.
• [ ] Пользователь видит сообщение об успехе после ответа сервера.

Ответ модели

Решение подготовлено в формате мини-спецификации. Для запуска потребуется:

1. Инициализировать Prisma-схему.
2. Создать эндпоинт на Express.
3. Реализовать форму с type="email" на клиенте.

Следующий шаг: Настройка миграций БД. Ответственная роль: Backend / DevOps.

...