Административная панель обращений клиентов

Русская версия | English version

MVP интерфейса административной панели для обработки обращений клиентов. Приложение показывает список обращений, позволяет искать клиента по имени или телефону, фильтровать по статусу, менять статус, назначать звонок и генерировать mock AI summary.

Статус

Основная кодовая часть тестового задания выполнена. Подробный чеклист соответствия требованиям находится в CHANGELOG.md.

Стек

• React 18
• TypeScript
• Vite
• Ant Design
• Zustand
• TanStack Query
• Axios
• Mock API через Axios adapter

Быстрый запуск

npm install
npm run dev

После запуска приложение будет доступно по адресу, который выведет Vite, обычно:

http://localhost:5173/

• Подробная инструкция по установке, мок API, Docker и сборке находится в BUILD.md.
• Исходная задача: TASK.md

Возможности

• таблица обращений с полями id, клиент, телефон, статус, дата создания;
• поиск по имени или телефону;
• фильтр по статусу;
• сортировка по дате создания;
• карточка обращения в боковой панели;
• просмотр информации о клиенте и комментария;
• изменение статуса обращения;
• назначение звонка;
• mock AI summary;
• realtime-like обновление через polling;
• виртуализированная таблица;
• светлая и темная тема;
• адаптивная верстка;
• строгая типизация TypeScript без any.

Архитектура

src/
  app/          провайдеры приложения, тема, корневой layout
  entities/     доменная модель, API-контракты и use-cases
  features/     UI-сценарии работы с обращениями
  shared/       repository, mock API, UI helpers, общие утилиты

Проверка качества

npm run lint
npm run build

Обе команды должны завершаться без ошибок. При сборке возможен warning Vite о размере чанка из-за Ant Design; он не блокирует production build.

Что нужно приложить при сдаче

• GitHub репозиторий с проектом;
• этот README и инструкции из BUILD.md;
• короткое видео с демонстрацией поиска, фильтра, смены статуса, назначения звонка и генерации summary.