How mikhailmasny/qr-animal works
QR Animal is an ASP.NET animal-registration application: users register and confirm accounts, create/manage animal records, and share public animal details through QR codes; it also provides profiles, chat, and administrative maintenance. The web controllers dispatch CQRS requests, application handlers query the persistence abstraction, and infrastructure supplies identity, QR generation, messaging, and storage. The README documents capabilities not fully represented in sampled code; those branches are shown without inferring unobserved call wiring.
Main entry points: AnimalController.cs Animal workflows · GetAnimalQuery.cs Animal queries · ApplicationContext.cs Application database · ClearDatabaseJob.cs Cleanup job
Components 19
Web experience
- Account access
src/Web/Controllers/AccountController.cs - Animal workflows
src/Web/Controllers/AnimalController.cs - Animal profiles
src/Web/Controllers/ProfileController.cs - Animal API
src/Web/Controllers/WebAPI/AnimalsController.cs - Realtime chat
src/Web/Hubs/ChatHub.cs
Application workflows
- Animal commands
src/Application/CQRS/Commands/Create/CreateAnimalCommand.cs - Animal queries
src/Application/CQRS/Queries/GetAnimal/GetAnimalQuery.cs - QR commands
src/Application/CQRS/Commands/Create/CreateQRCodeCommand.cs - QR lookup
src/Application/CQRS/Queries/GetQRCode/GetQRCodeQuery.cs - Application context
src/Application/Interfaces/IApplicationContext.cs
Animal domain
- Animal records
src/Domain/Entities/Animal.cs - QR records
src/Domain/Entities/QRCode.cs
Infrastructure services
- Identity service
src/Infrastructure/Services/IdentityService.cs - Email delivery
src/Infrastructure/Services/EmailSenderService.cs - Application database
src/Infrastructure/Persistence/ApplicationContext.cs - QR generation
src/Infrastructure/Services/QRCodeGeneratorService.cs
Background maintenance
- Cleanup job
src/Worker/Jobs/ClearDatabaseJob.cs
Other components
- User
- Administrator
Connections 26
- User → Account access: registers / signs in
README.md - Account access → Identity service: manages identity
src/Web/Controllers/AccountController.cs - Account access → Email delivery: sends confirmation
src/Web/Controllers/AccountController.cs - User → Animal workflows: manages animals
README.md - Animal workflows → Identity service: resolves user
src/Web/Controllers/AnimalController.cs - Animal workflows → Animal commands: dispatches commands
src/Web/Controllers/AnimalController.cs - Animal workflows → Animal queries: dispatches queries
src/Web/Controllers/AnimalController.cs - Animal workflows → QR commands: creates QR record
src/Web/Controllers/AnimalController.cs - Animal workflows → QR lookup: loads QR record
src/Web/Controllers/AnimalController.cs - Animal workflows → QR generation: renders QR code
src/Web/Controllers/AnimalController.cs - Animal workflows → Animal records: presents details
README.md - User → Animal profiles: views registered animals
README.md - Animal profiles → Animal queries: dispatches user query
src/Web/Controllers/ProfileController.cs - User → Animal API: requests animal data
README.md - Animal API → Animal queries: dispatches query
src/Web/Controllers/WebAPI/AnimalsController.cs - User → Realtime chat: chats
README.md - Animal queries → Application context: reads animal records
src/Application/CQRS/Queries/GetAnimal/GetAnimalQuery.cs - QR lookup → Application context: reads QR records
src/Application/CQRS/Queries/GetQRCode/GetQRCodeQuery.cs - Application context → Application database: implemented by
src/Infrastructure/Persistence/ApplicationContext.cs - Application database → Animal records: persists
src/Infrastructure/Persistence/ApplicationContext.cs - Application database → QR records: persists
src/Infrastructure/Persistence/ApplicationContext.cs - Animal records → QR records: has QR association
src/Domain/Entities/Animal.cs - Cleanup job → Animal queries: finds deleted records
src/Worker/Jobs/ClearDatabaseJob.cs - Cleanup job → QR commands: removes QR records
src/Worker/Jobs/ClearDatabaseJob.cs - Cleanup job → Animal commands: removes animal records
src/Worker/Jobs/ClearDatabaseJob.cs - Administrator → Application database: edits profiles and records
README.md