# jakecleary/pocketmongrels architecture

> Architecture diagram of the GitHub repository jakecleary/pocketmongrels, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jakecleary/pocketmongrels
- Repository: https://github.com/jakecleary/pocketmongrels

## Overview

PocketMongrels is an HTTP-driven Tamagotchi-like game. Clients create and manage users and their animals, then feed or pet an animal; its hunger and happiness are calculated from elapsed time and its type. The API also has a meta endpoint, though its behavior is not described in the available excerpts. The sampled code shows in-memory repositories wired through startup, and action controllers calling services. Resource conversion and some endpoint behavior are visible, but several implementation details were not sampled.

Main entry points: [`src/JakeCleary.PocketMongrels.Api/Startup.cs`](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Startup.cs) (API Startup), [`src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs`](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs) (Users API), [`src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs`](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs) (Actions API), [`src/JakeCleary.PocketMongrels.Services/UserService.cs`](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Services/UserService.cs) (User Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_startup["API Startup<br/>[Startup.cs]"]
  node_users_api["Users API<br/>[UsersController.cs]"]
  node_animals_api["Animals API"]
  node_actions_api["Actions API"]
  node_meta_api["Meta API<br/>[MetaController.cs]"]
  node_validation["Model Validation<br/>[ModelValidator.cs]"]
  node_resources["API Resources"]
end

subgraph group_domain["Game Domain"]
  node_animal["Animal Metrics<br/>[Animal.cs]"]
  node_user["User Model<br/>[User.cs]"]
  node_unique_id["Unique Entity ID"]
end

subgraph group_services["Application Services"]
  node_animal_service["Animal Actions<br/>[AnimalService.cs]"]
  node_user_service["User Operations<br/>[UserService.cs]"]
end

subgraph group_storage["In-Memory Storage"]
  node_animal_contract["Animal Repository Contract"]
  node_user_contract["User Repository Contract<br/>[IUserRepository.cs]"]
  node_animal_store[("Animal Repository")]
  node_user_store[("User Repository<br/>[UserRepository.cs]")]
end

node_client(("HTTP Client"))

node_client -->|"manages users"| node_users_api
node_client -->|"manages animals"| node_animals_api
node_client -->|"requests actions"| node_actions_api
node_startup -->|"registers controllers"| node_users_api
node_startup -->|"registers controllers"| node_actions_api
node_startup -->|"registers service"| node_user_service
node_startup -->|"registers service"| node_animal_service
node_startup -->|"registers repository"| node_user_store
node_startup -->|"registers repository"| node_animal_store
node_users_api -->|"calls"| node_user_service
node_users_api -->|"maps responses"| node_resources
node_users_api -->|"validates input"| node_validation
node_animals_api -->|"looks up user"| node_user_contract
node_animals_api -->|"maps responses"| node_resources
node_actions_api -->|"finds user"| node_user_service
node_actions_api -->|"applies action"| node_animal_service
node_animal_service -->|"updates metrics"| node_animal
node_user_service -->|"uses repository"| node_user_contract
node_user_store -->|"implements"| node_user_contract
node_animal_store -->|"implements"| node_animal_contract
node_user_store -->|"stores users"| node_user
node_animal_store -->|"stores animals"| node_animal
node_user -->|"implements identity"| node_unique_id
node_animal -->|"implements identity"| node_unique_id

click node_startup "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Startup.cs"
click node_users_api "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs"
click node_animals_api "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/AnimalsController.cs"
click node_actions_api "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs"
click node_meta_api "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/MetaController.cs"
click node_validation "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Filter/ModelValidator.cs"
click node_resources "https://github.com/jakecleary/pocketmongrels/tree/master/src/JakeCleary.PocketMongrels.Api.Resources"
click node_animal "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Core/Animal.cs"
click node_user "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Core/User.cs"
click node_unique_id "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Core/IGloballyUniqueEntity.cs"
click node_animal_service "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Services/AnimalService.cs"
click node_user_service "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Services/UserService.cs"
click node_animal_contract "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data/IAnimalRepository.cs"
click node_user_contract "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data/IUserRepository.cs"
click node_animal_store "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data.InMemory/AnimalRepository.cs"
click node_user_store "https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data.InMemory/UserRepository.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_startup,node_users_api,node_animals_api,node_actions_api,node_meta_api,node_validation,node_resources,node_client toneBlue
class node_animal,node_user,node_unique_id toneAmber
class node_animal_service,node_user_service toneMint
class node_animal_contract,node_user_contract,node_animal_store,node_user_store toneRose
```

## Components

### HTTP API

- [API Startup](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Startup.cs): `src/JakeCleary.PocketMongrels.Api/Startup.cs`
- [Users API](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs): `src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs`
- [Animals API](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/AnimalsController.cs): `src/JakeCleary.PocketMongrels.Api/Controller/AnimalsController.cs`
- [Actions API](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs): `src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs`
- [Meta API](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Controller/MetaController.cs): `src/JakeCleary.PocketMongrels.Api/Controller/MetaController.cs`
- [Model Validation](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Api/Filter/ModelValidator.cs): `src/JakeCleary.PocketMongrels.Api/Filter/ModelValidator.cs`
- [API Resources](https://github.com/jakecleary/pocketmongrels/tree/master/src/JakeCleary.PocketMongrels.Api.Resources): `src/JakeCleary.PocketMongrels.Api.Resources`

### Game Domain

- [Animal Metrics](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Core/Animal.cs): `src/JakeCleary.PocketMongrels.Core/Animal.cs`
- [User Model](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Core/User.cs): `src/JakeCleary.PocketMongrels.Core/User.cs`
- [Unique Entity ID](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Core/IGloballyUniqueEntity.cs): `src/JakeCleary.PocketMongrels.Core/IGloballyUniqueEntity.cs`

### Application Services

- [Animal Actions](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Services/AnimalService.cs): `src/JakeCleary.PocketMongrels.Services/AnimalService.cs`
- [User Operations](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Services/UserService.cs): `src/JakeCleary.PocketMongrels.Services/UserService.cs`

### In-Memory Storage

- [Animal Repository Contract](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data/IAnimalRepository.cs): `src/JakeCleary.PocketMongrels.Data/IAnimalRepository.cs`
- [User Repository Contract](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data/IUserRepository.cs): `src/JakeCleary.PocketMongrels.Data/IUserRepository.cs`
- [Animal Repository](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data.InMemory/AnimalRepository.cs): `src/JakeCleary.PocketMongrels.Data.InMemory/AnimalRepository.cs`
- [User Repository](https://github.com/jakecleary/pocketmongrels/blob/master/src/JakeCleary.PocketMongrels.Data.InMemory/UserRepository.cs): `src/JakeCleary.PocketMongrels.Data.InMemory/UserRepository.cs`

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Users API: manages users (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs`)
- HTTP Client → Animals API: manages animals (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/AnimalsController.cs`)
- HTTP Client → Actions API: requests actions (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs`)
- API Startup → Users API: registers controllers (evidence: `src/JakeCleary.PocketMongrels.Api/Startup.cs`)
- API Startup → Actions API: registers controllers (evidence: `src/JakeCleary.PocketMongrels.Api/Startup.cs`)
- API Startup → User Operations: registers service (evidence: `src/JakeCleary.PocketMongrels.Api/Startup.cs`)
- API Startup → Animal Actions: registers service (evidence: `src/JakeCleary.PocketMongrels.Api/Startup.cs`)
- API Startup → User Repository: registers repository (evidence: `src/JakeCleary.PocketMongrels.Api/Startup.cs`)
- API Startup → Animal Repository: registers repository (evidence: `src/JakeCleary.PocketMongrels.Api/Startup.cs`)
- Users API → User Operations: calls (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs`)
- Users API → API Resources: maps responses (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs`)
- Users API → Model Validation: validates input (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/UsersController.cs`)
- Animals API → User Repository Contract: looks up user (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/AnimalsController.cs`)
- Animals API → API Resources: maps responses (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/AnimalsController.cs`)
- Actions API → User Operations: finds user (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs`)
- Actions API → Animal Actions: applies action (evidence: `src/JakeCleary.PocketMongrels.Api/Controller/ActionsController.cs`)
- Animal Actions → Animal Metrics: updates metrics (evidence: `src/JakeCleary.PocketMongrels.Services/AnimalService.cs`)
- User Operations → User Repository Contract: uses repository (evidence: `src/JakeCleary.PocketMongrels.Services/UserService.cs`)
- User Repository → User Repository Contract: implements (evidence: `src/JakeCleary.PocketMongrels.Data.InMemory/UserRepository.cs`)
- Animal Repository → Animal Repository Contract: implements (evidence: `src/JakeCleary.PocketMongrels.Data.InMemory/AnimalRepository.cs`)
- User Repository → User Model: stores users (evidence: `src/JakeCleary.PocketMongrels.Data.InMemory/UserRepository.cs`)
- Animal Repository → Animal Metrics: stores animals (evidence: `src/JakeCleary.PocketMongrels.Data.InMemory/AnimalRepository.cs`)
- User Model → Unique Entity ID: implements identity (evidence: `src/JakeCleary.PocketMongrels.Core/User.cs`)
- Animal Metrics → Unique Entity ID: implements identity (evidence: `src/JakeCleary.PocketMongrels.Core/Animal.cs`)
