# yalnezami/messageit-ui-f architecture

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

- Interactive diagram: https://gitdiagram.com/yalnezami/messageit-ui-f
- Repository: https://github.com/yalnezami/messageit-ui-f

## Overview

This is a Nuxt frontend for a real-time messaging product, with private, group, and AI conversations. The main user journey is to authenticate, enter private space, open a conversation, and send or manage messages; the conversation card’s route navigation and composer’s upload/send calls are directly shown. The README documents an external API and MongoDB deployment, plus optional Gemini assistance, but most page and store implementations were not sampled. Accordingly, several capability branches are represented by their exact tree paths without speculative internal links.

Main entry points: [`components/messageInput/index.vue`](https://github.com/yalnezami/messageit-ui-f/blob/master/components/messageInput/index.vue) (Message composer), [`components/conversation/index.vue`](https://github.com/yalnezami/messageit-ui-f/blob/master/components/conversation/index.vue) (Conversation card), [`pages/conversations/[id]/messages.vue`](https://github.com/yalnezami/messageit-ui-f/blob/master/pages/conversations/%5Bid%5D/messages.vue) (Conversation messages), [`interfaces`](https://github.com/yalnezami/messageit-ui-f/tree/master/interfaces) (Messaging domain types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_pages["Login and registration"]
  node_auth_store["Authentication session<br/>[auth.store.ts]"]
end

subgraph group_spaces["Conversation spaces"]
  node_private_space["Private space"]
  node_conversation_list["Conversation list<br/>[index.vue]"]
  node_conversation_card["Conversation card<br/>[index.vue]"]
  node_conversation_store["Conversation state"]
  node_conversation_search["Conversation search"]
  node_group_creation["Create group<br/>[index.vue]"]
  node_conversation_tools["Conversation tools"]
end

subgraph group_messaging["Messaging"]
  node_conversation_messages["Conversation messages<br/>[messages.vue]"]
  node_message_view["Message display<br/>[index.vue]"]
  node_message_composer["Message composer<br/>[index.vue]"]
  node_message_store["Message state and actions<br/>[messages.store.ts]"]
  node_upload_store["Upload state and actions<br/>[upload.store.ts]"]
  node_upload_api["Upload endpoints"]
end

subgraph group_social["People and profile"]
  node_friends["Friends and requests<br/>[index.vue]"]
  node_notifications["Notifications<br/>[index.vue]"]
  node_profile["Profile and settings<br/>[index.vue]"]
end

subgraph group_runtime["Client runtime"]
  node_message_types["Messaging domain types"]
  node_event_bus["Realtime event bus<br/>[eventBus.ts]"]
end

node_user(("User"))
node_api["Messaging API"]
node_gemini["Gemini assistant"]
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_auth_pages
node_auth_pages -.->|"authenticates"| node_auth_store
node_auth_store -->|"calls services"| node_api
node_api -.->|"persists data"| node_mongodb
node_user -.->|"enters"| node_private_space
node_private_space -.->|"opens conversations"| node_conversation_list
node_conversation_list -->|"filters with"| node_conversation_search
node_conversation_card -->|"navigates to"| node_conversation_messages
node_conversation_card -->|"reads conversation state"| node_conversation_store
node_conversation_messages -.->|"renders messages"| node_message_view
node_conversation_messages -.->|"provides composer"| node_message_composer
node_message_composer -->|"uploads files"| node_upload_store
node_message_composer -->|"sends messages"| node_message_store
node_message_store -.->|"exchanges messages"| node_api
node_upload_api -.->|"serves uploads"| node_api
node_conversation_card -->|"uses domain types"| node_message_types
node_message_view -->|"uses domain types"| node_message_types
node_message_composer -->|"uses domain types"| node_message_types
node_user -.->|"manages contacts"| node_friends
node_user -.->|"checks updates"| node_notifications
node_user -.->|"edits profile"| node_profile
node_user -.->|"creates groups"| node_group_creation
node_user -.->|"manages conversation"| node_conversation_tools
node_api -.->|"sends assistant content"| node_gemini

click node_auth_pages "https://github.com/yalnezami/messageit-ui-f/tree/master/pages/auth"
click node_auth_store "https://github.com/yalnezami/messageit-ui-f/blob/master/stores/auth.store.ts"
click node_private_space "https://github.com/yalnezami/messageit-ui-f/tree/master/pages/private-space"
click node_conversation_list "https://github.com/yalnezami/messageit-ui-f/blob/master/pages/conversations/index.vue"
click node_conversation_card "https://github.com/yalnezami/messageit-ui-f/blob/master/components/conversation/index.vue"
click node_conversation_messages "https://github.com/yalnezami/messageit-ui-f/blob/master/pages/conversations/%5Bid%5D/messages.vue"
click node_conversation_store "https://github.com/yalnezami/messageit-ui-f/blob/master/stores/conversations.store.ts"
click node_conversation_search "https://github.com/yalnezami/messageit-ui-f/blob/master/utils/conversationSearch.ts"
click node_message_view "https://github.com/yalnezami/messageit-ui-f/blob/master/components/message/index.vue"
click node_message_composer "https://github.com/yalnezami/messageit-ui-f/blob/master/components/messageInput/index.vue"
click node_message_store "https://github.com/yalnezami/messageit-ui-f/blob/master/stores/messages.store.ts"
click node_upload_store "https://github.com/yalnezami/messageit-ui-f/blob/master/stores/upload.store.ts"
click node_upload_api "https://github.com/yalnezami/messageit-ui-f/tree/master/server/api"
click node_message_types "https://github.com/yalnezami/messageit-ui-f/tree/master/interfaces"
click node_event_bus "https://github.com/yalnezami/messageit-ui-f/blob/master/utils/eventBus.ts"
click node_friends "https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/friends/index.vue"
click node_notifications "https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/notifications/index.vue"
click node_profile "https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/profile/index.vue"
click node_group_creation "https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/createGroup/index.vue"
click node_conversation_tools "https://github.com/yalnezami/messageit-ui-f/tree/master/pages/conversations/%5Bid%5D"

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_auth_pages,node_auth_store,node_user toneBlue
class node_private_space,node_conversation_list,node_conversation_card,node_conversation_store,node_conversation_search,node_group_creation,node_conversation_tools,node_mongodb toneAmber
class node_conversation_messages,node_message_view,node_message_composer,node_message_store,node_upload_store,node_upload_api,node_api toneMint
class node_friends,node_notifications,node_profile toneRose
class node_message_types,node_event_bus,node_gemini toneIndigo
```

## Components

### Identity and access

- [Login and registration](https://github.com/yalnezami/messageit-ui-f/tree/master/pages/auth): `pages/auth`
- [Authentication session](https://github.com/yalnezami/messageit-ui-f/blob/master/stores/auth.store.ts): `stores/auth.store.ts`

### Conversation spaces

- [Private space](https://github.com/yalnezami/messageit-ui-f/tree/master/pages/private-space): `pages/private-space`
- [Conversation list](https://github.com/yalnezami/messageit-ui-f/blob/master/pages/conversations/index.vue): `pages/conversations/index.vue`
- [Conversation card](https://github.com/yalnezami/messageit-ui-f/blob/master/components/conversation/index.vue): `components/conversation/index.vue`
- [Conversation state](https://github.com/yalnezami/messageit-ui-f/blob/master/stores/conversations.store.ts): `stores/conversations.store.ts`
- [Conversation search](https://github.com/yalnezami/messageit-ui-f/blob/master/utils/conversationSearch.ts): `utils/conversationSearch.ts`
- [Create group](https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/createGroup/index.vue): `pages/private-space/createGroup/index.vue`
- [Conversation tools](https://github.com/yalnezami/messageit-ui-f/tree/master/pages/conversations/%5Bid%5D): `pages/conversations/[id]`

### Messaging

- [Conversation messages](https://github.com/yalnezami/messageit-ui-f/blob/master/pages/conversations/%5Bid%5D/messages.vue): `pages/conversations/[id]/messages.vue`
- [Message display](https://github.com/yalnezami/messageit-ui-f/blob/master/components/message/index.vue): `components/message/index.vue`
- [Message composer](https://github.com/yalnezami/messageit-ui-f/blob/master/components/messageInput/index.vue): `components/messageInput/index.vue`
- [Message state and actions](https://github.com/yalnezami/messageit-ui-f/blob/master/stores/messages.store.ts): `stores/messages.store.ts`
- [Upload state and actions](https://github.com/yalnezami/messageit-ui-f/blob/master/stores/upload.store.ts): `stores/upload.store.ts`
- [Upload endpoints](https://github.com/yalnezami/messageit-ui-f/tree/master/server/api): `server/api`

### People and profile

- [Friends and requests](https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/friends/index.vue): `pages/private-space/friends/index.vue`
- [Notifications](https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/notifications/index.vue): `pages/private-space/notifications/index.vue`
- [Profile and settings](https://github.com/yalnezami/messageit-ui-f/blob/master/pages/private-space/profile/index.vue): `pages/private-space/profile/index.vue`

### Client runtime

- [Messaging domain types](https://github.com/yalnezami/messageit-ui-f/tree/master/interfaces): `interfaces`
- [Realtime event bus](https://github.com/yalnezami/messageit-ui-f/blob/master/utils/eventBus.ts): `utils/eventBus.ts`

### Other components

- **User**
- **Messaging API**
- **Gemini assistant**
- **MongoDB**

## Connections

- User → Login and registration: uses
- Login and registration → Authentication session: authenticates
- Authentication session → Messaging API: calls services (evidence: `stores/auth.store.ts`)
- Messaging API → MongoDB: persists data (evidence: `README.md`)
- User → Private space: enters
- Private space → Conversation list: opens conversations
- Conversation list → Conversation search: filters with (evidence: `pages/conversations/index.vue`)
- Conversation card → Conversation messages: navigates to (evidence: `components/conversation/index.vue`)
- Conversation card → Conversation state: reads conversation state (evidence: `components/conversation/index.vue`)
- Conversation messages → Message display: renders messages
- Conversation messages → Message composer: provides composer
- Message composer → Upload state and actions: uploads files (evidence: `components/messageInput/index.vue`)
- Message composer → Message state and actions: sends messages (evidence: `components/messageInput/index.vue`)
- Message state and actions → Messaging API: exchanges messages
- Upload endpoints → Messaging API: serves uploads
- Conversation card → Messaging domain types: uses domain types (evidence: `components/conversation/index.vue`)
- Message display → Messaging domain types: uses domain types (evidence: `components/message/index.vue`)
- Message composer → Messaging domain types: uses domain types (evidence: `components/messageInput/index.vue`)
- User → Friends and requests: manages contacts
- User → Notifications: checks updates
- User → Profile and settings: edits profile
- User → Create group: creates groups
- User → Conversation tools: manages conversation
- Messaging API → Gemini assistant: sends assistant content (evidence: `README.md`)
