LogiPlatform – Логистична борса и операционна платформа

Модерна B2B платформа за логистична борса с multi-tenant архитектура, интеграции с външни системи (TIMOCOM, webhooks), event-driven ядро и административен панел.

---

Какво представлява платформата

LogiPlatform е софтуерна платформа за управление на логистични операции:

• Логистична борса – публикуване и търсене на товари (Loads), изпращане и получаване на оферти (Offers)
• Multi-tenant – компании, членства, роли (RBAC) – всяка компания има изолирана среда
• Shipment lifecycle – проследяване на пратки от назначаване до доставка
• Integration Hub – унифицирани адаптери за външни системи (TIMOCOM, webhooks, бъдещи)
• Documents Engine – lifecycle на документи (upload → verify/reject), KYC за компании и потребители
• Event система – audit logs, webhooks, real-time събития
• Admin панел – управление на компании, потребители, документи, интеграции, метрики

Ключови модули

Модул	Описание
Core	Event layer, tenant context, documents engine, state machines
Loads & Offers	Товари, оферти, преговори, статусни машини
Shipments	Пратки, tracking, CMR/POD документи
Contracts	Шаблони, версии, подписи, одобрения
Integrations	TIMOCOM sync, webhooks (Svix), API keys
Billing	Stripe subscriptions, invoicing
Analytics	Metabase dashboards, метрики, отчети

---

Технологичен стек

Слой	Технологии
Frontend	Next.js 14 (App Router), React 18, TypeScript, Tailwind CSS, shadcn/ui, TanStack Table, Framer Motion
Backend	Next.js API Routes, Prisma ORM
База данни	PostgreSQL
Търсене	Meilisearch
Кеш/Queues	Redis, BullMQ
Auth	Owner session (super admin), демо auth за разработка
Плащания	Stripe
Мониторинг	Sentry

---

Структура на проекта

logistic/
├── apps/
│   └── web/                    # Next.js приложение
│       ├── src/
│       │   ├── app/            # App Router, API routes
│       │   ├── components/     # React компоненти
│       │   ├── lib/            # Core, auth, integrations
│       │   └── middleware.ts
│       └── prisma/             # Schema, migrations
├── packages/
│   └── shared/                 # Споделени типове, константи
├── docs/                       # Документация
├── docker/                     # Docker конфигурации
├── scripts/                    # Deploy, seed, workers
├── docker-compose.yml
└── turbo.json

---

Бърз старт

1. Изисквания

• Node.js ≥ 18
• pnpm (препоръчително)
• Docker & Docker Compose

2. Инсталация

# Клониране
git clone https://git.vi-lab.eu/orion/logistic.git
cd logistic

# Зависимости
pnpm install

# Инфраструктура
docker-compose up -d

# База данни
cd apps/web && pnpm db:generate && pnpm db:migrate && pnpm db:seed

3. Environment

Създайте apps/web/.env.local:

DATABASE_URL="postgresql://logistic:logistic_dev_password@localhost:5432/logistic_dev"
MEILISEARCH_HOST="http://localhost:7700"
MEILISEARCH_MASTER_KEY="meili_master_key_dev_change_in_production"
REDIS_URL="redis://localhost:6379"

# Опционално за owner admin
OWNER_LOGIN_ENABLED=true
OWNER_EMAIL=admin@example.com
OWNER_PASSWORD_HASH=...
OWNER_SESSION_SECRET=...

4. Стартиране

pnpm dev

Приложението е достъпно на http://localhost:1111.

---

Скриптове

Команда	Описание
pnpm dev	Development сървър
pnpm build	Production build
pnpm lint	ESLint
pnpm db:generate	Prisma generate
pnpm db:migrate	Prisma migrations
pnpm db:studio	Prisma Studio
pnpm db:seed	Seed данни

---

Документация

Файл	Описание
docs/CORE_ARCHITECTURE.md	Core ядро, events, tenant, documents
docs/architecture.md	Обща архитектура
docs/integration-hub.md	Integration Hub, адаптери
docs/rbac.md	RBAC матрица
docs/OWNER_AUTH.md	Owner/SuperAdmin вход
docs/ROADMAP.md	План за развитие

---

Репозиторий

• URL: https://git.vi-lab.eu/orion/logistic
• Организация: VI Team Security Group (orion)
• Лиценз: Private

---

Контакти

За въпроси и поддръжка – чрез VI Team Security Group.