ckeproekt/DATABASE_SETUP.md

Настройка базы данных и системы управления новостями

Обзор системы

Система управления новостями для ckeproekt.ru включает:

• База данных: PostgreSQL с Prisma ORM
• API: REST API и GraphQL endpoints
• Админ-панель: Полнофункциональная панель управления
• Безопасность: JWT аутентификация и авторизация
• Функциональность: CRUD операции, пагинация, поиск, фильтрация

Требования

• Node.js 18+
• PostgreSQL 12+
• npm или yarn

Установка и настройка

1. Установка зависимостей

npm install

2. Настройка базы данных

1. Создайте PostgreSQL базу данных:

CREATE DATABASE ckeproject;

2. Обновите файл .env с вашими данными:

DATABASE_URL="postgresql://username:password@localhost:5432/ckeproject?schema=public"
NEXTAUTH_SECRET="your-secret-key-here"
NEXTAUTH_URL="http://localhost:3000"

3. Инициализация Prisma

# Генерация Prisma Client
npm run db:generate

# Применение схемы к базе данных
npm run db:push

# Заполнение базы данных начальными данными
npm run db:seed

4. Запуск приложения

npm run dev

Структура базы данных

Таблица users

• id - Уникальный идентификатор
• email - Email (уникальный)
• username - Имя пользователя (уникальное)
• password - Хешированный пароль
• role - Роль (USER, ADMIN, EDITOR)
• name - Полное имя
• avatar - URL аватара
• createdAt - Дата создания
• updatedAt - Дата обновления

Таблица news

• id - Уникальный идентификатор
• title - Заголовок новости
• slug - URL-слаг (уникальный)
• summary - Краткое описание
• content - Полное содержание
• category - Категория новости
• imageUrl - URL изображения
• featured - Рекомендуемая новость
• published - Статус публикации
• publishedAt - Дата публикации
• authorId - ID автора
• views - Количество просмотров
• likes - Количество лайков
• tags - Массив тегов
• createdAt - Дата создания
• updatedAt - Дата обновления

Таблица categories

• id - Уникальный идентификатор
• name - Название категории
• slug - URL-слаг (уникальный)
• description - Описание
• color - Цвет категории
• createdAt - Дата создания
• updatedAt - Дата обновления

API Endpoints

REST API

Новости

• GET /api/news - Получить список новостей
• POST /api/news - Создать новость
• GET /api/news/[id] - Получить новость по ID
• PUT /api/news/[id] - Обновить новость
• DELETE /api/news/[id] - Удалить новость

Категории

• GET /api/categories - Получить список категорий
• POST /api/categories - Создать категорию
• PUT /api/categories/[id] - Обновить категорию
• DELETE /api/categories/[id] - Удалить категорию

Аутентификация

• POST /api/auth/login - Вход в систему
• POST /api/auth/register - Регистрация
• POST /api/auth/logout - Выход из системы

GraphQL API

GraphQL endpoint доступен по адресу /api/graphql

Примеры запросов

# Получить список новостей
query {
  newsList(page: 1, limit: 10, category: "company") {
    news {
      id
      title
      summary
      publishedAt
      author {
        name
      }
    }
    total
    totalPages
  }
}

# Создать новость
mutation {
  createNews(input: {
    title: "Новая новость"
    slug: "novaya-novost"
    summary: "Краткое описание"
    content: "Полное содержание"
    category: "company"
    featured: true
  }) {
    id
    title
    slug
  }
}

Админ-панель

Админ-панель доступна по адресу /admin

Пользователи по умолчанию

После выполнения npm run db:seed будут созданы:

1. Администратор

   • Email: admin@ckeproekt.ru
   • Пароль: admin123
   • Роль: ADMIN

2. Редактор

   • Email: editor@ckeproekt.ru
   • Пароль: editor123
   • Роль: EDITOR

Функциональность админ-панели

• ✅ Создание, редактирование и удаление новостей
• ✅ Управление категориями
• ✅ Загрузка изображений
• ✅ Визуальный редактор содержимого
• ✅ Система тегов
• ✅ Управление публикацией
• ✅ Поиск и фильтрация
• ✅ Пагинация
• ✅ Статистика

Безопасность

Аутентификация

• JWT токены для авторизации
• Хеширование паролей с bcrypt
• Защищенные API endpoints

Авторизация

• Роли пользователей (USER, ADMIN, EDITOR)
• Проверка прав доступа на уровне API
• Middleware для защиты маршрутов

Валидация

• Проверка входных данных
• Санитизация контента
• Защита от XSS и SQL инъекций

Развертывание в продакшн

1. Настройка переменных окружения

DATABASE_URL="postgresql://user:password@host:5432/database"
NEXTAUTH_SECRET="strong-secret-key"
NEXTAUTH_URL="https://your-domain.com"

2. Сборка приложения

npm run build

3. Миграция базы данных

npm run db:migrate
npm run db:seed

4. Запуск с PM2

npm run pm2:start

Мониторинг и обслуживание

Prisma Studio

Для просмотра и редактирования данных:

npm run db:studio

Логи

Логи доступны через PM2:

pm2 logs

Резервное копирование

Регулярно создавайте резервные копии базы данных:

pg_dump ckeproject > backup.sql

Миграция с существующей системы

Скрипт scripts/init-database.ts автоматически мигрирует данные из lib/news-data.ts в базу данных.

Поддержка

Для получения поддержки или сообщения об ошибках обращайтесь к разработчикам системы.

Лицензия

Система разработана специально для ckeproekt.ru и является собственностью компании.