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 |