descriptionОписание
Делаю небольшой продукт для преподавателей и тренеров - веб-сервис учёта уроков, оплат и баланса учеников ( WEB сервис , пока только для десктоуп)
Цель: Сейчас фокус на MVP: один кабинет преподавателя, его ученики, календарь занятий и учёт оплаченных уроков
Что уже есть:
- продуманная аналитика (описаны сущности, ERD, сценарии и API (Swagger yaml файл на каждый ендпойнт) , есть описания эндпоинтов ( в яндекс вики), user-story в виде требований с use-cases);
- дизайн-макеты всех ключевых экранов (FIGMA)
- фронтенд: часть вёрстки уже сделана, будет мидл-фронт + синьор для код-ревью;
- уже оплачен VPS-сервер под backend + БД.
- Пока фронт реализует логику через моки
DOD ( что я является критерием выполненных задач) :
В рамках мильстоуна (часть #1 ) нужно:
В рамках мильстоуна нужно:
Поднять проект
– Python 3.x + FastAPI;
– PostgreSQL;
– ORM (SQLAlchemy или аналог);
– Alembic для миграций;
– базовая структура проекта (main, models, schemas, routers и т.п.).
Сделать модель Student в БД
– поля по спецификации (id, имя/фамилия, контакты, заметки и т.д.);
– миграция через Alembic.
Реализовать CRUD-эндпоинты для учеников
– POST /students — создать ученика;
– GET /students — список учеников;
– GET /students/{id} — карточка;
– PUT /students/{id} — обновить;
– (опционально) DELETE /students/{id} — удаление/деактивация;
– валидация входных данных, базовая обработка ошибок.
(Можно использовать вспомогательные библиотеки для CRUD, если итоговый контракт совпадает со спецификацией.)
Деплой на VPS
– поднять приложение на уже оплаченном сервере (Linux/VPS);
– настроить подключение к PostgreSQL;
– настроить запуск сервиса (uvicorn/gunicorn + nginx или Docker + docker-compose);
– чтобы по URL можно было открыть Swagger (/docs) и потестировать эндпоинты.
Мини-документация
– короткий README: как поднять проект локально, запустить миграции и как деплоить на сервер.
Дальнейшие этапы (если сойдёмся по первому мильстоуну)
На весь MVP планируется порядка 15–20 эндпоинтов по основным сущностям: преподаватель, ученики, уроки/календарь, баланс, авторизация.
Примерный план мильстоунов:
– Мильстоун 2: сущность «урок» и календарь (создание/редактирование, список по датам, привязка к ученику).
– Мильстоун 3: баланс уроков и операции (текущий баланс ученика, пополнения/списания, история).
– Мильстоун 4: авторизация (email+пароль, JWT) + кросс-авторизация через Google и Яндекс (OAuth2), привязка всех данных к teacher_id.
Все сценарии и контракты по API уже описаны в аналитике, на этапе оценки скину подробные спецификации.
Формат работы
– Part-time, ориентировочно 10–15 часов в неделю (можно обсудить);
– удалёнка, общение в Telegram/Zoom/Яндкес-телемост
– работа по мильстоунам
– сначала оцениваем объём
– согласуем стоимость и дедлайн мильстоуна
– двигаемся по результатам
Кого ищу
– опыт коммерческой разработки на Python/FastAPI от 1–1,5 лет;
– уверенное владение PostgreSQL и ORM (SQLAlchemy или аналог);
– умение работать по спецификациям (брать описанный эндпоинт и превращать в рабочий код);
– базовый опыт деплоя на Linux-сервер (VPS) или готовность аккуратно в этом разобраться;
– не пропадать без связи и нормально обсуждать сроки 🙂
Плюсом будет:
– опыт в небольших продуктах/стартапах;
– опыт настройки Docker/nginx;
– опыт реализации авторизации/JWT/OAuth2.
Что прошу в отклике
– пару слов о себе (опыт, стек);
– ссылку на GitHub/GitLab;
– 1–2 примера backend-проектов (желательно на FastAPI или другом Python-фреймворке для REST);
– желаемую почасовую ставку или цену за Мильстоун №1;
– примерную оценку по времени: сколько часов, по твоему мнению, займёт Мильстоун №1.
Если хочется сделать аккуратный небольшой сервис с понятными этапами - пиши 👌
А атаче пример аналитки