How iu4015/lostandfound works
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: ReturnRequestService.cs Return Request Service · LostAndFoundDbContext.cs EF Core Context · FoundItem.cs Found Item Rules · FoundItemsController.cs Found Items API
Components 15
HTTP API
- Found Items API
LostAndFound.Api/Controllers/FoundItemsController.cs - Return Requests API
LostAndFound.Api/Controllers/ReturnRequestsController.cs
Application
- Found Item Service
LostAndFound.Application/Services/FoundItemService.cs - Return Request Service
LostAndFound.Application/Services/ReturnRequestService.cs - Found Item Repository Contract
LostAndFound.Application/Repositories/IFoundItemRepository.cs - Request Repository Contract
LostAndFound.Application/Repositories/IReturnRequestRepository.cs - API Data Contracts
LostAndFound.Application/DTOs
Domain Model
- Found Item Rules
LostAndFound.Domain/FoundItem.cs - Return Request Rules
LostAndFound.Domain/ReturnRequest.cs - Domain Rule Exception
LostAndFound.Domain/DomainRuleException.cs
Persistence
- Found Item Repository
LostAndFound.Infrastructure/Repositories/FoundItemRepository.cs - Return Request Repository
LostAndFound.Infrastructure/Repositories/ReturnRequestRepository.cs - EF Core Context
LostAndFound.Infrastructure/LostAndFoundDbContext.cs
Other components
- API User
- Relational Database
Connections 20
- API User → Found Items API: calls API
LostAndFound.Api/Controllers/FoundItemsController.cs - API User → Return Requests API: calls API
LostAndFound.Api/Controllers/ReturnRequestsController.cs - Found Items API → Found Item Service: registers, searches
LostAndFound.Api/Controllers/FoundItemsController.cs - Found Items API → Return Request Service: submits claim
LostAndFound.Api/Controllers/FoundItemsController.cs - Return Requests API → Return Request Service: reviews requests
LostAndFound.Api/Controllers/ReturnRequestsController.cs - Found Item Service → Found Item Repository Contract: queries, saves
LostAndFound.Application/Services/FoundItemService.cs - Return Request Service → Found Item Repository Contract: loads item
LostAndFound.Application/Services/ReturnRequestService.cs - Return Request Service → Request Repository Contract: loads, saves
LostAndFound.Application/Services/ReturnRequestService.cs - Found Item Service → Found Item Rules: creates, maps
LostAndFound.Application/Services/FoundItemService.cs - Return Request Service → Found Item Rules: checks, marks returned
LostAndFound.Application/Services/ReturnRequestService.cs - Return Request Service → Return Request Rules: creates, reviews
LostAndFound.Application/Services/ReturnRequestService.cs - Found Item Rules → Domain Rule Exception: throws rules
LostAndFound.Domain/FoundItem.cs - Return Request Rules → Domain Rule Exception: throws rules
LostAndFound.Domain/ReturnRequest.cs - Found Item Repository Contract → Found Item Repository: implemented by
LostAndFound.Infrastructure/DependencyInjection.cs - Request Repository Contract → Return Request Repository: implemented by
LostAndFound.Infrastructure/DependencyInjection.cs - Found Item Repository → EF Core Context: reads, writes
LostAndFound.Infrastructure/Repositories/FoundItemRepository.cs - Return Request Repository → EF Core Context: reads, writes
LostAndFound.Infrastructure/Repositories/ReturnRequestRepository.cs - EF Core Context → Found Item Rules: maps entity
LostAndFound.Infrastructure/LostAndFoundDbContext.cs - EF Core Context → Return Request Rules: maps entity
LostAndFound.Infrastructure/LostAndFoundDbContext.cs - EF Core Context → Relational Database: persists data