# arthurg-tech/schedulinghouseholdchores architecture

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

- Interactive diagram: https://gitdiagram.com/arthurg-tech/schedulinghouseholdchores
- Repository: https://github.com/arthurg-tech/schedulinghouseholdchores

## Overview

This is a Blazor WebAssembly client and ASP.NET Core API for managing recurring household chores. The main workflow is user registration or login, followed by authenticated task creation and listing scoped to that user; registration also seeds default chores. The API persists users and tasks in SQLite. The README highlights form validation and card-based task browsing. Edges reflect shown calls, API routes, or database configuration; the task-page implementation was not sampled, so its API interaction is documented by the README rather than inferred from its source.

Main entry points: [`SchedulingHouseholdChores/Data/AppDbContext.cs`](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Data/AppDbContext.cs) (EF data context), [`SchedulingHouseholdChores/Services/AuthService.cs`](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Services/AuthService.cs) (Authentication logic), [`SchedulingHouseholdChores.UI/Services/AuthClientService.cs`](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Services/AuthClientService.cs) (Auth client), [`SchedulingHouseholdChores/Controllers/RecurrentTaskController.cs`](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Controllers/RecurrentTaskController.cs) (Task endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Blazor client"]
  node_auth_pages["Login and registration<br/>[Pages]"]
  node_task_page["Task browsing and forms<br/>[Tasks.razor]"]
  node_client_auth["Auth client"]
  node_token_handler["JWT request handler"]
  node_auth_state["Auth state"]
  node_task_dto["Task DTO"]
end

subgraph group_api["API services"]
  node_api_host["API host and configuration<br/>[Program.cs]"]
  node_auth_controller["Authentication endpoints<br/>[AuthController.cs]"]
  node_task_controller["Task endpoints"]
  node_auth_service["Authentication logic<br/>[AuthService.cs]"]
  node_default_tasks["Default task seeding"]
end

subgraph group_domain["Domain and storage"]
  node_users["User records<br/>[User.cs]"]
  node_tasks["Recurring task model<br/>[RecurrentTask.cs]"]
  node_db_context["EF data context<br/>[AppDbContext.cs]"]
  node_sqlite[("SQLite database")]
end

node_person(("Household user"))

node_person -->|"registers or logs in"| node_auth_pages
node_person -->|"manages chores"| node_task_page
node_auth_pages -.->|"submits credentials"| node_client_auth
node_client_auth -->|"POST auth routes"| node_auth_controller
node_auth_controller -->|"delegates auth"| node_auth_service
node_auth_service -->|"reads and writes"| node_db_context
node_auth_service -->|"requests defaults"| node_default_tasks
node_auth_service -->|"creates user"| node_users
node_default_tasks -->|"builds defaults"| node_tasks
node_auth_service -->|"persists defaults"| node_tasks
node_client_auth -->|"provides token"| node_token_handler
node_token_handler -.->|"sends bearer token"| node_task_controller
node_task_page -->|"lists and creates tasks"| node_task_controller
node_task_controller -->|"queries and saves"| node_db_context
node_task_controller -->|"creates task"| node_tasks
node_db_context -->|"maps users"| node_users
node_db_context -->|"maps tasks"| node_tasks
node_api_host -->|"configures SQLite"| node_db_context
node_db_context -->|"persists records"| node_sqlite
node_auth_state -->|"checks authentication"| node_client_auth

click node_auth_pages "https://github.com/arthurg-tech/schedulinghouseholdchores/tree/master/SchedulingHouseholdChores.UI/Pages"
click node_task_page "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Pages/Tasks.razor"
click node_client_auth "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Services/AuthClientService.cs"
click node_token_handler "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Services/AuthHttpMessageHandler.cs"
click node_auth_state "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Components/AuthStateProvider.cs"
click node_task_dto "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Models/RecurrentTaskDto.cs"
click node_api_host "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Program.cs"
click node_auth_controller "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Controllers/AuthController.cs"
click node_task_controller "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Controllers/RecurrentTaskController.cs"
click node_auth_service "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Services/AuthService.cs"
click node_default_tasks "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Services/DefaultTasksService.cs"
click node_users "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Models/User.cs"
click node_tasks "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Models/RecurrentTask.cs"
click node_db_context "https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Data/AppDbContext.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_auth_pages,node_task_page,node_client_auth,node_token_handler,node_auth_state,node_task_dto,node_person toneBlue
class node_api_host,node_auth_controller,node_task_controller,node_auth_service,node_default_tasks toneAmber
class node_users,node_tasks,node_db_context,node_sqlite toneMint
```

## Components

### Blazor client

- [Login and registration](https://github.com/arthurg-tech/schedulinghouseholdchores/tree/master/SchedulingHouseholdChores.UI/Pages): `SchedulingHouseholdChores.UI/Pages`
- [Task browsing and forms](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Pages/Tasks.razor): `SchedulingHouseholdChores.UI/Pages/Tasks.razor`
- [Auth client](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Services/AuthClientService.cs): `SchedulingHouseholdChores.UI/Services/AuthClientService.cs`
- [JWT request handler](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Services/AuthHttpMessageHandler.cs): `SchedulingHouseholdChores.UI/Services/AuthHttpMessageHandler.cs`
- [Auth state](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Components/AuthStateProvider.cs): `SchedulingHouseholdChores.UI/Components/AuthStateProvider.cs`
- [Task DTO](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores.UI/Models/RecurrentTaskDto.cs): `SchedulingHouseholdChores.UI/Models/RecurrentTaskDto.cs`

### API services

- [API host and configuration](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Program.cs): `SchedulingHouseholdChores/Program.cs`
- [Authentication endpoints](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Controllers/AuthController.cs): `SchedulingHouseholdChores/Controllers/AuthController.cs`
- [Task endpoints](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Controllers/RecurrentTaskController.cs): `SchedulingHouseholdChores/Controllers/RecurrentTaskController.cs`
- [Authentication logic](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Services/AuthService.cs): `SchedulingHouseholdChores/Services/AuthService.cs`
- [Default task seeding](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Services/DefaultTasksService.cs): `SchedulingHouseholdChores/Services/DefaultTasksService.cs`

### Domain and storage

- [User records](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Models/User.cs): `SchedulingHouseholdChores/Models/User.cs`
- [Recurring task model](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Models/RecurrentTask.cs): `SchedulingHouseholdChores/Models/RecurrentTask.cs`
- [EF data context](https://github.com/arthurg-tech/schedulinghouseholdchores/blob/master/SchedulingHouseholdChores/Data/AppDbContext.cs): `SchedulingHouseholdChores/Data/AppDbContext.cs`
- **SQLite database**

### Other components

- **Household user**

## Connections

- Household user → Login and registration: registers or logs in (evidence: `README.md`)
- Household user → Task browsing and forms: manages chores (evidence: `README.md`)
- Login and registration → Auth client: submits credentials
- Auth client → Authentication endpoints: POST auth routes (evidence: `SchedulingHouseholdChores.UI/Services/AuthClientService.cs`)
- Authentication endpoints → Authentication logic: delegates auth (evidence: `SchedulingHouseholdChores/Controllers/AuthController.cs`)
- Authentication logic → EF data context: reads and writes (evidence: `SchedulingHouseholdChores/Services/AuthService.cs`)
- Authentication logic → Default task seeding: requests defaults (evidence: `SchedulingHouseholdChores/Services/AuthService.cs`)
- Authentication logic → User records: creates user (evidence: `SchedulingHouseholdChores/Services/AuthService.cs`)
- Default task seeding → Recurring task model: builds defaults (evidence: `SchedulingHouseholdChores/Services/DefaultTasksService.cs`)
- Authentication logic → Recurring task model: persists defaults (evidence: `SchedulingHouseholdChores/Services/AuthService.cs`)
- Auth client → JWT request handler: provides token (evidence: `SchedulingHouseholdChores.UI/Services/AuthHttpMessageHandler.cs`)
- JWT request handler → Task endpoints: sends bearer token
- Task browsing and forms → Task endpoints: lists and creates tasks (evidence: `README.md`)
- Task endpoints → EF data context: queries and saves (evidence: `SchedulingHouseholdChores/Controllers/RecurrentTaskController.cs`)
- Task endpoints → Recurring task model: creates task (evidence: `SchedulingHouseholdChores/Controllers/RecurrentTaskController.cs`)
- EF data context → User records: maps users (evidence: `SchedulingHouseholdChores/Data/AppDbContext.cs`)
- EF data context → Recurring task model: maps tasks (evidence: `SchedulingHouseholdChores/Data/AppDbContext.cs`)
- API host and configuration → EF data context: configures SQLite (evidence: `SchedulingHouseholdChores/Program.cs`)
- EF data context → SQLite database: persists records
- Auth state → Auth client: checks authentication (evidence: `SchedulingHouseholdChores.UI/Components/AuthStateProvider.cs`)
