How loculus-project/loculus works
Main Components Identification
a) Frontend Layer:
• Website (React/Astro-based web interface)
• Keycloakify (custom authentication UI)
b) Backend Services:
• Main Backend (Kotlin-based)
• LAPIS (for querying data)
• Preprocessing Pipeline
• ENA Submission Service
c) Authentication:
• Keycloak Server
d) Databases:
• Main Database (PostgreSQL)
• LAPIS Database
┌─ Client Layer ─────────────────────┐
• Web Browser / API Clients │
• ┬───────────────────┘
• ↓
┌─ Frontend Layer ───────────────────┐
• Website (Astro/React) │
• Keycloakify Theme │
• ┬───────────────────┘
• ↓
┌─ API Gateway Layer ────────────────┐
• Ingress Controller / Load Balancer │
• ┬──────────┬────────────┘
• ↓ ↓
┌─ Service Layer ──────────────────────────────────┐
• ┌─────────────┐ ┌──────────┐ ┌────────────────┐ │
• Main Backend │ │ LAPIS │ │Preprocessing │ │
• (Kotlin) │ │ │ │Pipeline │ │
• ┘ └──────────┘ └────────────────┘ │
• ┌─────────────┐ ┌──────────────────────────────┐│
• ENA │ │Keycloak Authentication ││
• Submission │ │Server ││
• ┘ └──────────────────────────────┘│
• ┬──────────┬────────────┬────────────┘
• ↓ ↓ ↓
┌─ Data Layer ───────────────────────────────────┐
• ┌─────────────┐ ┌──────────┐ ┌──────────────┐ │
• Main Database│ │LAPIS DB │ │Keycloak DB │ │
• (PostgreSQL) │ │ │ │ │ │
• ┘ └──────────┘ └──────────────┘ │
• ┘
Key Interactions to Highlight
• User authentication flow through Keycloak
• Sequence submission and preprocessing pipeline
• Search queries through LAPIS
• Data synchronization between databases
• ENA submission workflow
Important Details
• Kubernetes deployment boundaries
• API endpoints and communication protocols
• Data flow directions
• Authentication boundaries
• External service integrations
Specific Implementation Notes
• How the preprocessing pipeline can be customized/extended
• Flexible metadata field configuration
• Multi-segmented genome support
• Group management and access control flow