Skip to content

ruphp/courseboardReact

Repository files navigation

Courseboard React

Фронтенд-приложение для публикации и просмотра учебных материалов в формате современного SPA.

О проекте

Проект собирается как легкое клиентское приложение с понятной структурой, маршрутизацией, модульной организацией кода и подготовкой к дальнейшему развитию.

Текущая версия включает:

  • главную страницу
  • страницу списка курсов
  • страницу деталей курса
  • mock API для локальной разработки
  • базовый layout с навигацией

Технологии

  • React
  • TypeScript
  • React Router
  • Vite
  • Docker

Архитектурные ориентиры

  • понятная и предсказуемая структура проекта
  • разделение страниц, модулей и общих UI-компонентов
  • развитие от mock API к реальному backend без ломки структуры
  • высокая производительность и аккуратный клиентский код
  • mobile-first подход

Производительность

Проект изначально собирается с прицелом на хорошие показатели в PageSpeed и Lighthouse:

  • без лишних библиотек и тяжелого клиента
  • с простой DOM-структурой
  • с аккуратной адаптивной версткой
  • с минимизацией лишних перерисовок и побочных эффектов

Структура проекта

src/
  app/
  components/
  modules/
  pages/
  mocks/
  styles/

Кратко по ролям:

  • app — каркас приложения, router, layout
  • components — общие UI-компоненты
  • modules — функциональные части приложения
  • pages — страницы маршрутов
  • mocks — локальные данные для разработки
  • styles — общие стили проекта

Локальный запуск

Проект запускается через Docker.

Текущий docker-compose.yml — это только локальная dev-среда:

  • используется для разработки
  • запускает Vite в dev-режиме
  • не является production-конфигурацией
  • не предназначен как финальный deploy-образ

Из корня проекта:

docker compose up --build

После запуска приложение доступно по адресу:

Для запуска в фоне:

docker compose up --build -d

Остановка:

docker compose down

Дальнейшее развитие

Планируемые направления:

  • расширение каталога курсов
  • фильтрация и поиск
  • развитие UI
  • подключение реального API
  • административная часть
  • CI/CD и deploy-процесс

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors