README.md

🌟 Discours Webapp

Современный веб-интерфейс для платформы Discours — открытого журнала о культуре, науке и обществе.

📋 Содержание

• 🚀 Технологический стек
• 🛠️ Разработка
  • 📦 Подготовка окружения
  • 🔐 Настройка HTTPS
  • ⚡ Основные команды
• 📚 Документация
• 🤝 Участие в разработке

🛠️ Разработка

📦 Подготовка окружения

# Клонирование репозитория
git clone https://github.com/discours/discoursio-webapp.git
cd discoursio-webapp

# Установка зависимостей
npm install  # или bun/pnpm/yarn

# Настройка переменных окружения
cp .env.example .env

🔐 HTTPS для локальной разработки (автоматически)

При первом запуске npm run dev приложение автоматически:

1. Проверит и установит mkcert (macOS/Linux)
2. Создаст локальный CA и сертификаты
3. Запустится на https://localhost:3000

npm run dev  # 🔒 Автоматически настроит HTTPS (если mkcert установлен)
             # 🌐 или HTTP (если mkcert не установлен)

Windows: При первом запуске увидите инструкцию:

1. Установите Chocolatey (если нет)
2. Запустите PowerShell от администратора
3. Выполните: choco install mkcert -y
4. Перезапустите npm run dev

⚡ Основные команды

# Разработка
npm run dev         # 🚀 Запуск сервера разработки
npm run build       # 📦 Сборка для продакшена
npm run preview     # 👀 Предпросмотр сборки

# Качество кода
npm run typecheck   # 🔍 Проверка типов TypeScript
npm run lint        # 🧹 Линтинг кода
npm run fix         # 🔧 Автоисправление стилей
npm run format      # 💅 Форматирование кода

# Дополнительно
npm run storybook   # 📚 Запуск Storybook
npm run analyze     # 📊 Анализ бандла

📖 Важное

• 📚 Документация — Полный обзор проекта
• 🏗️ Архитектура — Структура и технологии
• ⚡ Разработка — Процессы разработки
• 🎨 Функциональность — Основные возможности
• 🛠️ Справочники — Команды и настройки
• 🧪 Тестирование — Автоматизация качества

---

🤝 Участие в разработке

Мы приветствуем участие! Пожалуйста, ознакомьтесь с руководством по участию перед отправкой PR.