Správa projektov firmy

Jednoduchá aplikácia na správu projektov firmy: prihlásenie, zoznam projektov a CRUD operácie (nový / editácia / zmazanie), s XML úložiskom za vymeniteľným rozhraním. Testovací príklad k pohovoru (.NET).

• Backend: ASP.NET Core (.NET 10) Web API
• Frontend: Blazor WebAssembly
• Architektúra: Clean Architecture (proporcionálne) + vertical slices, trojvrstvové oddelenie
• Úložisko: XML súbory za IProjectRepository (pripravené na výmenu za DB/REST/Cloud)
• Autentifikácia: self-issued JWT; heslo ako hash+salt v konfiguračnom XML
• Logovanie: Serilog (štruktúrované, console + rolling file)
• Testy: xUnit + FluentAssertions + NSubstitute + WebApplicationFactory (47 testov)

Dokumentácia

• Design dokument — architektúra, rozhodnutia a ich odôvodnenie.
• Implementačný plán — task-by-task postup s kódom.
• Architektúra – diagramy — vrstvy, závislosti a runtime tok (Mermaid).

Predpoklady

• .NET 10 SDK (10.0.2xx alebo novší)
• Voliteľne Docker (Docker Desktop / Engine 28+) pre beh cez kontajnery

Vývojové prostredie

Reálne bolo riešenie vyvíjané vo Visual Studio Code s asistenciou Claude CLI (Claude Code) — agentického nástroja v termináli, ktorý generoval a upravoval kód, spúšťal dotnet build/test aj docker compose a viedol TDD cyklus. Dôvody tejto voľby:

• VS Code — odľahčené, multiplatformové editorové prostredie; s rozšírením C# Dev Kit plne pokryje .NET 10 solution (build, debug, testy) a dobre sa kombinuje s prácou v termináli.
• Claude CLI (Claude Code) — terminál-centrický agentický workflow (čítanie/úpravy/spúšťanie priamo v repozitári), TDD a priebežné code-review; keďže build/test/run beží cez dotnet a docker, nič nie je viazané na konkrétne IDE.
• C# / .NET 10 (LTS-trieda) — jeden jazyk pre backend aj frontend (Blazor), zdieľané DTO (Contracts) a typová bezpečnosť cez celý stack.

Projekt nie je viazaný na jedno IDE — rovnako sa otvorí a spustí aj vo Visual Studio 2022+ alebo JetBrains Rider. Odôvodnenie výberu knižníc a frameworkov je v design dokumente (§12).

Prihlasovacie údaje (demo)

používateľ: admin
heslo:      Admin123!

Toto je zdokumentovaný demo účet potrebný na spustenie. V config.xml je uložený len PBKDF2 hash hesla (nie plaintext). Podpisový kľúč JWT (Auth:SigningKey) je secret: pre lokálny beh sa berie z user-secrets a v repozitári nie je. Kvôli jednoduchému vyskúšaniu obsahuje deploy/docker-compose.yml throwaway demo kľúč — v reálnom nasadení ho nahraď vlastným (env premenná / secret manager) a demo hodnotu nikdy nepoužívaj v produkcii.

Konfigurácia

Nastavenie	Kde	Poznámka
Cesta k XML úložisku	config.xml → Storage:ProjectsFilePath	default ../../data/projects.xml
Používateľ + hash hesla	config.xml → Auth:Username / Auth:PasswordHash	hash, nie plaintext
Issuer / Audience / expirácia tokenu	config.xml → Auth:*
JWT podpisový kľúč (secret)	user-secrets / env Auth__SigningKey	min. 32 znakov (fail-fast guard)
API URL pre klienta	src/ProjectManager.Client/wwwroot/appsettings.json → ApiBaseUrl	klient ho číta za behu
CORS origin klienta	appsettings.json → Cors:ClientOrigin / env Cors__ClientOrigin

Pred prvým spustením API nastav podpisový kľúč (lokálne, raz):

cd src/ProjectManager.Api
dotnet user-secrets set "Auth:SigningKey" "dev-only-signing-key-please-change-min-32-chars-1234"
cd ../..

Spustenie

A) Lokálne cez IDE / dva terminály (bez Dockera)

Spusti API a klienta súčasne (dva startup projekty v IDE, alebo dva terminály):

dotnet run --project src/ProjectManager.Api      # http://localhost:5186
dotnet run --project src/ProjectManager.Client   # http://localhost:5150

Otvor URL klienta v prehliadači → presmeruje na /login → prihlás sa demo údajmi.

Klient volá API na ApiBaseUrl z wwwroot/appsettings.json (default http://localhost:5186, čo zodpovedá http profilu API).

B) Docker Compose

docker compose -f deploy/docker-compose.yml up --build

• Klient (nginx): http://localhost:8080
• API: http://localhost:5186

Prečo práve tieto porty: Blazor WASM beží v prehliadači a volá ApiBaseUrl z host počítača. Aby jedna hodnota ApiBaseUrl fungovala v lokálnom dev aj v compose, API je v compose publikované na host porte 5186 (rovnako ako lokálny http profil), a klient sa servíruje cez nginx na 8080 (čo je Cors__ClientOrigin). Ak chceš klienta prepojiť na iné API, zmeň ApiBaseUrl v wwwroot/appsettings.json.

data/projects.xml je pripojený ako volume (../data:/data), takže dáta prežijú reštart kontajnera a cesta k úložisku je konfigurovateľná cez Storage__ProjectsFilePath.

Zastavenie: docker compose -f deploy/docker-compose.yml down.

Testy

dotnet test

Pokrýva doménu, aplikačné use-cases (List/Create/Update/Delete/Login), XML úložisko vrátane súbežného zápisu, a API integračne (auth 401/200, validácia 400, CRUD) cez WebApplicationFactory. UI testy sú zámerne mimo rozsahu (pozícia je backend-focused) — viď design dokument.

Logy

Štruktúrované logy idú na console (stdout — zoberie ich Docker) a do rolling file v src/ProjectManager.Api/logs/. Heslá ani tokeny sa nelogujú.

Rozsah a možné rozšírenia

Riešenie cieli na ~8 h a vedome nerobí veci, ktoré by boli pri tomto zadaní over-engineering (DB, MediatR, cache úložiska, refresh tokeny, multi-user, CI/CD). Sú navrhnuté ako jednoduché rozšírenia — detaily a odôvodnenie v design dokumente (§13–14). .NET Aspire bolo zvážené ako voliteľná vrstva navrchu pre orchestráciu a observability, ale vedome vyradené: orchestrácia Blazor WASM klienta je zatiaľ len v preview a vyžadovala by invazívne zmeny klienta bez úmernej hodnoty pri tomto rozsahu. Aplikácia je naň pripravená (Serilog → OTLP), no funguje plne aj bez neho.