# iu4015/lostandfound architecture

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

- Interactive diagram: https://gitdiagram.com/iu4015/lostandfound
- Repository: https://github.com/iu4015/lostandfound

## Overview

LostAndFound is an ASP.NET API for recording found property and handling claims to return it. The primary workflow registers found items, lets users search or retrieve available items, and accepts return requests; a separate review stage approves or rejects requests and may mark an item returned. The architecture separates HTTP controllers, application services and repository contracts, domain rules, and EF Core persistence. The README is empty, so capabilities and relationships here are based on the source index and sampled files; database-provider details are not shown.

Main entry points: [`LostAndFound.Application/Services/ReturnRequestService.cs`](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Services/ReturnRequestService.cs) (Return Request Service), [`LostAndFound.Infrastructure/LostAndFoundDbContext.cs`](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Infrastructure/LostAndFoundDbContext.cs) (EF Core Context), [`LostAndFound.Domain/FoundItem.cs`](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Domain/FoundItem.cs) (Found Item Rules), [`LostAndFound.Api/Controllers/FoundItemsController.cs`](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Api/Controllers/FoundItemsController.cs) (Found Items API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_found_controller["Found Items API"]
  node_request_controller["Return Requests API"]
end

subgraph group_application["Application"]
  node_found_service["Found Item Service"]
  node_return_service["Return Request Service"]
  node_item_contract["Found Item Repository Contract"]
  node_request_contract["Request Repository Contract"]
  node_dto["API Data Contracts<br/>[DTOs]"]
end

subgraph group_domain["Domain Model"]
  node_found_item["Found Item Rules<br/>[FoundItem.cs]"]
  node_return_request["Return Request Rules<br/>[ReturnRequest.cs]"]
  node_domain_error["Domain Rule Exception"]
end

subgraph group_persistence["Persistence"]
  node_item_repository["Found Item Repository"]
  node_request_repository["Return Request Repository"]
  node_db_context["EF Core Context"]
end

node_user(("API User"))
node_database[("Relational Database")]

node_user -->|"calls API"| node_found_controller
node_user -->|"calls API"| node_request_controller
node_found_controller -->|"registers, searches"| node_found_service
node_found_controller -->|"submits claim"| node_return_service
node_request_controller -->|"reviews requests"| node_return_service
node_found_service -->|"queries, saves"| node_item_contract
node_return_service -->|"loads item"| node_item_contract
node_return_service -->|"loads, saves"| node_request_contract
node_found_service -->|"creates, maps"| node_found_item
node_return_service -->|"checks, marks returned"| node_found_item
node_return_service -->|"creates, reviews"| node_return_request
node_found_item -->|"throws rules"| node_domain_error
node_return_request -->|"throws rules"| node_domain_error
node_item_contract -->|"implemented by"| node_item_repository
node_request_contract -->|"implemented by"| node_request_repository
node_item_repository -->|"reads, writes"| node_db_context
node_request_repository -->|"reads, writes"| node_db_context
node_db_context -->|"maps entity"| node_found_item
node_db_context -->|"maps entity"| node_return_request
node_db_context -.->|"persists data"| node_database

click node_found_controller "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Api/Controllers/FoundItemsController.cs"
click node_request_controller "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Api/Controllers/ReturnRequestsController.cs"
click node_found_service "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Services/FoundItemService.cs"
click node_return_service "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Services/ReturnRequestService.cs"
click node_item_contract "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Repositories/IFoundItemRepository.cs"
click node_request_contract "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Repositories/IReturnRequestRepository.cs"
click node_dto "https://github.com/iu4015/lostandfound/tree/main/LostAndFound.Application/DTOs"
click node_found_item "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Domain/FoundItem.cs"
click node_return_request "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Domain/ReturnRequest.cs"
click node_domain_error "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Domain/DomainRuleException.cs"
click node_item_repository "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Infrastructure/Repositories/FoundItemRepository.cs"
click node_request_repository "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Infrastructure/Repositories/ReturnRequestRepository.cs"
click node_db_context "https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Infrastructure/LostAndFoundDbContext.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_found_controller,node_request_controller,node_user toneBlue
class node_found_service,node_return_service,node_item_contract,node_request_contract,node_dto,node_database toneAmber
class node_found_item,node_return_request,node_domain_error toneMint
class node_item_repository,node_request_repository,node_db_context toneRose
```

## Components

### HTTP API

- [Found Items API](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Api/Controllers/FoundItemsController.cs): `LostAndFound.Api/Controllers/FoundItemsController.cs`
- [Return Requests API](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Api/Controllers/ReturnRequestsController.cs): `LostAndFound.Api/Controllers/ReturnRequestsController.cs`

### Application

- [Found Item Service](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Services/FoundItemService.cs): `LostAndFound.Application/Services/FoundItemService.cs`
- [Return Request Service](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Services/ReturnRequestService.cs): `LostAndFound.Application/Services/ReturnRequestService.cs`
- [Found Item Repository Contract](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Repositories/IFoundItemRepository.cs): `LostAndFound.Application/Repositories/IFoundItemRepository.cs`
- [Request Repository Contract](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Application/Repositories/IReturnRequestRepository.cs): `LostAndFound.Application/Repositories/IReturnRequestRepository.cs`
- [API Data Contracts](https://github.com/iu4015/lostandfound/tree/main/LostAndFound.Application/DTOs): `LostAndFound.Application/DTOs`

### Domain Model

- [Found Item Rules](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Domain/FoundItem.cs): `LostAndFound.Domain/FoundItem.cs`
- [Return Request Rules](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Domain/ReturnRequest.cs): `LostAndFound.Domain/ReturnRequest.cs`
- [Domain Rule Exception](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Domain/DomainRuleException.cs): `LostAndFound.Domain/DomainRuleException.cs`

### Persistence

- [Found Item Repository](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Infrastructure/Repositories/FoundItemRepository.cs): `LostAndFound.Infrastructure/Repositories/FoundItemRepository.cs`
- [Return Request Repository](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Infrastructure/Repositories/ReturnRequestRepository.cs): `LostAndFound.Infrastructure/Repositories/ReturnRequestRepository.cs`
- [EF Core Context](https://github.com/iu4015/lostandfound/blob/main/LostAndFound.Infrastructure/LostAndFoundDbContext.cs): `LostAndFound.Infrastructure/LostAndFoundDbContext.cs`

### Other components

- **API User**
- **Relational Database**

## Connections

- API User → Found Items API: calls API (evidence: `LostAndFound.Api/Controllers/FoundItemsController.cs`)
- API User → Return Requests API: calls API (evidence: `LostAndFound.Api/Controllers/ReturnRequestsController.cs`)
- Found Items API → Found Item Service: registers, searches (evidence: `LostAndFound.Api/Controllers/FoundItemsController.cs`)
- Found Items API → Return Request Service: submits claim (evidence: `LostAndFound.Api/Controllers/FoundItemsController.cs`)
- Return Requests API → Return Request Service: reviews requests (evidence: `LostAndFound.Api/Controllers/ReturnRequestsController.cs`)
- Found Item Service → Found Item Repository Contract: queries, saves (evidence: `LostAndFound.Application/Services/FoundItemService.cs`)
- Return Request Service → Found Item Repository Contract: loads item (evidence: `LostAndFound.Application/Services/ReturnRequestService.cs`)
- Return Request Service → Request Repository Contract: loads, saves (evidence: `LostAndFound.Application/Services/ReturnRequestService.cs`)
- Found Item Service → Found Item Rules: creates, maps (evidence: `LostAndFound.Application/Services/FoundItemService.cs`)
- Return Request Service → Found Item Rules: checks, marks returned (evidence: `LostAndFound.Application/Services/ReturnRequestService.cs`)
- Return Request Service → Return Request Rules: creates, reviews (evidence: `LostAndFound.Application/Services/ReturnRequestService.cs`)
- Found Item Rules → Domain Rule Exception: throws rules (evidence: `LostAndFound.Domain/FoundItem.cs`)
- Return Request Rules → Domain Rule Exception: throws rules (evidence: `LostAndFound.Domain/ReturnRequest.cs`)
- Found Item Repository Contract → Found Item Repository: implemented by (evidence: `LostAndFound.Infrastructure/DependencyInjection.cs`)
- Request Repository Contract → Return Request Repository: implemented by (evidence: `LostAndFound.Infrastructure/DependencyInjection.cs`)
- Found Item Repository → EF Core Context: reads, writes (evidence: `LostAndFound.Infrastructure/Repositories/FoundItemRepository.cs`)
- Return Request Repository → EF Core Context: reads, writes (evidence: `LostAndFound.Infrastructure/Repositories/ReturnRequestRepository.cs`)
- EF Core Context → Found Item Rules: maps entity (evidence: `LostAndFound.Infrastructure/LostAndFoundDbContext.cs`)
- EF Core Context → Return Request Rules: maps entity (evidence: `LostAndFound.Infrastructure/LostAndFoundDbContext.cs`)
- EF Core Context → Relational Database: persists data
