MVP-платформа для репетиторов: ученики, занятия, домашние задания и учёт оплат.
ClassFlow помогает собрать повседневную работу репетитора в одном месте: вести учеников, планировать занятия и видеть ближайшие задачи.
- Карточки учеников и расписание занятий
- Статусы занятий и отметки об оплате
- Домашние задания
- Дашборд ближайших занятий
| Часть | Технологии |
|---|---|
| Backend | FastAPI, SQLAlchemy, Alembic |
| Frontend | Next.js App Router, Tailwind CSS, shadcn/ui |
| Данные | PostgreSQL |
| Запуск | Docker Compose |
Нужен установленный Docker с поддержкой Docker Compose.
cp .env.example .env
docker compose up --buildПосле запуска:
- Frontend: http://localhost:3000
- API и Swagger: http://localhost:8000/docs
Заполни значения в .env на основе .env.example:
| Переменная | Назначение |
|---|---|
DATABASE_URL |
Подключение к PostgreSQL |
JWT_SECRET |
Секрет для JWT |
FRONTEND_ORIGIN |
Адрес frontend для CORS |
TAX_PERCENT_DEFAULT |
Значение налога или комиссии по умолчанию |
NEXT_PUBLIC_API_URL |
Адрес backend для frontend |
Backend-команды выполняются в контейнере backend:
pytest
ruff check .
mypy appFrontend:
npm run lint
npm run typecheckbackend/ FastAPI, SQLAlchemy и Alembic
frontend/ Next.js-интерфейс
infra/ заметки по инфраструктуре
docs/ спецификация и описание API
Проект находится на стадии MVP. Для простоты токен авторизации сейчас хранится в localStorage; перед production-развёртыванием стоит перейти на более безопасную схему хранения, например httpOnly cookie.
Экран входа в приложение:
