aswi20220x00-gitlab/Backend/README.md @ cc4d8aa7

# Backend

Backend je implementován v ASP.NET (.NET 6). Pro perzistentní ukládání dat je použit ORM framework <code>Entity Framework</code>. Ve výchozím nastavení se používá databáze PostgreSQL.
Případná změna použitého databázového serveru by znamenala instalaci patřičného NuGet balíčku pro EntityFramework, upravení připojovacího scriptu a vygenerování nového migrace.

## RestAPI

Projekt RestAPI se stará o obsluhu REST API. Obsahuje <code>Program.cs</code>, ve kterém jsou definovány DI a globální nastavení (např. validace JWT).
O zpracování žádosti (HTTP Request) se starají kontrolery (ve složce <code>Controllers</code>), ve kterých se pro větší přehlednost používá fixní mapování cest.
V RestAPI se také nachází Middleware pro Error handling (automatický překlad vyhozených výjimek na patřičný HTTP Status code) a JWT Middleware (zajišťuje validaci zaslané autentizace a přidání informací o přihlášeném uživateli do HttpContextu pro další zpracování)

## Models

Projekt Models obsahuje data-transfer-objekty, které se využívají pro komunikaci frontend <-> rest-api a rest-api <-> services.

## Core

Projekt Core obsahuje služby (<code>Services</code>), ve kterých je implementována veškerá podstatná funkcionalita. Zároveň obsahuje definici databáze (<code>Contexts</code>, <code>Entities</code>). 
Pro mapování entit na DTO lze využít AutoMapper (<code>MapperProfiles</code>), který ušetří programátorům spoustu rutinní práce.


# Nastavení
Klíčová nastavení projektu projektu se nacházejí v souboru <code>appsettings.json</code>.
Je připravena verze pro ostré nasazení - <code>appsettings.json</code> a verze pro vývoj - <code>appsettings.Development.json</code>.

Rozdíl mezi těmito verzemi je v ConnectionString, tedy řetězci pro připojení do databáze.
Očekává se, že ConnectionString bude v produkční verzi přidán do ENV.