# darkvex-x/digi-moi architecture

> Architecture diagram of the GitHub repository darkvex-x/digi-moi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/darkvex-x/digi-moi
- Repository: https://github.com/darkvex-x/digi-moi

## Overview

DigiMoi is an event collection and receipt-management application: authenticated users create or open an event, record and manage entries, then review, export, or print the resulting ledger. Supporting areas cover event history, settings, and user administration, with role-based permissions shaping available actions. The source index documents the main page-to-service dependencies; the excerpts show Firestore-backed storage and receipt preview behavior. Several page implementations and layout components were not sampled, so some page-to-page or UI details are intentionally not inferred.

Main entry points: [`src/App.jsx`](https://github.com/darkvex-x/digi-moi/blob/main/src/App.jsx) (App routing), [`src/services/storage.js`](https://github.com/darkvex-x/digi-moi/blob/main/src/services/storage.js) (Storage service), [`src/context/PermissionContext.jsx`](https://github.com/darkvex-x/digi-moi/blob/main/src/context/PermissionContext.jsx) (Permission context), [`src/pages/Database/Database.jsx`](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Database/Database.jsx) (Entry database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Event workflow"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_create["Event creation<br/>[EventCreate.jsx]"]
  node_event["Event ledger<br/>[EventView.jsx]"]
  node_history["Event history<br/>[EventHistory.jsx]"]
  node_database["Entry database<br/>[Database.jsx]"]
end

subgraph group_admin["Administration"]
  node_settings["Settings<br/>[Settings.jsx]"]
  node_users["User management<br/>[UserManagement.jsx]"]
  node_permissions["Role permissions<br/>[permissions.js]"]
end

subgraph group_platform["Shared platform"]
  node_app["App routing<br/>[App.jsx]"]
  node_login["Authentication<br/>[Login.jsx]"]
  node_permission_context["Permission context"]
  node_event_context["Event context<br/>[EventContext.jsx]"]
  node_settings_context["Settings context"]
  node_ui["UI primitives"]
end

subgraph group_data["Data and output"]
  node_storage["Storage service<br/>[storage.js]"]
  node_firestore[("Firestore<br/>[firebase.js]")]
  node_export["Export service<br/>[export.js]"]
  node_print_preview["Print preview"]
  node_receipt["Thermal receipt<br/>[ThermalReceipt.jsx]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_create
node_app -->|"routes to"| node_event
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_database
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_users
node_app -->|"provides"| node_event_context
node_app -->|"provides"| node_settings_context
node_app -->|"provides"| node_permission_context
node_app -->|"uses"| node_ui
node_permission_context -->|"gets role rules"| node_permissions
node_permission_context -->|"reads user role"| node_firestore
node_event_context -->|"reads events"| node_storage
node_settings_context -->|"loads settings"| node_storage
node_event -->|"reads and writes"| node_storage
node_database -->|"manages entries"| node_storage
node_database -->|"exports ledger"| node_export
node_database -->|"checks access"| node_permission_context
node_history -->|"loads history"| node_storage
node_history -->|"opens receipt preview"| node_print_preview
node_settings -->|"manages settings"| node_storage
node_settings -->|"checks access"| node_permission_context
node_users -->|"manages users"| node_storage
node_users -->|"checks access"| node_permission_context
node_storage -->|"reads and writes"| node_firestore
node_print_preview -->|"loads settings"| node_storage
node_print_preview -->|"renders"| node_receipt
node_print_preview -->|"uses modal and buttons"| node_ui

click node_app "https://github.com/darkvex-x/digi-moi/blob/main/src/App.jsx"
click node_login "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Auth/Login.jsx"
click node_dashboard "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Dashboard/Dashboard.jsx"
click node_create "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/EventCreate/EventCreate.jsx"
click node_event "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/EventView/EventView.jsx"
click node_history "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/EventHistory/EventHistory.jsx"
click node_database "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Database/Database.jsx"
click node_settings "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Settings/Settings.jsx"
click node_users "https://github.com/darkvex-x/digi-moi/blob/main/src/pages/UserManagement/UserManagement.jsx"
click node_permissions "https://github.com/darkvex-x/digi-moi/blob/main/src/services/permissions.js"
click node_permission_context "https://github.com/darkvex-x/digi-moi/blob/main/src/context/PermissionContext.jsx"
click node_event_context "https://github.com/darkvex-x/digi-moi/blob/main/src/context/EventContext.jsx"
click node_settings_context "https://github.com/darkvex-x/digi-moi/blob/main/src/context/SettingsContext.jsx"
click node_storage "https://github.com/darkvex-x/digi-moi/blob/main/src/services/storage.js"
click node_firestore "https://github.com/darkvex-x/digi-moi/blob/main/src/firebase.js"
click node_export "https://github.com/darkvex-x/digi-moi/blob/main/src/services/export.js"
click node_print_preview "https://github.com/darkvex-x/digi-moi/blob/main/src/components/print/PrintPreviewModal.jsx"
click node_receipt "https://github.com/darkvex-x/digi-moi/blob/main/src/components/print/ThermalReceipt.jsx"
click node_ui "https://github.com/darkvex-x/digi-moi/tree/main/src/components/ui"

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_dashboard,node_create,node_event,node_history,node_database,node_user toneBlue
class node_settings,node_users,node_permissions toneAmber
class node_app,node_login,node_permission_context,node_event_context,node_settings_context,node_ui toneMint
class node_storage,node_firestore,node_export,node_print_preview,node_receipt toneRose
```

## Components

### Event workflow

- [Dashboard](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Dashboard/Dashboard.jsx): `src/pages/Dashboard/Dashboard.jsx`
- [Event creation](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/EventCreate/EventCreate.jsx): `src/pages/EventCreate/EventCreate.jsx`
- [Event ledger](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/EventView/EventView.jsx): `src/pages/EventView/EventView.jsx`
- [Event history](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/EventHistory/EventHistory.jsx): `src/pages/EventHistory/EventHistory.jsx`
- [Entry database](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Database/Database.jsx): `src/pages/Database/Database.jsx`

### Administration

- [Settings](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Settings/Settings.jsx): `src/pages/Settings/Settings.jsx`
- [User management](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/UserManagement/UserManagement.jsx): `src/pages/UserManagement/UserManagement.jsx`
- [Role permissions](https://github.com/darkvex-x/digi-moi/blob/main/src/services/permissions.js): `src/services/permissions.js`

### Shared platform

- [App routing](https://github.com/darkvex-x/digi-moi/blob/main/src/App.jsx): `src/App.jsx`
- [Authentication](https://github.com/darkvex-x/digi-moi/blob/main/src/pages/Auth/Login.jsx): `src/pages/Auth/Login.jsx`
- [Permission context](https://github.com/darkvex-x/digi-moi/blob/main/src/context/PermissionContext.jsx): `src/context/PermissionContext.jsx`
- [Event context](https://github.com/darkvex-x/digi-moi/blob/main/src/context/EventContext.jsx): `src/context/EventContext.jsx`
- [Settings context](https://github.com/darkvex-x/digi-moi/blob/main/src/context/SettingsContext.jsx): `src/context/SettingsContext.jsx`
- [UI primitives](https://github.com/darkvex-x/digi-moi/tree/main/src/components/ui): `src/components/ui`

### Data and output

- [Storage service](https://github.com/darkvex-x/digi-moi/blob/main/src/services/storage.js): `src/services/storage.js`
- [Firestore](https://github.com/darkvex-x/digi-moi/blob/main/src/firebase.js): `src/firebase.js`
- [Export service](https://github.com/darkvex-x/digi-moi/blob/main/src/services/export.js): `src/services/export.js`
- [Print preview](https://github.com/darkvex-x/digi-moi/blob/main/src/components/print/PrintPreviewModal.jsx): `src/components/print/PrintPreviewModal.jsx`
- [Thermal receipt](https://github.com/darkvex-x/digi-moi/blob/main/src/components/print/ThermalReceipt.jsx): `src/components/print/ThermalReceipt.jsx`

### Other components

- **User**

## Connections

- User → App routing: uses
- App routing → Authentication: routes to (evidence: `src/App.jsx`)
- App routing → Dashboard: routes to (evidence: `src/App.jsx`)
- App routing → Event creation: routes to (evidence: `src/App.jsx`)
- App routing → Event ledger: routes to (evidence: `src/App.jsx`)
- App routing → Event history: routes to (evidence: `src/App.jsx`)
- App routing → Entry database: routes to (evidence: `src/App.jsx`)
- App routing → Settings: routes to (evidence: `src/App.jsx`)
- App routing → User management: routes to (evidence: `src/App.jsx`)
- App routing → Event context: provides (evidence: `src/App.jsx`)
- App routing → Settings context: provides (evidence: `src/App.jsx`)
- App routing → Permission context: provides (evidence: `src/App.jsx`)
- App routing → UI primitives: uses (evidence: `src/App.jsx`)
- Permission context → Role permissions: gets role rules (evidence: `src/context/PermissionContext.jsx`)
- Permission context → Firestore: reads user role (evidence: `src/context/PermissionContext.jsx`)
- Event context → Storage service: reads events (evidence: `src/context/EventContext.jsx`)
- Settings context → Storage service: loads settings (evidence: `src/context/SettingsContext.jsx`)
- Event ledger → Storage service: reads and writes (evidence: `src/pages/EventView/EventView.jsx`)
- Entry database → Storage service: manages entries (evidence: `src/pages/Database/Database.jsx`)
- Entry database → Export service: exports ledger (evidence: `src/pages/Database/Database.jsx`)
- Entry database → Permission context: checks access (evidence: `src/pages/Database/Database.jsx`)
- Event history → Storage service: loads history (evidence: `src/pages/EventHistory/EventHistory.jsx`)
- Event history → Print preview: opens receipt preview (evidence: `src/pages/EventHistory/EventHistory.jsx`)
- Settings → Storage service: manages settings (evidence: `src/pages/Settings/Settings.jsx`)
- Settings → Permission context: checks access (evidence: `src/pages/Settings/Settings.jsx`)
- User management → Storage service: manages users (evidence: `src/pages/UserManagement/UserManagement.jsx`)
- User management → Permission context: checks access (evidence: `src/pages/UserManagement/UserManagement.jsx`)
- Storage service → Firestore: reads and writes (evidence: `src/services/storage.js`)
- Print preview → Storage service: loads settings (evidence: `src/components/print/PrintPreviewModal.jsx`)
- Print preview → Thermal receipt: renders (evidence: `src/components/print/PrintPreviewModal.jsx`)
- Print preview → UI primitives: uses modal and buttons (evidence: `src/components/print/PrintPreviewModal.jsx`)
