# dev-tew/chatapp architecture

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

- Interactive diagram: https://gitdiagram.com/dev-tew/chatapp
- Repository: https://github.com/dev-tew/chatapp

## Overview

This repository is a Laravel/Inertia chat application: users register or sign in, open private or group conversations, retrieve history, and send text or image messages that are persisted and broadcast. The frontend also includes profile and online-status capabilities. The principal message flow is grounded in ChatController; the tree indicates other UI and presence branches, but their implementation and exact wiring were not sampled. The README describes Laravel generically, so it does not document application-specific behavior.

Main entry points: [`app/Http/Controllers/ChatController.php`](https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/ChatController.php) (Chat requests), [`app/Models/User.php`](https://github.com/dev-tew/chatapp/blob/main/app/Models/User.php) (User model), [`app/Providers/BroadcastServiceProvider.php`](https://github.com/dev-tew/chatapp/blob/main/app/Providers/BroadcastServiceProvider.php) (Broadcast service), [`config/database.php`](https://github.com/dev-tew/chatapp/blob/main/config/database.php) (Relational database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry and routing"]
  node_http["HTTP entry<br/>[index.php]"]
  node_router["Web routes<br/>[web.php]"]
  node_api_routes["API routes<br/>[api.php]"]
  node_auth_routes["Auth routes<br/>[auth.php]"]
end

subgraph group_identity["Accounts and profile"]
  node_auth["Authentication"]
  node_sessions["Session handling"]
  node_profile["Profile management"]
  node_user_model["User model<br/>[User.php]"]
end

subgraph group_messaging["Chat and persistence"]
  node_chat_controller["Chat requests<br/>[ChatController.php]"]
  node_conversations["Conversations<br/>[Conversation.php]"]
  node_participants["Participants<br/>[Participant.php]"]
  node_messages["Messages<br/>[Message.php]"]
  node_database[("Relational database<br/>[database.php]")]
end

subgraph group_realtime["Realtime and interface"]
  node_private_event["Private message event"]
  node_group_event["Group message event"]
  node_status_event["User status event"]
  node_channel_routes["Channel authorization<br/>[channels.php]"]
  node_chat_ui["Chat interface<br/>[Chat.jsx]"]
  node_group_ui["Group chat interface<br/>[GroupChat.jsx]"]
  node_echo["Realtime client<br/>[Echo.jsx]"]
  node_online_hook["Online status hook"]
  node_broadcast["Broadcast service"]
end

node_browser(("Browser user"))
node_websocket(("WebSocket service"))

node_browser -->|"sends requests"| node_http
node_http -->|"hands off"| node_router
node_router -->|"routes chat"| node_chat_controller
node_router -->|"routes profile"| node_profile
node_auth_routes -->|"routes registration"| node_auth
node_auth_routes -->|"routes sessions"| node_sessions
node_browser -->|"submits credentials"| node_auth_routes
node_browser -->|"requests API"| node_api_routes
node_auth -->|"creates user"| node_user_model
node_auth -->|"creates group membership"| node_conversations
node_sessions -->|"authenticates user"| node_user_model
node_profile -->|"updates account"| node_user_model
node_chat_controller -->|"finds or creates"| node_conversations
node_chat_controller -->|"reads and saves"| node_messages
node_chat_controller -->|"loads users"| node_user_model
node_conversations -->|"persists"| node_database
node_participants -->|"persists"| node_database
node_messages -->|"persists"| node_database
node_user_model -->|"persists"| node_database
node_chat_controller -->|"dispatches private"| node_private_event
node_chat_controller -->|"dispatches group"| node_group_event
node_private_event -->|"broadcasts event"| node_broadcast
node_group_event -->|"broadcasts event"| node_broadcast
node_broadcast -.->|"publishes events"| node_websocket
node_browser -->|"uses chat"| node_chat_ui
node_browser -->|"uses group chat"| node_group_ui
node_chat_ui -->|"sends chat requests"| node_chat_controller
node_group_ui -->|"sends group requests"| node_chat_controller
node_chat_ui -->|"uses realtime client"| node_echo
node_group_ui -->|"uses realtime client"| node_echo
node_echo -.->|"subscribes"| node_websocket
node_online_hook -.->|"subscribes to status"| node_channel_routes
node_status_event -.->|"broadcasts status"| node_broadcast
node_channel_routes -.->|"authorizes channels"| node_broadcast

click node_http "https://github.com/dev-tew/chatapp/blob/main/public/index.php"
click node_router "https://github.com/dev-tew/chatapp/blob/main/routes/web.php"
click node_api_routes "https://github.com/dev-tew/chatapp/blob/main/routes/api.php"
click node_auth_routes "https://github.com/dev-tew/chatapp/blob/main/routes/auth.php"
click node_auth "https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_sessions "https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_profile "https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/ProfileController.php"
click node_user_model "https://github.com/dev-tew/chatapp/blob/main/app/Models/User.php"
click node_chat_controller "https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/ChatController.php"
click node_conversations "https://github.com/dev-tew/chatapp/blob/main/app/Models/Conversation.php"
click node_participants "https://github.com/dev-tew/chatapp/blob/main/app/Models/Participant.php"
click node_messages "https://github.com/dev-tew/chatapp/blob/main/app/Models/Message.php"
click node_database "https://github.com/dev-tew/chatapp/blob/main/config/database.php"
click node_private_event "https://github.com/dev-tew/chatapp/blob/main/app/Events/PrivateMessageEvent.php"
click node_group_event "https://github.com/dev-tew/chatapp/blob/main/app/Events/GroupMessageEvent.php"
click node_status_event "https://github.com/dev-tew/chatapp/blob/main/app/Events/UserStatusEvent.php"
click node_channel_routes "https://github.com/dev-tew/chatapp/blob/main/routes/channels.php"
click node_chat_ui "https://github.com/dev-tew/chatapp/blob/main/resources/js/Pages/Chat.jsx"
click node_group_ui "https://github.com/dev-tew/chatapp/blob/main/resources/js/Pages/GroupChat.jsx"
click node_echo "https://github.com/dev-tew/chatapp/blob/main/resources/js/Components/EchoComponent/Echo.jsx"
click node_online_hook "https://github.com/dev-tew/chatapp/blob/main/resources/js/Hooks/useOnlineStatusChannel.jsx"
click node_broadcast "https://github.com/dev-tew/chatapp/blob/main/app/Providers/BroadcastServiceProvider.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_http,node_router,node_api_routes,node_auth_routes,node_browser toneBlue
class node_auth,node_sessions,node_profile,node_user_model toneAmber
class node_chat_controller,node_conversations,node_participants,node_messages,node_database toneMint
class node_private_event,node_group_event,node_status_event,node_channel_routes,node_chat_ui,node_group_ui,node_echo,node_online_hook,node_broadcast toneRose
class node_websocket toneIndigo
```

## Components

### Web entry and routing

- [HTTP entry](https://github.com/dev-tew/chatapp/blob/main/public/index.php): `public/index.php`
- [Web routes](https://github.com/dev-tew/chatapp/blob/main/routes/web.php): `routes/web.php`
- [API routes](https://github.com/dev-tew/chatapp/blob/main/routes/api.php): `routes/api.php`
- [Auth routes](https://github.com/dev-tew/chatapp/blob/main/routes/auth.php): `routes/auth.php`

### Accounts and profile

- [Authentication](https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Session handling](https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Profile management](https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/ProfileController.php): `app/Http/Controllers/ProfileController.php`
- [User model](https://github.com/dev-tew/chatapp/blob/main/app/Models/User.php): `app/Models/User.php`

### Chat and persistence

- [Chat requests](https://github.com/dev-tew/chatapp/blob/main/app/Http/Controllers/ChatController.php): `app/Http/Controllers/ChatController.php`
- [Conversations](https://github.com/dev-tew/chatapp/blob/main/app/Models/Conversation.php): `app/Models/Conversation.php`
- [Participants](https://github.com/dev-tew/chatapp/blob/main/app/Models/Participant.php): `app/Models/Participant.php`
- [Messages](https://github.com/dev-tew/chatapp/blob/main/app/Models/Message.php): `app/Models/Message.php`
- [Relational database](https://github.com/dev-tew/chatapp/blob/main/config/database.php): `config/database.php`

### Realtime and interface

- [Private message event](https://github.com/dev-tew/chatapp/blob/main/app/Events/PrivateMessageEvent.php): `app/Events/PrivateMessageEvent.php`
- [Group message event](https://github.com/dev-tew/chatapp/blob/main/app/Events/GroupMessageEvent.php): `app/Events/GroupMessageEvent.php`
- [User status event](https://github.com/dev-tew/chatapp/blob/main/app/Events/UserStatusEvent.php): `app/Events/UserStatusEvent.php`
- [Channel authorization](https://github.com/dev-tew/chatapp/blob/main/routes/channels.php): `routes/channels.php`
- [Chat interface](https://github.com/dev-tew/chatapp/blob/main/resources/js/Pages/Chat.jsx): `resources/js/Pages/Chat.jsx`
- [Group chat interface](https://github.com/dev-tew/chatapp/blob/main/resources/js/Pages/GroupChat.jsx): `resources/js/Pages/GroupChat.jsx`
- [Realtime client](https://github.com/dev-tew/chatapp/blob/main/resources/js/Components/EchoComponent/Echo.jsx): `resources/js/Components/EchoComponent/Echo.jsx`
- [Online status hook](https://github.com/dev-tew/chatapp/blob/main/resources/js/Hooks/useOnlineStatusChannel.jsx): `resources/js/Hooks/useOnlineStatusChannel.jsx`
- [Broadcast service](https://github.com/dev-tew/chatapp/blob/main/app/Providers/BroadcastServiceProvider.php): `app/Providers/BroadcastServiceProvider.php`

### Other components

- **Browser user**
- **WebSocket service**

## Connections

- Browser user → HTTP entry: sends requests
- HTTP entry → Web routes: hands off
- Web routes → Chat requests: routes chat
- Web routes → Profile management: routes profile
- Auth routes → Authentication: routes registration
- Auth routes → Session handling: routes sessions
- Browser user → Auth routes: submits credentials
- Browser user → API routes: requests API
- Authentication → User model: creates user
- Authentication → Conversations: creates group membership
- Session handling → User model: authenticates user
- Profile management → User model: updates account
- Chat requests → Conversations: finds or creates
- Chat requests → Messages: reads and saves
- Chat requests → User model: loads users
- Conversations → Relational database: persists
- Participants → Relational database: persists
- Messages → Relational database: persists
- User model → Relational database: persists
- Chat requests → Private message event: dispatches private
- Chat requests → Group message event: dispatches group
- Private message event → Broadcast service: broadcasts event
- Group message event → Broadcast service: broadcasts event
- Broadcast service → WebSocket service: publishes events
- Browser user → Chat interface: uses chat
- Browser user → Group chat interface: uses group chat
- Chat interface → Chat requests: sends chat requests
- Group chat interface → Chat requests: sends group requests
- Chat interface → Realtime client: uses realtime client
- Group chat interface → Realtime client: uses realtime client
- Realtime client → WebSocket service: subscribes
- Online status hook → Channel authorization: subscribes to status
- User status event → Broadcast service: broadcasts status
- Channel authorization → Broadcast service: authorizes channels