# EvoFirewall — Руководство для ИИ

## Описание

EvoFirewall — централизованный firewall controller (Linux / MikroTik agents, blocklists, статистика). Интеграции: **auth-portal** (app id `fw`), **EvoBGP** (источник префиксов).

## Стек

- Monorepo: pnpm + turbo (`apps/*`, `packages/*`)
- `apps/web` — Vite + React + TanStack + shadcn **base-nova** + ReUI Frame
- `apps/api` — Fastify + Drizzle + SQLite
- Packages: `@evofw/ui`, `@evofw/shared`, `@evofw/db`

## Команды

```bash
pnpm install
pnpm --filter @evofw/shared build
pnpm --filter @evofw/db build
pnpm --filter @evofw/api dev
pnpm --filter @evofw/web dev
pnpm --filter @evofw/web build
```

## ReUI PRO

Surface: **frame**. Hierarchy: **ReUI PRO > shadcn**. Contract: `docs/ui-design-contract.md`.  
MCP `user-reui` primary + `plugin-shadcn-shadcn` primitives. CLI из `apps/web`.  
KPI/QuickActions: EvoBGP hybrid SoT (`KpiStatGrid`, `QuickActionGrid`).

## Docs

`docs/architecture.md`, `docs/agents.md`, `docs/integrate-auth-portal.md`, `docs/integrate-evobgp.md`.

## Git

`origin` → https://git.shts.su/denozord/EvoFirewall.git