# mustyx23/kinderconnect architecture

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

- Interactive diagram: https://gitdiagram.com/mustyx23/kinderconnect
- Repository: https://github.com/mustyx23/kinderconnect

## Overview

KinderConnect is an ASP.NET Core kindergarten-management application. Parents and visitors browse classrooms and blog content; parents can enroll and view children, teachers manage attendance, and administrators maintain activities, classrooms, blog content, and teacher assignments. The main application flow runs through MVC controllers to data services and EF Core persistence, with Identity supporting accounts and roles. Source excerpts and the index establish several controller/service and service/database links; README-documented capabilities are retained where implementation files were not sampled.

Main entry points: [`KinderConnect.Web/KinderConnect.Data/KinderConnectDbContext.cs`](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Data/KinderConnectDbContext.cs) (EF Core context), [`KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs`](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs) (Teacher admin), [`KinderConnect.Web/KinderConnect.Web/Controllers/ClassroomController.cs`](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/ClassroomController.cs) (Classroom pages), [`KinderConnect.Web/KinderConnect.Web/Controllers/AttendanceController.cs`](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/AttendanceController.cs) (Attendance pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_classroom_web["Classroom pages"]
  node_attendance_web["Attendance pages"]
  node_child_web["Child pages<br/>[ChildController.cs]"]
  node_activity_admin["Activity admin"]
  node_teacher_admin["Teacher admin"]
  node_classroom_admin["Classroom admin"]
  node_blog_admin["Blog administration<br/>[Controllers]"]
end

subgraph group_services["Domain services"]
  node_classroom_service["Classroom management"]
  node_child_service["Child management<br/>[ChildService.cs]"]
  node_attendance_service["Attendance management"]
  node_teacher_service["Teacher management<br/>[TeacherService.cs]"]
  node_activity_service["Activity management<br/>[ActivityService.cs]"]
  node_blog_service["Blog posts<br/>[BlogPostService.cs]"]
  node_user_service["User management<br/>[UserService.cs]"]
end

subgraph group_domain["Domain and persistence"]
  node_entities["Kindergarten entities"]
  node_database[("EF Core context")]
end

subgraph group_platform["Identity and operations"]
  node_identity["Account identity<br/>[Account]"]
  node_online_users["Online-user tracking"]
  node_app_start["Application startup<br/>[Program.cs]"]
end

node_visitor(("Guest visitor"))
node_parent(("Parent"))
node_teacher(("Teacher"))
node_admin(("Administrator"))

node_visitor -->|"browses"| node_classroom_web
node_visitor -.->|"reads posts"| node_blog_service
node_parent -->|"joins classroom"| node_classroom_web
node_parent -->|"views child"| node_child_web
node_teacher -->|"records attendance"| node_attendance_web
node_admin -->|"manages activities"| node_activity_admin
node_admin -.->|"manages classes"| node_classroom_admin
node_admin -->|"assigns teachers"| node_teacher_admin
node_admin -.->|"manages posts"| node_blog_admin
node_classroom_web -->|"calls"| node_classroom_service
node_classroom_web -->|"calls"| node_child_service
node_attendance_web -->|"calls"| node_attendance_service
node_attendance_web -->|"checks teacher"| node_teacher_service
node_activity_admin -->|"calls"| node_activity_service
node_teacher_admin -->|"calls"| node_teacher_service
node_teacher_admin -->|"upgrades account"| node_user_service
node_teacher_admin -->|"assigns classes"| node_classroom_service
node_classroom_service -->|"queries and saves"| node_database
node_child_service -->|"queries and saves"| node_database
node_attendance_service -.->|"persists records"| node_database
node_teacher_service -.->|"queries and saves"| node_database
node_activity_service -.->|"persists activities"| node_database
node_blog_service -.->|"persists posts"| node_database
node_user_service -.->|"queries users"| node_database
node_database -->|"maps entities"| node_entities
node_identity -.->|"uses identity store"| node_database
node_app_start -->|"configures context"| node_database
node_app_start -.->|"configures middleware"| node_online_users
node_admin -.->|"monitors status"| node_online_users

click node_classroom_web "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/ClassroomController.cs"
click node_attendance_web "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/AttendanceController.cs"
click node_child_web "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/ChildController.cs"
click node_activity_admin "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ActivityController.cs"
click node_teacher_admin "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs"
click node_classroom_admin "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ClassroomController.cs"
click node_blog_admin "https://github.com/mustyx23/kinderconnect/tree/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers"
click node_classroom_service "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/ClassroomService.cs"
click node_child_service "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/ChildService.cs"
click node_attendance_service "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/AttendanceService.cs"
click node_teacher_service "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/TeacherService.cs"
click node_activity_service "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/ActivityService.cs"
click node_blog_service "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/BlogPostService.cs"
click node_user_service "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/UserService.cs"
click node_entities "https://github.com/mustyx23/kinderconnect/tree/main/KinderConnect.Web/KinderConnect.Data.Models"
click node_database "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Data/KinderConnectDbContext.cs"
click node_identity "https://github.com/mustyx23/kinderconnect/tree/main/KinderConnect.Web/KinderConnect.Web/Areas/Identity/Pages/Account"
click node_online_users "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web.Infrastructure/Middlewares/OnlineUsersMiddleware.cs"
click node_app_start "https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Program.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_classroom_web,node_attendance_web,node_child_web,node_activity_admin,node_teacher_admin,node_classroom_admin,node_blog_admin toneBlue
class node_classroom_service,node_child_service,node_attendance_service,node_teacher_service,node_activity_service,node_blog_service,node_user_service toneAmber
class node_entities,node_database toneMint
class node_identity,node_online_users,node_app_start toneRose
class node_visitor,node_parent,node_teacher,node_admin toneIndigo
```

## Components

### Web workflows

- [Classroom pages](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/ClassroomController.cs): `KinderConnect.Web/KinderConnect.Web/Controllers/ClassroomController.cs`
- [Attendance pages](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/AttendanceController.cs): `KinderConnect.Web/KinderConnect.Web/Controllers/AttendanceController.cs`
- [Child pages](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Controllers/ChildController.cs): `KinderConnect.Web/KinderConnect.Web/Controllers/ChildController.cs`
- [Activity admin](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ActivityController.cs): `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ActivityController.cs`
- [Teacher admin](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs): `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs`
- [Classroom admin](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ClassroomController.cs): `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ClassroomController.cs`
- [Blog administration](https://github.com/mustyx23/kinderconnect/tree/main/KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers): `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers`

### Domain services

- [Classroom management](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/ClassroomService.cs): `KinderConnect.Web/KinderConnect.Services.Data/ClassroomService.cs`
- [Child management](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/ChildService.cs): `KinderConnect.Web/KinderConnect.Services.Data/ChildService.cs`
- [Attendance management](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/AttendanceService.cs): `KinderConnect.Web/KinderConnect.Services.Data/AttendanceService.cs`
- [Teacher management](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/TeacherService.cs): `KinderConnect.Web/KinderConnect.Services.Data/TeacherService.cs`
- [Activity management](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/ActivityService.cs): `KinderConnect.Web/KinderConnect.Services.Data/ActivityService.cs`
- [Blog posts](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/BlogPostService.cs): `KinderConnect.Web/KinderConnect.Services.Data/BlogPostService.cs`
- [User management](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Services.Data/UserService.cs): `KinderConnect.Web/KinderConnect.Services.Data/UserService.cs`

### Domain and persistence

- [Kindergarten entities](https://github.com/mustyx23/kinderconnect/tree/main/KinderConnect.Web/KinderConnect.Data.Models): `KinderConnect.Web/KinderConnect.Data.Models`
- [EF Core context](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Data/KinderConnectDbContext.cs): `KinderConnect.Web/KinderConnect.Data/KinderConnectDbContext.cs`

### Identity and operations

- [Account identity](https://github.com/mustyx23/kinderconnect/tree/main/KinderConnect.Web/KinderConnect.Web/Areas/Identity/Pages/Account): `KinderConnect.Web/KinderConnect.Web/Areas/Identity/Pages/Account`
- [Online-user tracking](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web.Infrastructure/Middlewares/OnlineUsersMiddleware.cs): `KinderConnect.Web/KinderConnect.Web.Infrastructure/Middlewares/OnlineUsersMiddleware.cs`
- [Application startup](https://github.com/mustyx23/kinderconnect/blob/main/KinderConnect.Web/KinderConnect.Web/Program.cs): `KinderConnect.Web/KinderConnect.Web/Program.cs`

### Other components

- **Guest visitor**
- **Parent**
- **Teacher**
- **Administrator**

## Connections

- Guest visitor → Classroom pages: browses
- Guest visitor → Blog posts: reads posts
- Parent → Classroom pages: joins classroom
- Parent → Child pages: views child
- Teacher → Attendance pages: records attendance
- Administrator → Activity admin: manages activities (evidence: `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ActivityController.cs`)
- Administrator → Classroom admin: manages classes
- Administrator → Teacher admin: assigns teachers (evidence: `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs`)
- Administrator → Blog administration: manages posts
- Classroom pages → Classroom management: calls (evidence: `KinderConnect.Web/KinderConnect.Web/Controllers/ClassroomController.cs`)
- Classroom pages → Child management: calls (evidence: `KinderConnect.Web/KinderConnect.Web/Controllers/ClassroomController.cs`)
- Attendance pages → Attendance management: calls (evidence: `KinderConnect.Web/KinderConnect.Web/Controllers/AttendanceController.cs`)
- Attendance pages → Teacher management: checks teacher (evidence: `KinderConnect.Web/KinderConnect.Web/Controllers/AttendanceController.cs`)
- Activity admin → Activity management: calls (evidence: `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/ActivityController.cs`)
- Teacher admin → Teacher management: calls (evidence: `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs`)
- Teacher admin → User management: upgrades account (evidence: `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs`)
- Teacher admin → Classroom management: assigns classes (evidence: `KinderConnect.Web/KinderConnect.Web/Areas/Admin/Controllers/TeacherController.cs`)
- Classroom management → EF Core context: queries and saves (evidence: `KinderConnect.Web/KinderConnect.Services.Data/ClassroomService.cs`)
- Child management → EF Core context: queries and saves (evidence: `KinderConnect.Web/KinderConnect.Services.Data/ChildService.cs`)
- Attendance management → EF Core context: persists records (evidence: `KinderConnect.Web/KinderConnect.Services.Data/AttendanceService.cs`)
- Teacher management → EF Core context: queries and saves (evidence: `KinderConnect.Web/KinderConnect.Services.Data/TeacherService.cs`)
- Activity management → EF Core context: persists activities
- Blog posts → EF Core context: persists posts
- User management → EF Core context: queries users
- EF Core context → Kindergarten entities: maps entities (evidence: `KinderConnect.Web/KinderConnect.Data/KinderConnectDbContext.cs`)
- Account identity → EF Core context: uses identity store
- Application startup → EF Core context: configures context (evidence: `KinderConnect.Web/KinderConnect.Web/Program.cs`)
- Application startup → Online-user tracking: configures middleware
- Administrator → Online-user tracking: monitors status
