Arryt — Courier Logistics v2

• Что это: система управления доставкой/курьерами (используется, в том числе, внутри экосистемы Restaurant chain (UZ) — ср. check_arryt в crm_chopar). Админ-панель для менеджеров + REST/type-safe API + аналитика + Flutter-приложение водителя + очереди/крон. Назначение заказов, трекинг водителей, движок ценообразования, балансы по терминалам.
• Тип / статус / роль: web-app (мультиприложение + мобилка) / active / lead (по кейсу «Lead Full-Stack Developer», команда из 3; в git пользователь — топ-автор с 173/329 ≈ 53%, далее Ilhombek 90, Shahzod 34).
• Период активности: 2023-11-04 → 2026-03-22 (~2.5 года); new_arryt — современный переписанный вариант (Elysia/Bun/Next15) проекта arryt (#8).

• API (`api/`): ElysiaJS (Bun) + Drizzle ORM (+typebox/zod) + PostgreSQL + Redis; BullMQ/Bull (джобы); DuckDB (@evan/duckdb — аналитика); OpenTelemetry (@elysiajs/opentelemetry, auto-instrumentations, OTLP exporter — распределённый трейсинг); server-timing, bearer-auth, Eden.
• Admin (`admin/`, `new_admin/`): Next.js 15 + React 19, Tanstack Query, shadcn/ui, real-time (WebSocket).
• Mobile (`mob/`): Flutter (Dart) — приложение водителя: BLoC, GraphQL, ObjectBox (офлайн), Firebase (пуши), фоновый GPS-трекинг.
• Другое: mcp_server/ (собственный MCP-сервер!), protos/ + proto.ts (gRPC/protobuf), duck_api/ (аналитика на DuckDB), queue/, crons/, transfer_db/.
• DevOps: Docker, PM2, GitHub Actions, Nginx.

• Полное переписывание на Elysia/Bun/Next15 (v2) с type-safe API (Eden).
• DuckDB-аналитика поверх PostgreSQL (отчёты по 1M+ записей).
• OpenTelemetry-трейсинг для API.
• Flutter-приложение водителя (офлайн-режим, GPS, пуши).
• Собственный MCP-сервер (mcp_server/) — вероятно, для AI-доступа к логистическим данным.
• Слой gRPC/protobuf (protos/, proto.ts).
• Подготовлены Arryt-Case-Study.md/html (портфолио-кейс) и arryt_monetization.md (монетизация).
• Объём: 329 коммитов за ~2.5 года, 173 от пользователя (топ-автор).

(По коду/манифестам + кейсу; пользователь — lead / топ-автор.)

• DuckDB-аналитика поверх PostgreSQL (@evan/duckdb, duck_api/, order_data.duckdb): тяжёлые аналитические запросы по 1M+ заказов выносятся во встраиваемый OLAP-движок DuckDB, разгружая транзакционный Postgres. → Чистое разделение OLTP/OLAP — нечастый и сильный выбор.
• Распределённый трейсинг (OpenTelemetry) в Elysia API (auto-instrumentations + OTLP): продакшн-обзервабилити и оптимизация латентности (<50ms по кейсу). → Зрелый подход к observability.
• Движок динамического ценообразования: правила по расстоянию/времени, бонусы водителям, тарифы под конкретных клиентов, дневная гарантия; правила кэшируются в Redis + аудит изменений.
• Трекинг 500+ водителей в реальном времени: энергоэффективный фоновый GPS, геофенсинг для авто-смены статусов, кластеризация маркеров на карте.
• gRPC/protobuf + собственный MCP-сервер: type-safe слой межсервисного взаимодействия + AI-доступ к логистическим данным.
• Обработка высоких нагрузок: курсорная пагинация, bulk-операции над 1000+ заказов, оптимизация индексов.

• Найдено сессий: 39 .jsonl-файлов в локальной директории сессий Claude Code для этого проекта. Плюс .cursor / .cursorrules (26 KB) — Cursor + Claude Code.
• Что делалось с AI: переписывание/фичи v2, вероятно генерация кейса и MCP-сервера. Глубоко не сэмплировалось (большой объём).
• Паттерн: мультитул (Claude Code + Cursor), собственный MCP-сервер как часть продукта (AI-доступ к данным).