Examination

Examinationsuppgifter — gruppprojekt & eget bibliotek

Kursen examineras genom två obligatoriska uppgifter: ett grupparbete där ni bygger en komplett event-sourced applikation, och ett enskilt arbete där du paketerar din egen återanvändbara AggregateRoot<TId>-grund som ett bibliotek.

Om examinationen

Uppgift 1 — Grupp	3–4 personer · ~30 timmar/person · Inlämning V7
Uppgift 2 — Enskild	~15 timmar · Inlämning V7
Betygsskala	IG / G / VG
Krav för betyg	Båda uppgifterna måste vara minst G. För VG i kursen krävs VG på båda.
Examinationsform	Skriftlig inlämning (git-repo) + 20 min muntlig redovisning

Kursplanemål och täckningsmatris

Examinationen mäter följande mål från kursplanen. Varje mål täcks av minst en uppgift.

Mål	Lektion	Uppg. 1	Uppg. 2
Förklara DDD-grunder och bounded contexts	02	✓
Designa aggregat med invarianter och Apply-pattern	03	✓	✓
Implementera CQRS med MediatR-pipeline	04	✓
Persistera och rehydrera via event sourcing	05–06	✓	✓
Hantera concurrency, idempotency, transaktioner	07	✓
Bygga command-kö och compensating events	08	✓
Implementera snapshots och projection-rebuild	09	✓ (VG)	✓ (VG)
Bygga Blazor-klient med optimistic UI och undo	10	✓
Skriva enhetstester med Given-When-Then	05	✓	✓
Skriva integrationstester med Testcontainers	06–07	✓	✓ (VG)

Uppgift 1 — Gruppuppgift

Gruppuppgift

TicketHub — biljettbokning end-to-end

Grupp

3–4 personer

Tidsåtgång

~30 h / person

Inlämning

V7, fredag 23:59

Format

Git-repo + ADR + demo

Stack

.NET 10, SqlStreamStore, MSSQL, Blazor WASM

Scenario

Ni bygger TicketHub, ett system för biljettbokning till konserter. Användare ska kunna se konserter, välja platser, boka och betala. Bokningar kan avbokas och avbokade platser blir tillgängliga igen.

Krav på domänen

Tre aggregat: Concert, Seat, Booking. Identifiera invarianter och dokumentera dem.
Minst 5 olika domänevents (t.ex. ConcertScheduled, SeatReserved, BookingConfirmed, BookingCancelled, SeatReleased).
Affärsregler: en plats kan inte bokas av två personer samtidigt; man kan inte boka en plats på ett avlyst event; avbokning är möjlig fram till 24 h före event.

Tekniska krav

SqlStreamStore (MsSqlStreamStoreV3) som event store + MSSQL för read models — samma databas.
MediatR-pipeline med Logging, Validation och Idempotency.
AggregateCommandQueue framför skrivvägen — single-writer per StreamId.
Read model-projection som BackgroundService med checkpoint-tabell i samma TransactionScope.
Compensating event BookingCancelled + UI-knapp för avbokning.
Polly-retry vid ConcurrencyConflictException.
Blazor WebAssembly-klient med typed HttpClient och optimistic UI.
Minst 10 enhetstester (Given-When-Then) + minst 5 integrationstester (Testcontainers MSSQL).

Leveranser

Git-repo med tydlig README.md (köranvisningar, arkitekturdiagram).
ADR (Architecture Decision Record) i Markdown — minst 3 beslut motiverade.
Demo — 10 min screencast som visar happy path + avbokning + concurrency-konflikt.
Muntlig redovisning 20 min med Q&A från läraren.

Bedömningskriterier

Kriterium	G	VG
Domänmodell	3 aggregat med korrekta invarianter	+ tydlig ubiquitous language, dokumenterade context-gränser
Event sourcing	Skrivning + rehydrering fungerar	+ snapshots var N:te event, dokumenterad strategi
Concurrency	Optimistic concurrency + retry	+ Polly med exponential backoff, jitter, max-attempts
Projection	Read model + checkpoint	+ exactly-once via TransactionScope, zero-downtime rebuild
Undo	Compensating event finns	+ undo-stack i klienten + Ctrl+Z
Tester	Minimi-antal uppnått, alla gröna	+ >80 % kodtäckning, Testcontainers-baserade integrationstester
Dokumentation	README + ADR	+ arkitekturdiagram, sekvensdiagram för minst ett flöde

Uppgift 2 — Enskild uppgift

Enskild uppgift

AggregateRoot<TId> — eget återanvändbart bibliotek

Form

Enskild

Tidsåtgång

~15 h

Inlämning

V7, fredag 23:59

Format

NuGet-paket + sample

Stack

.NET 10, xUnit, FluentAssertions

Scenario

Du paketerar de grundpelare som varje event-sourced applikation behöver i ett återanvändbart bibliotek. Ditt bibliotek ska kunna släppas som NuGet-paket och användas av framtida projekt — inklusive ditt eget gruppprojekt om ni vill.

Krav på biblioteket

Abstrakt bas-klass AggregateRoot<TId> med Version, UncommittedEvents, Apply-pattern, LoadFromHistory.
Interface IDomainEvent med EventId och OccurredAt.
Interface IEventStore med LoadAsync och AppendAsync (förväntad version).
Generisk EventSourcedRepository<TAggregate, TId>.
In-memory referensimplementation av IEventStore för testning.
Exception ConcurrencyConflictException.
Sample-projekt ShoppingCart som demonstrerar biblioteket: aggregat med AddItem, RemoveItem, Checkout, minst 3 events.
NuGet-packade .nupkg-filer (lokalt feed räcker, ingen publicering till nuget.org krävs).
Minst 90 % kodtäckning på själva biblioteket (rapport från coverlet).

Leveranser

Git-repo med två projekt: YourName.EventSourcing (bibliotek) och YourName.EventSourcing.Sample.ShoppingCart (exempel).
README med snabbstart (5 rader kod-exempel).
XML-doc-kommentarer på alla publika typer.
Coverlet-rapport (kort textsammanfattning räcker).

Bedömningskriterier

Kriterium	G	VG
API-design	Publika typer enligt krav	+ inga onödiga publika typer, "pit of success" — svårt att använda fel
Aggregat-bas	Apply + version + uncommitted fungerar	+ stöd för `ISnapshotable<T>`-mönster
Tester	≥ 70 % täckning, alla gröna	≥ 90 % täckning + property-based test (FsCheck)
Sample	ShoppingCart fungerar	+ end-to-end-test mot sample med Given-When-Then
Packaging	NuGet-paket byggs	+ SqlStreamStore-port som separat paket `*.SqlStreamStore`
Dokumentation	README + XML-doc	+ migration-guide för befintlig CRUD-kod

Gemensamma betygskriterier

Betyg	Innebörd
IG	Minst ett av kraven på G-nivå saknas eller är felaktigt. Kompletteringstillfälle ges enligt skolans rutiner.
G	Alla G-krav uppfyllda. Koden kompilerar, tester gröna, leveranser kompletta.
VG	Samtliga VG-kriterier uppfyllda i båda uppgifterna. Visar fördjupad förståelse och välmotiverade designval.

Plagiering Kod hämtad från ChatGPT, Copilot eller annat AI-verktyg måste tydligt markeras med kommentar och referens. Stora osynliga blocktransplantationer från GitHub räknas som plagiat. Alla gruppmedlemmar måste kunna förklara varje del av koden vid muntlig redovisning — slumpvis utvald del per medlem.