Приложение для тестирования сотрудников клиники методом один вопрос - до пяти ответов один из которых правильный. Сотрудник должен выбрать правильный вариант ответа
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Aleksey Razorvin 0977eb0c38 fix: delete answers before questions in update_test to avoid FK violation 1 week ago
DOC docs: reorder sprints — editing+versioning moves to Sprint 3, tracker to Sprint 4 1 week ago
backend fix: delete answers before questions in update_test to avoid FK violation 1 week ago
frontend fix: show activate button in table row for current inactive version 1 week ago
nginx fix: resolve container startup issues 1 week ago
.env.example feat: Sprint 1 — infrastructure + test creation 1 week ago
.gitignore chore: init project structure 1 week ago
README.md docs: rewrite README with full project overview 1 week ago
docker-compose.yml feat: Sprint 1 — infrastructure + test creation 1 week ago

README.md

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
Уведомления Мессенджер MAX (Спринт 5)

План спринтов

Спринт Содержание
1 Инфраструктура (Docker, FastAPI, React, PostgreSQL) + создание тестов
2 Прохождение теста + результаты и разбор ошибок
3 Трекер результатов
4 Авторизация, роли, подразделения, управление пользователями
5 Уведомления в MAX

Документация

Файл Содержание
DOC/ТЗ.md Техническое задание (v1.1)
DOC/СТЕК.md Технологический стек с обоснованием
DOC/СПРИНТЫ.md Детальный план спринтов с задачами
DOC/ШАГИ/ История разработки шаг за шагом

Запуск (после Спринта 1)

docker compose up --build

Приложение будет доступно на http://localhost.