# hisui2121/church-management-system architecture

> Architecture diagram of the GitHub repository hisui2121/church-management-system, 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/hisui2121/church-management-system
- Repository: https://github.com/hisui2121/church-management-system

## Overview

This is a Laravel church-management application. Members and guests register through staged account, personal, church-details, and review forms; the registration controller persists the account. Authenticated users use the member-facing dashboard to browse church information and check in to an active service. Administrators manage attendance and reporting, members, ministries, users, and other church content. The graph preserves documented application areas, but several controller implementations were not sampled, so their internal behavior is not inferred.

Main entry points: [`routes/web.php`](https://github.com/hisui2121/church-management-system/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/DashboardController.php`](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/DashboardController.php) (Member dashboard), [`app/Models/User.php`](https://github.com/hisui2121/church-management-system/blob/main/app/Models/User.php) (User accounts and roles), [`app/Models/Member.php`](https://github.com/hisui2121/church-management-system/blob/main/app/Models/Member.php) (Member records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_dashboard["Member dashboard"]
end

subgraph group_people["People and access"]
  node_registration["Registration steps"]
  node_login["Login"]
  node_member_portal["Member portal"]
  node_member_admin["Member administration"]
  node_users_admin["User administration"]
  node_user_model["User accounts and roles<br/>[User.php]"]
  node_member_model["Member records<br/>[Member.php]"]
  node_status_model["Member statuses<br/>[MemberStatus.php]"]
  node_ministry_model["Ministries<br/>[Ministry.php]"]
end

subgraph group_services["Services and attendance"]
  node_attendance_admin["Attendance management"]
  node_attendance_reports["Attendance reports"]
  node_attendance_model["Attendance records<br/>[Attendance.php]"]
  node_sessions_admin["Service sessions"]
  node_session_model["Service session data<br/>[ServiceSession.php]"]
  node_service_model["Events and services<br/>[Service.php]"]
  node_attendance_export["Attendance export"]
end

subgraph group_content["Church content"]
  node_announcements["Announcements"]
  node_announcement_model["Announcement data<br/>[Announcement.php]"]
  node_events_admin["Event administration"]
  node_banners_admin["Banner administration"]
  node_messages_admin["Messages"]
end

subgraph group_admin["Administration"]
  node_orders_admin["Orders"]
  node_audit_logs["Audit logs"]
  node_app_provider["Policies and observers"]
end

node_visitors(("Visitors and users"))
node_database[("Application database")]

node_visitors -.->|"request pages"| node_web_routes
node_web_routes -->|"routes to"| node_registration
node_web_routes -->|"routes to"| node_login
node_web_routes -->|"routes to"| node_member_portal
node_web_routes -->|"routes to"| node_dashboard
node_web_routes -->|"routes to"| node_member_admin
node_web_routes -->|"routes to"| node_users_admin
node_web_routes -->|"routes to"| node_attendance_admin
node_web_routes -->|"routes to"| node_attendance_reports
node_web_routes -->|"routes to"| node_sessions_admin
node_web_routes -->|"routes to"| node_announcements
node_web_routes -->|"routes to"| node_events_admin
node_web_routes -->|"routes to"| node_banners_admin
node_web_routes -->|"routes to"| node_messages_admin
node_web_routes -->|"routes to"| node_orders_admin
node_web_routes -->|"routes to"| node_audit_logs
node_registration -->|"creates account"| node_user_model
node_login -->|"authenticates"| node_user_model
node_member_portal -->|"uses records"| node_member_model
node_member_admin -->|"manages records"| node_member_model
node_member_admin -->|"uses statuses"| node_status_model
node_member_admin -->|"uses ministries"| node_ministry_model
node_member_admin -->|"uses accounts"| node_user_model
node_users_admin -->|"manages accounts"| node_user_model
node_users_admin -->|"uses member data"| node_member_model
node_users_admin -->|"uses statuses"| node_status_model
node_dashboard -->|"reads announcements"| node_announcement_model
node_dashboard -->|"reads events"| node_service_model
node_dashboard -->|"checks active session"| node_session_model
node_dashboard -->|"checks in"| node_attendance_model
node_dashboard -->|"checks identity"| node_user_model
node_attendance_admin -->|"records attendance"| node_attendance_model
node_attendance_admin -->|"uses member data"| node_member_model
node_attendance_admin -->|"uses sessions"| node_session_model
node_attendance_reports -->|"queries records"| node_attendance_model
node_attendance_reports -->|"reads member data"| node_member_model
node_attendance_reports -.->|"exports data"| node_attendance_export
node_sessions_admin -.->|"manages sessions"| node_session_model
node_announcements -->|"manages content"| node_announcement_model
node_events_admin -.->|"manages events"| node_service_model
node_banners_admin -.->|"persists banners"| node_database
node_messages_admin -.->|"persists messages"| node_database
node_orders_admin -.->|"persists orders"| node_database
node_audit_logs -.->|"reads logs"| node_database
node_app_provider -->|"registers policy"| node_member_model
node_app_provider -->|"registers policy"| node_status_model
node_app_provider -->|"registers observer"| node_user_model
node_app_provider -->|"registers observer"| node_ministry_model

click node_web_routes "https://github.com/hisui2121/church-management-system/blob/main/routes/web.php"
click node_registration "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/RegisterController.php"
click node_login "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Auth/LoginController.php"
click node_member_portal "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/MemberController.php"
click node_member_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/MembersController.php"
click node_users_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/UsersController.php"
click node_user_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/User.php"
click node_member_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/Member.php"
click node_status_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/MemberStatus.php"
click node_ministry_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/Ministry.php"
click node_dashboard "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/DashboardController.php"
click node_attendance_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/AttendanceController.php"
click node_attendance_reports "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/AttendanceReportController.php"
click node_attendance_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/Attendance.php"
click node_sessions_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/ServiceSessionsController.php"
click node_session_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/ServiceSession.php"
click node_service_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/Service.php"
click node_attendance_export "https://github.com/hisui2121/church-management-system/blob/main/app/Exports/AttendanceExport.php"
click node_announcements "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/AnnouncementsController.php"
click node_announcement_model "https://github.com/hisui2121/church-management-system/blob/main/app/Models/Announcement.php"
click node_events_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/EventsController.php"
click node_banners_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/BannerController.php"
click node_messages_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/MessagesController.php"
click node_orders_admin "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/OrdersController.php"
click node_audit_logs "https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/auditLogController.php"
click node_app_provider "https://github.com/hisui2121/church-management-system/blob/main/app/Providers/AppServiceProvider.php"

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_web_routes,node_dashboard,node_visitors toneBlue
class node_registration,node_login,node_member_portal,node_member_admin,node_users_admin,node_user_model,node_member_model,node_status_model,node_ministry_model,node_database toneAmber
class node_attendance_admin,node_attendance_reports,node_attendance_model,node_sessions_admin,node_session_model,node_service_model,node_attendance_export toneMint
class node_announcements,node_announcement_model,node_events_admin,node_banners_admin,node_messages_admin toneRose
class node_orders_admin,node_audit_logs,node_app_provider toneIndigo
```

## Components

### Web entry

- [Web routes](https://github.com/hisui2121/church-management-system/blob/main/routes/web.php): `routes/web.php`
- [Member dashboard](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`

### People and access

- [Registration steps](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/RegisterController.php): `app/Http/Controllers/RegisterController.php`
- [Login](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Auth/LoginController.php): `app/Http/Controllers/Auth/LoginController.php`
- [Member portal](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/MemberController.php): `app/Http/Controllers/MemberController.php`
- [Member administration](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/MembersController.php): `app/Http/Controllers/Admin/MembersController.php`
- [User administration](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/UsersController.php): `app/Http/Controllers/Admin/UsersController.php`
- [User accounts and roles](https://github.com/hisui2121/church-management-system/blob/main/app/Models/User.php): `app/Models/User.php`
- [Member records](https://github.com/hisui2121/church-management-system/blob/main/app/Models/Member.php): `app/Models/Member.php`
- [Member statuses](https://github.com/hisui2121/church-management-system/blob/main/app/Models/MemberStatus.php): `app/Models/MemberStatus.php`
- [Ministries](https://github.com/hisui2121/church-management-system/blob/main/app/Models/Ministry.php): `app/Models/Ministry.php`

### Services and attendance

- [Attendance management](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/AttendanceController.php): `app/Http/Controllers/Admin/AttendanceController.php`
- [Attendance reports](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/AttendanceReportController.php): `app/Http/Controllers/Admin/AttendanceReportController.php`
- [Attendance records](https://github.com/hisui2121/church-management-system/blob/main/app/Models/Attendance.php): `app/Models/Attendance.php`
- [Service sessions](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/ServiceSessionsController.php): `app/Http/Controllers/Admin/ServiceSessionsController.php`
- [Service session data](https://github.com/hisui2121/church-management-system/blob/main/app/Models/ServiceSession.php): `app/Models/ServiceSession.php`
- [Events and services](https://github.com/hisui2121/church-management-system/blob/main/app/Models/Service.php): `app/Models/Service.php`
- [Attendance export](https://github.com/hisui2121/church-management-system/blob/main/app/Exports/AttendanceExport.php): `app/Exports/AttendanceExport.php`

### Church content

- [Announcements](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/AnnouncementsController.php): `app/Http/Controllers/Admin/AnnouncementsController.php`
- [Announcement data](https://github.com/hisui2121/church-management-system/blob/main/app/Models/Announcement.php): `app/Models/Announcement.php`
- [Event administration](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/EventsController.php): `app/Http/Controllers/Admin/EventsController.php`
- [Banner administration](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/BannerController.php): `app/Http/Controllers/Admin/BannerController.php`
- [Messages](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/MessagesController.php): `app/Http/Controllers/Admin/MessagesController.php`

### Administration

- [Orders](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/Admin/OrdersController.php): `app/Http/Controllers/Admin/OrdersController.php`
- [Audit logs](https://github.com/hisui2121/church-management-system/blob/main/app/Http/Controllers/auditLogController.php): `app/Http/Controllers/auditLogController.php`
- [Policies and observers](https://github.com/hisui2121/church-management-system/blob/main/app/Providers/AppServiceProvider.php): `app/Providers/AppServiceProvider.php`

### Other components

- **Visitors and users**
- **Application database**

## Connections

- Visitors and users → Web routes: request pages
- Web routes → Registration steps: routes to (evidence: `routes/web.php`)
- Web routes → Login: routes to (evidence: `routes/web.php`)
- Web routes → Member portal: routes to (evidence: `routes/web.php`)
- Web routes → Member dashboard: routes to (evidence: `routes/web.php`)
- Web routes → Member administration: routes to (evidence: `routes/web.php`)
- Web routes → User administration: routes to (evidence: `routes/web.php`)
- Web routes → Attendance management: routes to (evidence: `routes/web.php`)
- Web routes → Attendance reports: routes to (evidence: `routes/web.php`)
- Web routes → Service sessions: routes to (evidence: `routes/web.php`)
- Web routes → Announcements: routes to (evidence: `routes/web.php`)
- Web routes → Event administration: routes to (evidence: `routes/web.php`)
- Web routes → Banner administration: routes to (evidence: `routes/web.php`)
- Web routes → Messages: routes to (evidence: `routes/web.php`)
- Web routes → Orders: routes to (evidence: `routes/web.php`)
- Web routes → Audit logs: routes to (evidence: `routes/web.php`)
- Registration steps → User accounts and roles: creates account (evidence: `app/Http/Controllers/RegisterController.php`)
- Login → User accounts and roles: authenticates (evidence: `app/Http/Controllers/Auth/LoginController.php`)
- Member portal → Member records: uses records (evidence: `app/Http/Controllers/MemberController.php`)
- Member administration → Member records: manages records (evidence: `app/Http/Controllers/Admin/MembersController.php`)
- Member administration → Member statuses: uses statuses (evidence: `app/Http/Controllers/Admin/MembersController.php`)
- Member administration → Ministries: uses ministries (evidence: `app/Http/Controllers/Admin/MembersController.php`)
- Member administration → User accounts and roles: uses accounts (evidence: `app/Http/Controllers/Admin/MembersController.php`)
- User administration → User accounts and roles: manages accounts (evidence: `app/Http/Controllers/Admin/UsersController.php`)
- User administration → Member records: uses member data (evidence: `app/Http/Controllers/Admin/UsersController.php`)
- User administration → Member statuses: uses statuses (evidence: `app/Http/Controllers/Admin/UsersController.php`)
- Member dashboard → Announcement data: reads announcements (evidence: `app/Http/Controllers/DashboardController.php`)
- Member dashboard → Events and services: reads events (evidence: `app/Http/Controllers/DashboardController.php`)
- Member dashboard → Service session data: checks active session (evidence: `app/Http/Controllers/DashboardController.php`)
- Member dashboard → Attendance records: checks in (evidence: `app/Http/Controllers/DashboardController.php`)
- Member dashboard → User accounts and roles: checks identity (evidence: `app/Http/Controllers/DashboardController.php`)
- Attendance management → Attendance records: records attendance (evidence: `app/Http/Controllers/Admin/AttendanceController.php`)
- Attendance management → Member records: uses member data (evidence: `app/Http/Controllers/Admin/AttendanceController.php`)
- Attendance management → Service session data: uses sessions (evidence: `app/Http/Controllers/Admin/AttendanceController.php`)
- Attendance reports → Attendance records: queries records (evidence: `app/Http/Controllers/Admin/AttendanceReportController.php`)
- Attendance reports → Member records: reads member data (evidence: `app/Http/Controllers/Admin/AttendanceReportController.php`)
- Attendance reports → Attendance export: exports data
- Service sessions → Service session data: manages sessions
- Announcements → Announcement data: manages content (evidence: `app/Http/Controllers/Admin/AnnouncementsController.php`)
- Event administration → Events and services: manages events
- Banner administration → Application database: persists banners
- Messages → Application database: persists messages
- Orders → Application database: persists orders
- Audit logs → Application database: reads logs
- Policies and observers → Member records: registers policy (evidence: `app/Providers/AppServiceProvider.php`)
- Policies and observers → Member statuses: registers policy (evidence: `app/Providers/AppServiceProvider.php`)
- Policies and observers → User accounts and roles: registers observer (evidence: `app/Providers/AppServiceProvider.php`)
- Policies and observers → Ministries: registers observer (evidence: `app/Providers/AppServiceProvider.php`)
