Aleksey Razorvin
51df045220
- TestForm: смысловые блоки «Метаинформация» / «Версии теста» / «Содержание» / команды - AI-генерация: мини-форма из 3 полей (тема, число вопросов, число вариантов) - Кнопка «Проверить тест» переехала в нижнюю панель команд - Backend: GenerateRequest принимает answers_count, передаётся в промпт - Убрано упоминание API-ключа в fallback-сообщении формы Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
QA Test App — Система тестирования сотрудников клиники
Веб-приложение для проведения внутреннего тестирования сотрудников. Руководители подразделений создают тесты, назначают их сотрудникам, система фиксирует результаты.
Проект разрабатывается как мастер-класс для джуниор-разработчиков. История разработки — пошаговые запросы и решения — сохраняется в
DOC/ШАГИ/.
Формат тестирования
- Вопрос + минимум 3 варианта ответа (один или несколько правильных)
- Минимум 7 вопросов в тесте
- Случайный порядок вопросов при каждом прохождении
- Опциональный таймер на прохождение
- Порог зачёта задаётся автором теста (%)
Роли
| Роль | Возможности |
|---|---|
| HR-менеджер / Директор | Создаёт тесты, назначает всем сотрудникам клиники, видит все результаты |
| Руководитель подразделения | Создаёт тесты, назначает только своему отделу, видит результаты своего отдела |
| Сотрудник | Проходит назначенные тесты, видит свои результаты и ошибки |
Стек
| Слой | Технология |
|---|---|
| Backend | Python 3.12 + FastAPI + SQLAlchemy 2.0 + Alembic |
| База данных | PostgreSQL 16 |
| Frontend | React 18 + TypeScript + Vite + Ant Design + TanStack Query |
| Инфраструктура | Docker Compose + Nginx |
| AI-помощник | DeepSeek API (openai-совместимый) — Спринт 4 |
| Уведомления | Мессенджер MAX — Спринт 7 |
План спринтов
| Спринт | Содержание | Статус |
|---|---|---|
| 1 | Инфраструктура (Docker, FastAPI, React, PostgreSQL) + создание тестов | ✅ |
| 2 | Прохождение теста + результаты и разбор ошибок | ✅ |
| 3 | Редактирование тестов + версионность | ✅ |
| 4 | AI-помощник при создании/редактировании тестов (DeepSeek) | ✅ |
| 5 | Трекер результатов | ✅ |
| 6 | Авторизация, роли, подразделения, управление пользователями | ⬜ |
| 7 | Уведомления в MAX | ⬜ |
Документация
| Файл | Содержание |
|---|---|
DOC/ТЗ.md |
Техническое задание (v1.2) |
DOC/СТЕК.md |
Технологический стек с обоснованием |
DOC/СПРИНТЫ.md |
Детальный план спринтов с задачами |
DOC/ШАГИ/ |
История разработки шаг за шагом |
Запуск (после Спринта 1)
docker compose up --build
Приложение будет доступно на http://localhost.