Поисковый интерфейс для научных статей (sci-search)

Этот проект представляет собой веб-приложение для поиска научных статей.

Технологии

• Next.js - Фреймворк для React-приложений с серверным рендерингом.
• tRPC - Для создания типизированных API без необходимости кодогенерации.
• Prisma - ORM для взаимодействия с базой данных.
• PostgreSQL - Реляционная база данных.
• Tailwind CSS - CSS-фреймворк для быстрой вёрстки.
• Zustand - Простое и быстрое управление состоянием.
• Biome - Форматер и линтер для кода.

Начало работы

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

npm install

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

Создайте файл .env в корне проекта, скопировав содержимое .env.example. Этот файл содержит все необходимые переменные окружения, включая настройки базы данных (PostgreSQL), данные для подключения (например, DATABASE_URL и DATABASE_URL_DOCKER), а также публичные переменные для фронтенда, такие как NEXT_PUBLIC_YANDEX_METRIKA_ID.

Обязательно замените значения-заполнители своими собственными, особенно для секретных данных, таких как пароли.

cp .env.example .env

Пример .env (для полной информации смотрите .env.example):

APP_NAME="sci-search"
# ... другие переменные
DATABASE_URL="postgresql://USER:PASSWORD@HOST:PORT/DATABASE?schema=public"
NEXT_PUBLIC_YANDEX_METRIKA_ID="YOUR_YANDEX_METRIKA_ID"

3. Применение миграций базы данных

Выполните миграции для создания необходимых таблиц в базе данных.

npm run db:generate

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

Запустите сервер для разработки.

npm run dev

Приложение будет доступно по адресу http://localhost:3000.

Доступные скрипты

• npm run dev - Запуск сервера для разработки.
• npm run build - Сборка production-версии приложения.
• npm run start - Запуск production-сборки.
• npm run check - Проверка кода с помощью Biome.
• npm run db:generate - Применение миграций базы данных.
• npm run db:studio - Запуск Prisma Studio для просмотра и редактирования данных.