# masuatony/kurasa-phonebook-app architecture

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

- Interactive diagram: https://gitdiagram.com/masuatony/kurasa-phonebook-app
- Repository: https://github.com/masuatony/kurasa-phonebook-app

## Overview

KurasaPhonebook is an Angular contact-management app. Users enter through the dashboard or contacts view; the contacts screen displays sample contacts and supports search, status filtering, viewing details, and creating, editing, or deleting contacts. Its visible contact list is maintained locally in the page, while NgRx provides application state for contact selection, language, sidebar, and routing concerns. The app also starts a Mirage mock server. Several store effects, charts, and dashboard details are listed in the tree but were not sampled, so their behavior and wiring are not asserted here.

Main entry points: [`src/app/features/pages/home/home.component.ts`](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/home/home.component.ts) (Contact list), [`src/app/layout/main-layout/main-layout.component.ts`](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/layout/main-layout/main-layout.component.ts) (Main layout), [`src/app/app.routes.ts`](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/app.routes.ts) (App routes), [`src/main.ts`](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/main.ts) (App bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App and navigation"]
  node_bootstrap["App bootstrap<br/>[main.ts]"]
  node_routes["App routes<br/>[app.routes.ts]"]
  node_layout["Main layout"]
  node_sidebar["Sidebar UI"]
  node_language["Language selector"]
  node_flags["Language flags"]
end

subgraph group_contacts["Contact management"]
  node_dashboard["Dashboard"]
  node_contacts_page["Contact list<br/>[home.component.ts]"]
  node_contact_data["Contact model and data<br/>[contact.ts]"]
  node_create_contact["Contact form"]
  node_details["Contact details"]
  node_contact_card["Contact card"]
  node_delete_modal["Delete dialog"]
  node_contact_service["Contacts service<br/>[contact-service.ts]"]
end

subgraph group_state["Application state"]
  node_contact_actions["Contact actions<br/>[contact.actions.ts]"]
  node_contact_reducer["Contact reducer<br/>[contact.reducer.ts]"]
  node_contact_effect["Contact effects<br/>[contact.effect.ts]"]
  node_language_state["Language state"]
  node_sidebar_state["Sidebar state"]
  node_persistence["State persistence<br/>[persistance.ts]"]
  node_router_effects["Router effects<br/>[router.effects.ts]"]
end

subgraph group_shared["Shared UI"]
  node_mock_server["Mock API<br/>[mock-server.ts]"]
  node_stats["Dashboard stat cards"]
  node_charts["Dashboard charts"]
end

node_user(("User"))

node_user -->|"opens app"| node_bootstrap
node_bootstrap -->|"starts mock server"| node_mock_server
node_bootstrap -->|"configures routes"| node_routes
node_routes -->|"routes through"| node_layout
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_contacts_page
node_layout -->|"renders"| node_sidebar
node_layout -->|"renders"| node_language
node_layout -->|"uses flags"| node_flags
node_contacts_page -->|"reads sample data"| node_contact_data
node_contacts_page -->|"opens form"| node_create_contact
node_contacts_page -->|"opens dialog"| node_delete_modal
node_contacts_page -->|"renders details"| node_details
node_contacts_page -->|"renders cards"| node_contact_card
node_create_contact -->|"uses service"| node_contact_service
node_create_contact -->|"uses model"| node_contact_data
node_details -->|"uses model"| node_contact_data
node_contacts_page -->|"dispatches selection"| node_contact_actions
node_contact_reducer -->|"handles actions"| node_contact_actions
node_language -->|"selects and dispatches"| node_language_state
node_sidebar -->|"dispatches toggle"| node_sidebar_state
node_layout -->|"selects visibility"| node_sidebar_state
node_persistence -->|"persists state"| node_sidebar_state
node_persistence -->|"persists state"| node_language_state
node_router_effects -->|"navigates"| node_routes
node_dashboard -->|"renders cards"| node_stats

click node_bootstrap "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/main.ts"
click node_routes "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/app.routes.ts"
click node_layout "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/layout/main-layout/main-layout.component.ts"
click node_sidebar "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/layout/common/sidebar/sidebar.component.ts"
click node_language "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/layout/common/language-selector/language-selector.component.ts"
click node_flags "https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/layout/common/flags"
click node_dashboard "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/dashboard/dashboard.component.ts"
click node_contacts_page "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/home/home.component.ts"
click node_contact_data "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/contact.ts"
click node_create_contact "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/create-contact/create-contact.component.ts"
click node_details "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/contact-details/contact-details.component.ts"
click node_contact_card "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/contact-card/contact-card.component.ts"
click node_delete_modal "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/shared/components/delete-modal/delete-modal.component.ts"
click node_contact_service "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/service/contact-service.ts"
click node_contact_actions "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/contacts/contact.actions.ts"
click node_contact_reducer "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/contacts/contact.reducer.ts"
click node_contact_effect "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/contacts/contact.effect.ts"
click node_language_state "https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/store/language"
click node_sidebar_state "https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/store/sidebar"
click node_persistence "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/persistance.ts"
click node_router_effects "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/router/router.effects.ts"
click node_mock_server "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/mock-server.ts"
click node_stats "https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/shared/components/stat-card/stat-card.component.ts"
click node_charts "https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/shared/components/charts"

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_bootstrap,node_routes,node_layout,node_sidebar,node_language,node_flags,node_user toneBlue
class node_dashboard,node_contacts_page,node_contact_data,node_create_contact,node_details,node_contact_card,node_delete_modal,node_contact_service toneAmber
class node_contact_actions,node_contact_reducer,node_contact_effect,node_language_state,node_sidebar_state,node_persistence,node_router_effects toneMint
class node_mock_server,node_stats,node_charts toneRose
```

## Components

### App and navigation

- [App bootstrap](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/main.ts): `src/main.ts`
- [App routes](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/app.routes.ts): `src/app/app.routes.ts`
- [Main layout](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/layout/main-layout/main-layout.component.ts): `src/app/layout/main-layout/main-layout.component.ts`
- [Sidebar UI](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/layout/common/sidebar/sidebar.component.ts): `src/app/layout/common/sidebar/sidebar.component.ts`
- [Language selector](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/layout/common/language-selector/language-selector.component.ts): `src/app/layout/common/language-selector/language-selector.component.ts`
- [Language flags](https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/layout/common/flags): `src/app/layout/common/flags`

### Contact management

- [Dashboard](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/dashboard/dashboard.component.ts): `src/app/features/pages/dashboard/dashboard.component.ts`
- [Contact list](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/home/home.component.ts): `src/app/features/pages/home/home.component.ts`
- [Contact model and data](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/contact.ts): `src/app/features/pages/contact.ts`
- [Contact form](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/create-contact/create-contact.component.ts): `src/app/features/pages/create-contact/create-contact.component.ts`
- [Contact details](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/contact-details/contact-details.component.ts): `src/app/features/pages/contact-details/contact-details.component.ts`
- [Contact card](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/pages/contact-card/contact-card.component.ts): `src/app/features/pages/contact-card/contact-card.component.ts`
- [Delete dialog](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/shared/components/delete-modal/delete-modal.component.ts): `src/app/shared/components/delete-modal/delete-modal.component.ts`
- [Contacts service](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/features/service/contact-service.ts): `src/app/features/service/contact-service.ts`

### Application state

- [Contact actions](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/contacts/contact.actions.ts): `src/app/store/contacts/contact.actions.ts`
- [Contact reducer](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/contacts/contact.reducer.ts): `src/app/store/contacts/contact.reducer.ts`
- [Contact effects](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/contacts/contact.effect.ts): `src/app/store/contacts/contact.effect.ts`
- [Language state](https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/store/language): `src/app/store/language`
- [Sidebar state](https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/store/sidebar): `src/app/store/sidebar`
- [State persistence](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/persistance.ts): `src/app/store/persistance.ts`
- [Router effects](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/store/router/router.effects.ts): `src/app/store/router/router.effects.ts`

### Shared UI

- [Mock API](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/mock-server.ts): `src/mock-server.ts`
- [Dashboard stat cards](https://github.com/masuatony/kurasa-phonebook-app/blob/main/src/app/shared/components/stat-card/stat-card.component.ts): `src/app/shared/components/stat-card/stat-card.component.ts`
- [Dashboard charts](https://github.com/masuatony/kurasa-phonebook-app/tree/main/src/app/shared/components/charts): `src/app/shared/components/charts`

### Other components

- **User**

## Connections

- User → App bootstrap: opens app (evidence: `src/main.ts`)
- App bootstrap → Mock API: starts mock server (evidence: `src/main.ts`)
- App bootstrap → App routes: configures routes
- App routes → Main layout: routes through (evidence: `src/app/app.routes.ts`)
- App routes → Dashboard: routes to (evidence: `src/app/app.routes.ts`)
- App routes → Contact list: routes to (evidence: `src/app/app.routes.ts`)
- Main layout → Sidebar UI: renders (evidence: `src/app/layout/main-layout/main-layout.component.ts`)
- Main layout → Language selector: renders (evidence: `src/app/layout/main-layout/main-layout.component.ts`)
- Main layout → Language flags: uses flags (evidence: `src/app/layout/main-layout/main-layout.component.ts`)
- Contact list → Contact model and data: reads sample data (evidence: `src/app/features/pages/home/home.component.ts`)
- Contact list → Contact form: opens form (evidence: `src/app/features/pages/home/home.component.ts`)
- Contact list → Delete dialog: opens dialog (evidence: `src/app/features/pages/home/home.component.ts`)
- Contact list → Contact details: renders details (evidence: `src/app/features/pages/home/home.component.ts`)
- Contact list → Contact card: renders cards (evidence: `src/app/features/pages/home/home.component.ts`)
- Contact form → Contacts service: uses service (evidence: `src/app/features/pages/create-contact/create-contact.component.ts`)
- Contact form → Contact model and data: uses model (evidence: `src/app/features/pages/create-contact/create-contact.component.ts`)
- Contact details → Contact model and data: uses model (evidence: `src/app/features/pages/contact-details/contact-details.component.ts`)
- Contact list → Contact actions: dispatches selection (evidence: `src/app/features/pages/home/home.component.ts`)
- Contact reducer → Contact actions: handles actions (evidence: `src/app/store/contacts/contact.reducer.ts`)
- Language selector → Language state: selects and dispatches (evidence: `src/app/layout/common/language-selector/language-selector.component.ts`)
- Sidebar UI → Sidebar state: dispatches toggle (evidence: `src/app/layout/common/sidebar/sidebar.component.ts`)
- Main layout → Sidebar state: selects visibility (evidence: `src/app/layout/main-layout/main-layout.component.ts`)
- State persistence → Sidebar state: persists state (evidence: `src/app/store/persistance.ts`)
- State persistence → Language state: persists state (evidence: `src/app/store/persistance.ts`)
- Router effects → App routes: navigates (evidence: `src/app/store/router/router.effects.ts`)
- Dashboard → Dashboard stat cards: renders cards (evidence: `src/app/features/pages/dashboard/dashboard.component.ts`)
