# teeu

Маркетплейс товаров всех категорий. Laravel 13 · PHP 8.3 · MySQL 8 · Blade (SSR) · Tailwind v4 ·
Alpine · Filament 5 (admin). Разрабатывается поэтапно по `tmp/тз.md`.

Документация — в [`docs/`](docs/):
[architecture](docs/architecture.md) ·
[authentication](docs/authentication.md) (телефон/OAuth, согласие, terms-gate) ·
[catalog](docs/catalog.md) (гео, категории/Ozon-дерево, товары, фильтры, контент-страницы, Новинки) ·
[seller](docs/seller.md) (кабинет, регистрация, статистика) ·
[yml-import](docs/yml-import.md) (импорт, маппинг категорий, зона доставки фида) ·
[seller-integrations](docs/seller-integrations.md) (заказы в CRM, Битрикс24 и Telegram) ·
[cabinet](docs/cabinet.md) (корзина/доступность, заказы, отследить заказ) ·
[ai-moderation](docs/ai-moderation.md) · [queues](docs/queues.md) ·
[design-inventory](docs/design-inventory.md) · [deployment](docs/deployment.md) ·
[roadmap](docs/roadmap.md) · [placeo-reference-audit](docs/placeo-reference-audit.md).

## Требования

- PHP 8.3+ с расширениями: `gd`, `exif`, `fileinfo`, `xmlreader`, `simplexml`, `dom`, `curl`,
  `openssl`, `pdo_mysql`, `mbstring`, `intl`, `bcmath`, `zip`, `sodium`.
- MySQL 8+ / MariaDB (InnoDB, utf8mb4).
- Node 20+ / npm.
- Composer 2.

## Установка (dev)

```bash
composer install
cp .env.example .env
php artisan key:generate

# создать БД teeu (utf8mb4) и прописать доступ в .env (DB_DATABASE=teeu)
php artisan migrate --seed         # создаёт роли и dev-администратора
php artisan storage:link

npm install
npm run build                      # или npm run dev
```

Dev-администратор из сидера: `admin@teeu.test` / `password` (роль admin, доступ к `/developer`).

## Запуск

```bash
php artisan serve                  # или Laragon-хост http://teeu.test
php artisan queue:work --queue=default,ai,images,yml-processing,yml-download,notifications
php artisan schedule:work
npm run dev                        # HMR фронтенда
```

Панели: публичный сайт `/`, кабинет покупателя `/account`, кабинет продавца `/{SELLER_PANEL_PREFIX}`
(по умолчанию `/merchant`), admin `/{ADMIN_PANEL_PREFIX}` (по умолчанию `/developer`).

## Тесты

```bash
php artisan test
```

## Окружение (Laragon/Windows)

См. пути и особенности в [docs/architecture.md](docs/architecture.md) (composer.phar, node в PATH,
MySQL root без пароля).