👻 Бюро переселения привидений

Тестовое задание AI-first Developer 2.0 для MOX. Веб-приложение для оператора бюро, которое подбирает привидениям новые места обитания, объясняет решения и честно показывает, если переселить кого-то невозможно.

Живая версия: https://ghost-bureau-peach.vercel.app AI Worklog: прямо в приложении, вкладка «AI Worklog» вверху страницы.

Запуск

npm install
npm run dev

Откроется на http://localhost:3000. Секретов/API-ключей не требуется — всё состояние живёт в браузере (React state), бэкенда и базы данных нет.

Тесты:

npm test        # vitest run (13 тестов на бизнес-логику подбора)

Прод-сборка:

npm run build && npm start

Как это устроено

src/
├── lib/
│   ├── types.ts        # доменные модели: GhostRequest, Place, Assignment
│   ├── matching.ts      # алгоритм подбора: жёсткие ограничения + мягкий скор
│   ├── matching.test.ts  # 13 тестов, включая все обязательные состояния
│   ├── report.ts          # итоговый отчёт
│   ├── labels.ts            # русские подписи для условий/освещения
│   └── seed.ts                # демо-данные, специально подобранные под edge cases
├── components/
│   ├── GhostForm.tsx     # форма новой заявки с валидацией
│   ├── AssignmentBoard.tsx # доска заявок + ручное переопределение места
│   ├── ReportView.tsx      # вкладка «Отчёт»
│   ├── WorklogView.tsx      # вкладка «AI Worklog»
│   ├── WorklogGhost.tsx      # фоновая анимация внутри карточек Worklog (отскакивающее привидение)
│   ├── ChainLink3D.tsx          # декоративный 3D-элемент (Three.js)
│   └── ParallaxBackdrop.tsx      # фоновые привидения: параллакс, парение, клик-пасхалка
└── app/page.tsx           # главная страница, связывает всё вместе

Визуальный стиль оформлен под референс mox-studio.ru (палитра, шрифт Montserrat как открытый аналог их Monts, wordmark-заголовок) — это уже сверх минимума из ТЗ, на логику подбора и обязательные состояния не влияет.

Алгоритм подбора

1. Жёсткие ограничения (дисквалифицируют место полностью): нужен чердак, боится зеркал, нельзя рядом с людьми.
2. Мягкий скор 0–100 среди мест, прошедших жёсткие ограничения: температура (до 30 баллов), тишина относительно тревожности (до 30), освещение (до 20), влажность для тех, кто любит сырость (до 20, у остальных — нейтральные 10).
3. Привидения обрабатываются по срочности: сначала ближайший дедлайн, при равенстве — более тревожные.
4. Если подходящих мест по жёстким условиям нет вообще — «нет подходящего места». Если есть, но все заняты — «места заняты». Если дедлайн уже прошёл — отдельная причина, до попытки подбора места.

Оператор может в любой момент переопределить место вручную (выпадающий список у каждой заявки) — приложение не блокирует плохой выбор, но честно предупреждает, что именно не так (нарушено жёсткое условие и/или место переполнено).

Чеклист проверки перед сдачей

• Пустой список заявок — кнопка «Очистить все заявки», показывается понятное пустое состояние, приложение не падает.
• Заявка без подходящего места — демо-привидение «Плакса Ивонна» (нужен чердак + боится зеркал — оба места с чердаком имеют зеркала).
• Место переполнено — три демо-привидения конкурируют за два места вместимостью 1 (маяк и типография), третье остаётся без места.
• Ручной выбор конфликтует с условиями — выбрать вручную место с зеркалами для привидения, которое их боится: показывается предупреждение.
• Просроченный дедлайн — демо-привидение «Старейшина Морн» с дедлайном в прошлом, отдельная причина в отчёте.
• Валидация формы — попытка добавить заявку без имени/с некорректной тревожностью показывает понятное сообщение об ошибке, не ломает страницу.
• npm test — 13/13 тестов проходят.
• npm run build — прод-сборка без ошибок типов и линта.

AI Worklog

Встроен в приложение (вкладка «AI Worklog»), не дублируется здесь намеренно — чтобы не было риска, что README и интерфейс разойдутся в описании процесса.