# Корзилла.Админ — фронтенд

Веб-интерфейс сервиса «Корзилла.Админ» — приложения для владельцев бизнеса и администраторов, которое объединяет управление сайтами, заказами и коммуникациями в одном месте. Проект включает публичный лендинг, авторизацию и личный кабинет: подключение и синхронизацию сайтов, уведомления, управление доступами пользователей, активные сессии и настройки профиля.

Мобильные приложения: [App Store](https://apps.apple.com/ru/app/админ-корзилла/id6757182473) и [RuStore](https://www.rustore.ru/catalog/app/com.korzilla.admin).

## Начало работы

Эти инструкции помогут развернуть копию проекта на локальной машине для разработки и тестирования. О развёртывании на боевом сервере см. раздел [Развёртывание](#развёртывание).

### Требования

Для работы понадобятся:

- [Node.js](https://nodejs.org/) 22 или новее
- [pnpm](https://pnpm.io/) 10 (удобнее всего включить через Corepack)
- Запущенный бэкенд Корзилла.Админ (API)
- [Docker](https://www.docker.com/) и Docker Compose — для запуска в контейнере (необязательно)

```bash
corepack enable
corepack prepare pnpm@10.26.2 --activate
```

### Установка

1. Клонируйте репозиторий и перейдите в папку проекта:

   ```bash
   git clone <url-репозитория>
   cd korzilla-admin-frontend
   ```

2. Установите зависимости:

   ```bash
   pnpm install
   ```

3. Создайте файл `.env` в корне проекта и укажите переменные окружения:

   ```env
   NEXT_PUBLIC_URL=http://localhost:3000
   NEXT_PUBLIC_API_URL=http://localhost:8000
   ```

   | Переменная            | Описание                          |
   | --------------------- | --------------------------------- |
   | `NEXT_PUBLIC_URL`     | Публичный адрес фронтенда         |
   | `NEXT_PUBLIC_API_URL` | Адрес API бэкенда                 |

4. Запустите сервер разработки:

   ```bash
   pnpm dev
   ```

После этого приложение будет доступно по адресу [http://localhost:3000](http://localhost:3000): откроется лендинг, а по ссылке на вход — страница авторизации (`/auth/signin`). После входа доступен личный кабинет (`/app`).

## Запуск тестов

Автоматические тесты в проекте пока не настроены. Перед отправкой изменений проверьте, что проект собирается и проходит линтер.

### Проверка сборки

Сборка выполняет проверку типов TypeScript и собирает production-версию приложения:

```bash
pnpm build
```

### Проверка стиля кода

Линтинг выполняется с помощью ESLint (конфигурация `eslint-config-next`):

```bash
pnpm lint
```

Форматирование — Prettier (одинарные кавычки, без точек с запятой, отступ 2 пробела, без висячих запятых; см. `.prettierrc`):

```bash
pnpm exec prettier --write .
```

## Развёртывание

Приложение собирается в режиме `standalone` и запускается в Docker-контейнере на порту `3000`.

Ручной запуск:

```bash
docker compose up -d --build
```

Переменные `NEXT_PUBLIC_URL` и `NEXT_PUBLIC_API_URL` должны быть заданы в `.env` до сборки — они встраиваются в клиентский бандл на этапе билда.

## Технологии

- [Next.js 16](https://nextjs.org/) (App Router) и [React 19](https://react.dev/) — фреймворк и UI-библиотека
- [TypeScript](https://www.typescriptlang.org/) — язык
- [Tailwind CSS 4](https://tailwindcss.com/) и [shadcn/ui](https://ui.shadcn.com/) (Radix UI, Base UI) — стили и компоненты
- [TanStack Query](https://tanstack.com/query) — работа с серверным состоянием
- [TanStack Table](https://tanstack.com/table) — таблицы
- [ky](https://github.com/sindresorhus/ky) — HTTP-клиент
- [React Hook Form](https://react-hook-form.com/) и [Valibot](https://valibot.dev/) — формы и валидация
- [pnpm](https://pnpm.io/) — менеджер пакетов
- [Docker](https://www.docker.com/) — развёртывание

## Структура проекта

```
src/
├── app/        # Маршруты Next.js: лендинг, auth, личный кабинет (app), документы (docs)
├── features/   # Функциональные модули: auth, site, notification, session, user, user-grants, feedback
├── widgets/    # Крупные составные блоки страниц (шапка, навигация, секции лендинга)
└── shared/     # Общий код: UI-компоненты, API-клиент, хуки, провайдеры, утилиты, конфиг
```

## Участие в разработке

1. Создайте ветку от основной: `git checkout -b feature/название-задачи`.
2. Внесите изменения, соблюдая стиль кода проекта.
3. Убедитесь, что `pnpm lint` и `pnpm build` проходят без ошибок.
4. Закоммитьте изменения и создайте merge request.

## Версионирование

Для версионирования используется [SemVer](http://semver.org/). Текущая версия указана в `package.json`. Доступные версии смотрите в тегах репозитория.
