Ресурсы и доступ
Где открыть сервис, API, публичные раздачи для учеников и как устроена документация для интеграторов.
Здесь собраны рабочие адреса TeacherFlow и кратко — что на каждом из них доступно. Для знакомства с продуктом логично начать с веб-приложения, затем при необходимости перейти к API.
Веб-приложение для учителя
Адрес: https://teacherflow.ru
Регистрация и вход, создание заданий, генерация вариантов, библиотека, классы, экспорт PDF и Word, назначение вариантов классу. Это основная точка входа для пилота в школе.
Подробный сценарий работы — в разделе Как работает сервис.
Публичные раздачи для учеников
Адрес: https://share.teacherflow.ru
Read-only страницы по ссылке: ученик видит текст своего варианта без ответов и без доступа к чужим вариантам. Учитель создаёт ссылку из кабинета после генерации или из журнала назначения класса (в том числе для удалённых).
API и документация для разработчиков
Корень API: https://api.teacherflow.ru
На главной странице API — краткое описание возможностей платформы, ссылки на интерактивную документацию и проверки работоспособности.
Интерактивная документация (Swagger UI): https://api.teacherflow.ru/docs
Описание REST-эндпоинтов: задания, генерация, варианты, классы, назначения, экспорт. Для вызовов нужна авторизация по Bearer JWT (как в веб-приложении).
Схема OpenAPI (JSON): https://api.teacherflow.ru/openapi.json
Машиночитаемое описание API для генерации клиентов и интеграций.
Проверка доступности:
- Liveness — процесс API отвечает: https://api.teacherflow.ru/healthz
- Readiness — готовность принимать трафик (база данных и зависимости): https://api.teacherflow.ru/readyz
Исходный код
Проект разрабатывается в открытом для команды репозитории:
Репозиторий: https://gitlab.vadimevgrafov.ru/learning/teacherflow
Для заказчика и партнёров важно: вся продуктовая информация для знакомства с проектом собрана на этой странице заказчика (раздел «О проекте» и «Материалы»). Репозиторий нужен прежде всего команде разработки, аудиту и интеграторам, которым нужен доступ к коду.
Демо для защиты: папка demo-materials — TXT-методички и скриншоты эталонов для проверки методсоветника.
Справка и FAQ
- Справка для учителя — пошаговые статьи, в том числе Методматериалы.
- FAQ для жюри — шпаргалка Q&A на защиту.
- Все ссылки (QR) — посадочная для презентации.
Связь с другими статьями базы знаний
- Карточка прототипа — что за продукт и для кого.
- Методматериалы — методички, КТП, советник.
- Методология — как устроен контроль сложности.
- План развития — этапы после текущей версии.
- Промышленная эксплуатация — масштаб, безопасность, пилот.