Skip to content

Recron Documentation

Welcome to the Recron platform documentation.

Quick Start

Documentation Structure

Section Description
Architecture System architecture, C4 diagrams
Technical Technical documentation: backend, frontend, database
Business Requirements, domain model, business processes
Runbooks Operational procedures and troubleshooting
External Shared infrastructure: Traefik, Keycloak, VelvetUi

Technology Stack

graph TB
    subgraph Frontend
        A[SolidJS + TypeScript]
        B[CSS Modules]
        C[TanStack Solid Query]
    end

    subgraph Backend
        D[.NET 11 APIs]
        E[CQRS + Vertical Slices]
        F[Entity Framework Core]
    end

    subgraph Infrastructure
        G[(PostgreSQL)]
        H[Keycloak]
        I[OpenAI]
    end

    A --> D
    D --> G
    D --> H
    D --> I

Ecosystem

All repositories that make up the BluesBraces platform:

graph TB
    subgraph "Main Application"
        R[Recron<br/>Full-stack app]
    end

    subgraph "Shared Libraries"
        E[Extensions<br/>.NET NuGet packages]
        V[VelvetUi<br/>SolidJS component library]
    end

    subgraph "Shared Infrastructure"
        T[Traefik<br/>Reverse proxy + TLS]
        K[Keycloak<br/>Identity provider]
    end

    R -->|backend| E
    R -->|frontend| V
    R -->|routing| T
    R -->|auth| K
    V -->|demo hosted via| T
    K -->|exposed via| T

    style R fill:#7c4dff,color:#fff
    style E fill:#81d4fa
    style V fill:#81d4fa
    style T fill:#a5d6a7
    style K fill:#a5d6a7
Repository Type Purpose
Recron Full-stack app Interview preparation & job search management
Extensions .NET library Shared backend abstractions (CQRS, domain, infrastructure)
VelvetUi npm library SolidJS UI components & shared tooling presets
Traefik Docker service Reverse proxy, TLS termination, subdomain routing
Keycloak Docker service Shared identity provider (OIDC)

Services

Service Description
Questions API Interview questions, categories, voting, learning, quiz
Organizer API Job offer tracking, interviews, AI parsing, stats, CV matching
Portfolio API CV portfolio builder with variants, AI import
Users API User profiles and authentication details
Gateway YARP reverse proxy routing to microservices