# brian772/club-hobi architecture

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

- Interactive diagram: https://gitdiagram.com/brian772/club-hobi
- Repository: https://github.com/brian772/club-hobi

## Overview

This is a Laravel hobby-club community application: users register, choose interests, discover clubs, request membership, and participate through club posts and social interactions. Separate areas support profiles and account settings, messaging and notifications, and administrator review of clubs, users, reports, appeals, and moderation. The tree and sampled controllers establish these product areas, but most controller implementations and route wiring were not sampled; uncertain connections are therefore omitted.

Main entry points: [`app/Http/Controllers/Clubs/ClubController.php`](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Clubs/ClubController.php) (Club discovery), [`app/Models/User.php`](https://github.com/brian772/club-hobi/blob/main/app/Models/User.php) (User records), [`app/Models/ClubMember.php`](https://github.com/brian772/club-hobi/blob/main/app/Models/ClubMember.php) (Club membership), [`config/database.php`](https://github.com/brian772/club-hobi/blob/main/config/database.php) (Configured database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and profiles"]
  node_registration["Registration"]
  node_auth["Authentication"]
  node_user[("User records<br/>[User.php]")]
  node_settings["Profile settings"]
end

subgraph group_community["Clubs and participation"]
  node_dashboard["Dashboard"]
  node_clubs["Club discovery<br/>[ClubController.php]"]
  node_clubdata[("Club records<br/>[Club.php]")]
  node_join["Join requests"]
  node_members[("Club membership<br/>[ClubMember.php]")]
  node_clubproposal["Club proposals"]
end

subgraph group_social["Community activity"]
  node_posts["Post management<br/>[PostController.php]"]
  node_postdata[("Posts and media<br/>[Post.php]")]
  node_comments[("Comments and likes<br/>[Comment.php]")]
  node_messages["Messaging"]
  node_notifications["Notifications"]
end

subgraph group_governance["Administration and safety"]
  node_reports["Reports"]
  node_appeals["Appeals"]
  node_adminclubs["Club review"]
  node_adminmoderation["Moderation"]
  node_adminusers["User administration"]
end

node_visitor(("Visitor or member"))
node_webui["Web interface<br/>[app.blade.php]"]
node_database[("Configured database<br/>[database.php]")]

node_visitor -->|"registers"| node_registration
node_visitor -->|"signs in"| node_auth
node_registration -->|"creates account"| node_user
node_registration -->|"renders steps"| node_webui
node_auth -->|"authenticates"| node_user
node_visitor -->|"edits profile"| node_settings
node_settings -->|"updates profile"| node_user
node_visitor -->|"opens"| node_dashboard
node_visitor -->|"discovers"| node_clubs
node_clubs -->|"queries clubs"| node_clubdata
node_clubs -->|"checks membership"| node_members
node_clubs -->|"loads club posts"| node_postdata
node_visitor -->|"requests entry"| node_join
node_join -->|"creates membership"| node_members
node_visitor -->|"proposes club"| node_clubproposal
node_visitor -->|"publishes or edits"| node_posts
node_posts -->|"writes posts"| node_postdata
node_posts -->|"manages interactions"| node_comments
node_visitor -->|"sends messages"| node_messages
node_visitor -->|"views notifications"| node_notifications
node_visitor -->|"reports content"| node_reports
node_visitor -->|"submits appeal"| node_appeals
node_visitor -->|"reviews proposals"| node_adminclubs
node_adminclubs -->|"creates approved club"| node_clubdata
node_adminclubs -->|"assigns owner"| node_members
node_visitor -->|"moderates content"| node_adminmoderation
node_visitor -->|"manages accounts"| node_adminusers
node_user -->|"persists via ORM"| node_database
node_clubdata -->|"persists via ORM"| node_database
node_members -->|"persists via ORM"| node_database
node_postdata -->|"persists via ORM"| node_database

click node_registration "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_auth "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_user "https://github.com/brian772/club-hobi/blob/main/app/Models/User.php"
click node_settings "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Settings/SettingsController.php"
click node_dashboard "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/DashboardController.php"
click node_clubs "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Clubs/ClubController.php"
click node_clubdata "https://github.com/brian772/club-hobi/blob/main/app/Models/Club.php"
click node_join "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Clubs/ClubJoinRequestController.php"
click node_members "https://github.com/brian772/club-hobi/blob/main/app/Models/ClubMember.php"
click node_clubproposal "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Clubs/ClubRequestController.php"
click node_posts "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/PostController.php"
click node_postdata "https://github.com/brian772/club-hobi/blob/main/app/Models/Post.php"
click node_comments "https://github.com/brian772/club-hobi/blob/main/app/Models/Comment.php"
click node_messages "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/MessageController.php"
click node_notifications "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/NotificationController.php"
click node_reports "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/ReportController.php"
click node_appeals "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/AppealController.php"
click node_adminclubs "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Admin/AdminClubRequestController.php"
click node_adminmoderation "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Admin/ModerationController.php"
click node_adminusers "https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Admin/AdminUserManagementController.php"
click node_webui "https://github.com/brian772/club-hobi/blob/main/resources/views/layouts/app.blade.php"
click node_database "https://github.com/brian772/club-hobi/blob/main/config/database.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_registration,node_auth,node_user,node_settings toneBlue
class node_dashboard,node_clubs,node_clubdata,node_join,node_members,node_clubproposal,node_database toneAmber
class node_posts,node_postdata,node_comments,node_messages,node_notifications toneMint
class node_reports,node_appeals,node_adminclubs,node_adminmoderation,node_adminusers toneRose
class node_visitor toneIndigo
class node_webui toneTeal
```

## Components

### Identity and profiles

- [Registration](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Authentication](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [User records](https://github.com/brian772/club-hobi/blob/main/app/Models/User.php): `app/Models/User.php`
- [Profile settings](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Settings/SettingsController.php): `app/Http/Controllers/Settings/SettingsController.php`

### Clubs and participation

- [Dashboard](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Club discovery](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Clubs/ClubController.php): `app/Http/Controllers/Clubs/ClubController.php`
- [Club records](https://github.com/brian772/club-hobi/blob/main/app/Models/Club.php): `app/Models/Club.php`
- [Join requests](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Clubs/ClubJoinRequestController.php): `app/Http/Controllers/Clubs/ClubJoinRequestController.php`
- [Club membership](https://github.com/brian772/club-hobi/blob/main/app/Models/ClubMember.php): `app/Models/ClubMember.php`
- [Club proposals](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Clubs/ClubRequestController.php): `app/Http/Controllers/Clubs/ClubRequestController.php`

### Community activity

- [Post management](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/PostController.php): `app/Http/Controllers/PostController.php`
- [Posts and media](https://github.com/brian772/club-hobi/blob/main/app/Models/Post.php): `app/Models/Post.php`
- [Comments and likes](https://github.com/brian772/club-hobi/blob/main/app/Models/Comment.php): `app/Models/Comment.php`
- [Messaging](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/MessageController.php): `app/Http/Controllers/MessageController.php`
- [Notifications](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/NotificationController.php): `app/Http/Controllers/NotificationController.php`

### Administration and safety

- [Reports](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/ReportController.php): `app/Http/Controllers/ReportController.php`
- [Appeals](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/AppealController.php): `app/Http/Controllers/AppealController.php`
- [Club review](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Admin/AdminClubRequestController.php): `app/Http/Controllers/Admin/AdminClubRequestController.php`
- [Moderation](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Admin/ModerationController.php): `app/Http/Controllers/Admin/ModerationController.php`
- [User administration](https://github.com/brian772/club-hobi/blob/main/app/Http/Controllers/Admin/AdminUserManagementController.php): `app/Http/Controllers/Admin/AdminUserManagementController.php`

### Other components

- **Visitor or member**
- [Web interface](https://github.com/brian772/club-hobi/blob/main/resources/views/layouts/app.blade.php): `resources/views/layouts/app.blade.php`
- [Configured database](https://github.com/brian772/club-hobi/blob/main/config/database.php): `config/database.php`

## Connections

- Visitor or member → Registration: registers
- Visitor or member → Authentication: signs in
- Registration → User records: creates account
- Registration → Web interface: renders steps
- Authentication → User records: authenticates
- Visitor or member → Profile settings: edits profile
- Profile settings → User records: updates profile
- Visitor or member → Dashboard: opens
- Visitor or member → Club discovery: discovers
- Club discovery → Club records: queries clubs
- Club discovery → Club membership: checks membership
- Club discovery → Posts and media: loads club posts
- Visitor or member → Join requests: requests entry
- Join requests → Club membership: creates membership
- Visitor or member → Club proposals: proposes club
- Visitor or member → Post management: publishes or edits
- Post management → Posts and media: writes posts
- Post management → Comments and likes: manages interactions
- Visitor or member → Messaging: sends messages
- Visitor or member → Notifications: views notifications
- Visitor or member → Reports: reports content
- Visitor or member → Appeals: submits appeal
- Visitor or member → Club review: reviews proposals
- Club review → Club records: creates approved club
- Club review → Club membership: assigns owner
- Visitor or member → Moderation: moderates content
- Visitor or member → User administration: manages accounts
- User records → Configured database: persists via ORM
- Club records → Configured database: persists via ORM
- Club membership → Configured database: persists via ORM
- Posts and media → Configured database: persists via ORM