# mizuto26/webapp_exercise architecture

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

- Interactive diagram: https://gitdiagram.com/mizuto26/webapp_exercise
- Repository: https://github.com/mizuto26/webapp_exercise

## Overview

1. This is an ASP.NET Core MVC application organized as a teaching/exercise repo. It combines several small sample controllers/views with one more fully layered feature around item registration.

2. The repository is split into three main architectural areas:
   - `Applications`: domain models, service abstractions, and application services
   - `Infrastructures`: persistence models, EF Core context, repository implementations, and entity adapters
   - `Presentations`: MVC-facing controllers, view models, and DI wiring for the item-registration flow

3. The core business domain lives in `Applications/Domains` with `Item`, `ItemCategory`, and `ItemStock`. These are the business objects the application tries to protect from persistence and UI details.

4. The application boundary is defined by interfaces in `Applications/Adapters`, `Applications/Repositories`, and `Applications/Services`. `IItemRegisterService` is the main use-case entry point, while `IConverter`/`IRestorer` and repository interfaces abstract data transformation and persistence access.

5. `Applications/Services/Impls/ItemRegisterService.cs` appears to coordinate the item-registration use case. It likely orchestrates validation, repository calls, and domain object creation, while remaining independent of EF Core and MVC concerns.

6. The persistence layer is in `Infrastructures`. `AppDbContext` is the EF Core database context, and `Infrastructures/Entities` contains database-shaped entities such as `ItemEntity`, `ItemStockEntity`, and `ItemCatgoryEntity` (note the spelling). This layer is where the domain model is flattened into storage-friendly records.

7. The `Infrastructures/Adapters` classes bridge the domain and persistence models. `ItemEntityAdapter`, `ItemStockEntityAdapter`, and `ItemCategoryEntityAdapter` convert between entities and domain objects, which keeps the domain model isolated from database schema details.

8. Repository implementations live in `Infrastructures/Repositories`, backed by `AppDbContext`. This is the concrete data-access boundary used by the application service layer. The file tree suggests separate repositories for items and item categories, with the item repository interface duplicated across layers to keep contracts available where needed.

9. The presentation boundary for the item-registration feature is in `Presentations`. `ItemRegisterController` is the MVC controller for that workflow, `ItemRegisterViewModel` shapes data for the views, and `ItemRegisterViewModelAdapter` maps between view state and application/domain state. `TempDataStore` suggests multi-step form handling across redirects.

10. `Presentations/Extensions/DependencyExtension.cs` is the composition root for this feature set. It likely registers repositories, adapters, services, and other app-specific dependencies into the ASP.NET Core DI container.

11. The UI is mostly Razor views under `Views`, with a dedicated `Views/ItemRegister` folder for the registration flow and additional exercise/sample views like `Ex09`, `Op04`, `TagHelperForm`, and `RazorSyntaxSample`. `Views/Shared/_Layout.cshtml` provides the common site shell.

12. There is also a set of root-level controllers in `Controllers`, such as `HomeController`, `Ex03Controller`, `Op01Controller`, and `TagHelperFormController`. These appear to support discrete exercises and MVC feature demos rather than core business functionality.

13. `wwwroot` contains static assets and client-side libraries, including Bootstrap, jQuery, and validation scripts. This supports standard Razor MVC rendering and unobtrusive form validation, especially for the sample form-based exercises.

14. Custom exceptions in `Exceptions` define the app’s error semantics: `DomainException`, `ExistsException`, `NotFoundException`, and `InternalException`. These provide a clear boundary for business-rule failures versus infrastructure or unexpected failures.

15. The overall runtime flow for the item-registration feature is: browser request -> MVC controller -> view model mapping -> application service -> repository/adapters -> EF Core context/database -> reverse mapping back to domain/view model -> Razor view response. The exercise controllers mostly bypass this deeper layering and serve as lightweight request/view demonstrations.

Main entry points: [`Applications/Services/Impls/ItemRegisterService.cs`](https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Services/Impls/ItemRegisterService.cs) (Register service), [`Presentations/Controllers/ItemRegisterController.cs`](https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Controllers/ItemRegisterController.cs) (Register controller), [`Presentations/Extensions/DependencyExtension.cs`](https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Extensions/DependencyExtension.cs) (DI wiring), [`Applications/Adapters`](https://github.com/mizuto26/webapp_exercise/tree/main/Applications/Adapters) (Core adapters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_applications["Applications"]
  node_dom_item["Item<br/>domain model<br/>[Item.cs]"]
  node_dom_category["Category<br/>domain model<br/>[ItemCategory.cs]"]
  node_dom_stock["Stock<br/>domain model<br/>[ItemStock.cs]"]
  node_app_adapters["Core adapters<br/>interfaces"]
  node_app_repos["Repo contracts<br/>interfaces"]
  node_app_usecase["Register service<br/>use-case"]
end

subgraph group_infrastructures["Infrastructures"]
  node_infra_ctx[("Db context<br/>ef core<br/>[AppDbContext.cs]")]
  node_infra_entities["Entities<br/>persistence model"]
  node_infra_adapters["Entity adapters<br/>mapping"]
  node_infra_repos["Repos<br/>data access"]
end

subgraph group_presentations["Presentations"]
  node_pres_controller["Register controller<br/>mvc controller"]
  node_pres_vm["Register VM<br/>view model"]
  node_pres_vm_adapter["VM adapter<br/>mapping"]
  node_pres_tempdata["Temp store<br/>mvc support<br/>[TempDataStore.cs]"]
  node_pres_di["DI wiring<br/>composition root"]
end

subgraph group_samples["Samples"]
  node_sample_ctrls["Exercise controllers<br/>mvc demos"]
  node_sample_forms["Form models<br/>sample models"]
  node_sample_views["Razor views<br/>ui views"]
  node_static_assets["Static assets<br/>web assets"]
end

node_errors{{"Exceptions<br/>error model"}}

node_app_usecase -->|"creates"| node_dom_item
node_app_usecase -->|"uses"| node_app_repos
node_app_usecase -->|"depends on"| node_app_adapters
node_app_usecase -->|"throws"| node_errors
node_app_adapters -->|"maps"| node_dom_item
node_app_adapters -->|"maps"| node_dom_category
node_app_adapters -->|"maps"| node_dom_stock
node_infra_adapters -->|"maps"| node_dom_item
node_infra_adapters -->|"maps"| node_dom_category
node_infra_adapters -->|"maps"| node_dom_stock
node_infra_entities -->|"persisted by"| node_infra_ctx
node_infra_repos -->|"queries"| node_infra_ctx
node_infra_repos -->|"stores"| node_infra_entities
node_infra_repos -->|"implements"| node_app_repos
node_pres_controller -->|"binds"| node_pres_vm
node_pres_controller -->|"maps"| node_pres_vm_adapter
node_pres_controller -->|"invokes"| node_app_usecase
node_pres_controller -->|"stores state"| node_pres_tempdata
node_pres_vm_adapter -->|"maps"| node_dom_item
node_pres_vm_adapter -->|"maps"| node_pres_vm
node_pres_di -->|"registers"| node_pres_controller
node_pres_di -->|"registers"| node_app_usecase
node_pres_di -->|"registers"| node_infra_repos
node_pres_di -->|"registers"| node_infra_adapters
node_sample_ctrls -->|"renders"| node_sample_views
node_sample_ctrls -->|"binds"| node_sample_forms
node_sample_views -->|"uses"| node_static_assets
node_sample_views -->|"shows"| node_errors

click node_dom_item "https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Domains/Item.cs"
click node_dom_category "https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Domains/ItemCategory.cs"
click node_dom_stock "https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Domains/ItemStock.cs"
click node_app_adapters "https://github.com/mizuto26/webapp_exercise/tree/main/Applications/Adapters"
click node_app_repos "https://github.com/mizuto26/webapp_exercise/tree/main/Applications/Repositories"
click node_app_usecase "https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Services/Impls/ItemRegisterService.cs"
click node_infra_ctx "https://github.com/mizuto26/webapp_exercise/blob/main/Infrastructures/Context/AppDbContext.cs"
click node_infra_entities "https://github.com/mizuto26/webapp_exercise/tree/main/Infrastructures/Entities"
click node_infra_adapters "https://github.com/mizuto26/webapp_exercise/tree/main/Infrastructures/Adapters"
click node_infra_repos "https://github.com/mizuto26/webapp_exercise/tree/main/Infrastructures/Repositories"
click node_pres_controller "https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Controllers/ItemRegisterController.cs"
click node_pres_vm "https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/ViewModels/ItemRegisterViewModel.cs"
click node_pres_vm_adapter "https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/ViewModels/ItemRegisterViewModelAdapter.cs"
click node_pres_tempdata "https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Controllers/TempDataStore.cs"
click node_pres_di "https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Extensions/DependencyExtension.cs"
click node_sample_ctrls "https://github.com/mizuto26/webapp_exercise/tree/main/Controllers"
click node_sample_forms "https://github.com/mizuto26/webapp_exercise/tree/main/Models"
click node_sample_views "https://github.com/mizuto26/webapp_exercise/tree/main/Views"
click node_static_assets "https://github.com/mizuto26/webapp_exercise/tree/main/wwwroot"
click node_errors "https://github.com/mizuto26/webapp_exercise/tree/main/Exceptions"

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_dom_item,node_dom_category,node_dom_stock,node_app_adapters,node_app_repos,node_app_usecase toneBlue
class node_infra_ctx,node_infra_entities,node_infra_adapters,node_infra_repos toneAmber
class node_pres_controller,node_pres_vm,node_pres_vm_adapter,node_pres_tempdata,node_pres_di toneMint
class node_sample_ctrls,node_sample_forms,node_sample_views,node_static_assets toneRose
class node_errors toneNeutral
```

## Components

### Applications

Domain, contracts, and use-case orchestration

- [Item](https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Domains/Item.cs): domain model · Core business item entity · `Applications/Domains/Item.cs`
- [Category](https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Domains/ItemCategory.cs): domain model · Business item category · `Applications/Domains/ItemCategory.cs`
- [Stock](https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Domains/ItemStock.cs): domain model · Business item stock · `Applications/Domains/ItemStock.cs`
- [Core adapters](https://github.com/mizuto26/webapp_exercise/tree/main/Applications/Adapters): interfaces · Conversion and restoration contracts · `Applications/Adapters`
- [Repo contracts](https://github.com/mizuto26/webapp_exercise/tree/main/Applications/Repositories): interfaces · Persistence abstractions for application layer · `Applications/Repositories`
- [Register service](https://github.com/mizuto26/webapp_exercise/blob/main/Applications/Services/Impls/ItemRegisterService.cs): use-case · Item registration orchestration · `Applications/Services/Impls/ItemRegisterService.cs`

### Infrastructures

EF Core persistence and model adapters

- [Db context](https://github.com/mizuto26/webapp_exercise/blob/main/Infrastructures/Context/AppDbContext.cs): ef core · Database access boundary · `Infrastructures/Context/AppDbContext.cs`
- [Entities](https://github.com/mizuto26/webapp_exercise/tree/main/Infrastructures/Entities): persistence model · Storage-shaped records · `Infrastructures/Entities`
- [Entity adapters](https://github.com/mizuto26/webapp_exercise/tree/main/Infrastructures/Adapters): mapping · Domain-to-entity translators · `Infrastructures/Adapters`
- [Repos](https://github.com/mizuto26/webapp_exercise/tree/main/Infrastructures/Repositories): data access · Concrete repository implementations · `Infrastructures/Repositories`

### Presentations

MVC flow for item registration

- [Register controller](https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Controllers/ItemRegisterController.cs): mvc controller · Item registration request handler · `Presentations/Controllers/ItemRegisterController.cs`
- [Register VM](https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/ViewModels/ItemRegisterViewModel.cs): view model · Form state for item registration · `Presentations/ViewModels/ItemRegisterViewModel.cs`
- [VM adapter](https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/ViewModels/ItemRegisterViewModelAdapter.cs): mapping · Maps view state to app/domain state · `Presentations/ViewModels/ItemRegisterViewModelAdapter.cs`
- [Temp store](https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Controllers/TempDataStore.cs): mvc support · Cross-request state for the flow · `Presentations/Controllers/TempDataStore.cs`
- [DI wiring](https://github.com/mizuto26/webapp_exercise/blob/main/Presentations/Extensions/DependencyExtension.cs): composition root · Registers feature dependencies · `Presentations/Extensions/DependencyExtension.cs`

### Samples

Exercise controllers, views, and form models

- [Exercise controllers](https://github.com/mizuto26/webapp_exercise/tree/main/Controllers): mvc demos · Home and lesson controllers · `Controllers`
- [Form models](https://github.com/mizuto26/webapp_exercise/tree/main/Models): sample models · Simple request models for exercises · `Models`
- [Razor views](https://github.com/mizuto26/webapp_exercise/tree/main/Views): ui views · Exercise pages and shared layout · `Views`
- [Static assets](https://github.com/mizuto26/webapp_exercise/tree/main/wwwroot): web assets · CSS, JS, HTML, and libraries · `wwwroot`

### Other components

- [Exceptions](https://github.com/mizuto26/webapp_exercise/tree/main/Exceptions): error model · Domain and application error semantics · `Exceptions`

## Connections

- Register service → Item: creates · Builds business item objects
- Register service → Repo contracts: uses · Loads and saves through repository contracts
- Register service → Core adapters: depends on · Uses conversion/restoration abstractions
- Register service → Exceptions: throws · Signals business and lookup failures
- Core adapters → Item: maps · Converts domain objects
- Core adapters → Category: maps · Converts category objects
- Core adapters → Stock: maps · Converts stock objects
- Entity adapters → Item: maps · Bridges storage and domain item models
- Entity adapters → Category: maps · Bridges storage and domain category models
- Entity adapters → Stock: maps · Bridges storage and domain stock models
- Entities → Db context: persisted by · EF Core tracks entity records
- Repos → Db context: queries · Uses DbContext for persistence
- Repos → Entities: stores · Works with entity shapes
- Repos → Repo contracts: implements · Concrete repository boundary
- Register controller → Register VM: binds · Receives and returns registration form data
- Register controller → VM adapter: maps · Converts between controller and app forms
- Register controller → Register service: invokes · Triggers registration use case
- Register controller → Temp store: stores state · Carries data across redirects
- VM adapter → Item: maps · Transforms view data into domain input
- VM adapter → Register VM: maps · Transforms between view model shapes
- DI wiring → Register controller: registers · Wires MVC feature dependencies
- DI wiring → Register service: registers · Adds application service to DI
- DI wiring → Repos: registers · Adds persistence implementations to DI
- DI wiring → Entity adapters: registers · Adds mapping components to DI
- Exercise controllers → Razor views: renders · Exercise controllers return Razor pages
- Exercise controllers → Form models: binds · Simple form handling for lessons
- Razor views → Static assets: uses · Shared CSS/JS and validation assets
- Razor views → Exceptions: shows · Error page reflects application failures
