How clyne-ui/vrom works
Vrom is a mobility-and-commerce platform with rider/customer operations, marketplace transactions, spatial matching, and an operations control center. The principal runtime flow is client requests through the Go HTTP server into domain handlers and persistent data; the admin console also calls backend endpoints for operational views and controls. Separate services provide spatial matching, AI capabilities, and Kafka stream analytics. The README contains no architecture detail, so several subsystem connections are shown only where source establishes them; unsampled integrations are omitted or marked unverified.
Main entry points: main.go HTTP API Server · shop_handler.go Marketplace · auth_service.go Token Service · database.go PostgreSQL Store
Components 25
Admin Console
- Operations UI
vrom/vrom-admin/app/dashboard/page.tsx - Admin API Client
vrom/vrom-admin/lib/api-client.ts - Admin Workspaces
vrom/vrom-admin/app/dashboard
Go Platform
- HTTP API Server
vrom/backend/cmd/vrom/main.go - Authentication
vrom/backend/internal/api/http/auth_handler.go - Token Service
vrom/backend/internal/services/auth_service.go - Access Middleware
vrom/backend/internal/api/middleware/auth.go - Operations Control
vrom/backend/internal/api/http/occ_handler.go - Live Updates
vrom/backend/internal/api/websocket/handler.go - PostgreSQL Store
vrom/backend/internal/repository/database.go
Mobility Commerce
- Marketplace
vrom/backend/internal/api/http/shop_handler.go - Orders & Trips
vrom/backend/internal/repository/order.go - Rider Operations
vrom/backend/internal/api/http/rider_handler.go - Spatial API
vrom/backend/internal/api/http/spatial_handler.go - Payments
vrom/backend/internal/services/payment_service.go - Media Uploads
vrom/backend/internal/services/media_service.go
Intelligence Services
- Spatial Matcher
vrom/matching_engine/src/main.rs - AI Service
vrom/ai_service/main.py
Event Analytics
- Event Producer
vrom/backend/internal/events/producer.go - Fraud Detection
vrom/stream_processor/src/main/java/com/vrom/stream/FraudDetectionJob.java - Surge Pricing
vrom/stream_processor/src/main/java/com/vrom/stream/SurgePricingJob.java
Other components
- Admin
- Platform User
- Kafka
- Redis
Connections 21
- Admin → Operations UI: uses
vrom/vrom-admin/app/dashboard/page.tsx - Operations UI → Admin API Client: requests data
- Admin API Client → HTTP API Server: calls endpoints
- HTTP API Server → Authentication: routes auth
vrom/backend/cmd/vrom/main.go - HTTP API Server → Operations Control: routes operations
vrom/backend/cmd/vrom/main.go - HTTP API Server → Marketplace: routes commerce
vrom/backend/cmd/vrom/main.go - HTTP API Server → Access Middleware: wraps protected routes
vrom/backend/cmd/vrom/main.go - Authentication → Token Service: issues tokens
vrom/backend/internal/api/http/auth_handler.go - Access Middleware → Token Service: validates tokens
- Token Service → Redis: checks revocation
vrom/backend/internal/services/auth_service.go - Marketplace → PostgreSQL Store: queries data
- Operations Control → PostgreSQL Store: reads operations data
- Spatial API → Spatial Matcher: requests matches
- Platform User → HTTP API Server: uses platform
- HTTP API Server → Live Updates: starts hub
vrom/backend/cmd/vrom/main.go - HTTP API Server → PostgreSQL Store: connects database
vrom/backend/cmd/vrom/main.go - Marketplace → Media Uploads: uploads media
- Orders & Trips → Payments: uses payment service
- Event Producer → Kafka: publishes events
- Kafka → Fraud Detection: consumes transactions
- Kafka → Surge Pricing: consumes events