# siva-ganesh-vr/letskonnect_app_og architecture

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

- Interactive diagram: https://gitdiagram.com/siva-ganesh-vr/letskonnect_app_og
- Repository: https://github.com/siva-ganesh-vr/letskonnect_app_og

## Overview

LetsKonnect is an event lead-capture and networking platform. Visitors register for events and receive digital QR passes; stall owners scan those passes to capture leads, while organizers and super admins manage events, participants, and reporting. The README also documents OTP, exports, analytics, lucky draws, feedback, messaging, and live lead updates. Routes and sampled scan code show key entry points and lead creation; several broader subsystem links rely on README descriptions because their implementations were not sampled.

Main entry points: [`app/controllers/api/v1/stall_owner/scans_controller.rb`](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/stall_owner/scans_controller.rb) (QR Scanning), [`app/controllers/api/v1/stall_owner/leads_controller.rb`](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/stall_owner/leads_controller.rb) (Lead Management), [`app/controllers/api/v1/auth/visitors_controller.rb`](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/auth/visitors_controller.rb) (Visitor Registration), [`app/jobs`](https://github.com/siva-ganesh-vr/letskonnect_app_og/tree/master/app/jobs) (Background Jobs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_registration["Registration &amp; Passes"]
  node_visitorreg["Visitor Registration"]
  node_otp["OTP Verification"]
  node_regpage["Registration Page"]
  node_qrpass["QR Passes<br/>[qr_service.rb]"]
end

subgraph group_engagement["Lead Capture"]
  node_scan["QR Scanning"]
  node_leads["Lead Management"]
  node_leadmodel[("Lead Records<br/>[lead.rb]")]
  node_liveleads["Live Lead Updates<br/>[leads_channel.rb]"]
end

subgraph group_management["Event Management"]
  node_organizerapi["Organizer API"]
  node_stalladmin["Stall Administration"]
  node_adminapi["Super Admin API"]
  node_draw["Lucky Draw"]
  node_analytics["Analytics"]
  node_exports["Data Exports"]
end

subgraph group_platform["Platform Services"]
  node_messaging["Messaging"]
  node_feedback["Event Feedback"]
  node_logs[("Error Logging<br/>[error_log.rb]")]
  node_jobs["Background Jobs"]
  node_models[("Domain Models")]
  node_appconfig["Rails Runtime<br/>[application.rb]"]
end

node_visitor(("Visitor"))
node_stallowner(("Stall Owner"))
node_organizer(("Organizer"))
node_admin(("Super Admin"))

node_visitor -->|"opens registration"| node_regpage
node_regpage -->|"registers via"| node_visitorreg
node_visitor -->|"submits registration"| node_visitorreg
node_visitorreg -.->|"verifies OTP"| node_otp
node_visitor -->|"views pass"| node_qrpass
node_stallowner -->|"scans pass"| node_scan
node_scan -->|"finds visitor"| node_models
node_scan -->|"creates lead"| node_leadmodel
node_stallowner -->|"manages leads"| node_leads
node_leads -.->|"reads and updates"| node_leadmodel
node_leads -.->|"updates live"| node_liveleads
node_organizer -->|"manages events"| node_organizerapi
node_organizer -->|"manages stalls"| node_stalladmin
node_admin -->|"manages platform"| node_adminapi
node_organizer -->|"runs draws"| node_draw
node_organizerapi -.->|"views analytics"| node_analytics
node_organizer -->|"exports event data"| node_exports
node_stallowner -->|"exports leads"| node_exports
node_visitor -->|"submits feedback"| node_feedback
node_messaging -.->|"sent asynchronously"| node_jobs
node_appconfig -->|"uses Sidekiq"| node_jobs
node_appconfig -->|"mounts Action Cable"| node_liveleads
node_scan -->|"queues notifications"| node_jobs
node_admin -->|"reviews error logs"| node_logs

click node_visitorreg "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/auth/visitors_controller.rb"
click node_otp "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/models/otp_verification.rb"
click node_regpage "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/registrations_controller.rb"
click node_qrpass "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/qr_service.rb"
click node_scan "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/stall_owner/scans_controller.rb"
click node_leads "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/stall_owner/leads_controller.rb"
click node_leadmodel "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/models/lead.rb"
click node_liveleads "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/channels/leads_channel.rb"
click node_organizerapi "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/organizer/events_controller.rb"
click node_stalladmin "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/organizer/stall_owners_controller.rb"
click node_adminapi "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/super_admin/events_controller.rb"
click node_draw "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/organizer/lucky_draw_results_controller.rb"
click node_analytics "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/analytics_service.rb"
click node_exports "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/leads_export_service.rb"
click node_messaging "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/whatsapp_service.rb"
click node_feedback "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/feedback_controller.rb"
click node_logs "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/models/error_log.rb"
click node_jobs "https://github.com/siva-ganesh-vr/letskonnect_app_og/tree/master/app/jobs"
click node_models "https://github.com/siva-ganesh-vr/letskonnect_app_og/tree/master/app/models"
click node_appconfig "https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/config/application.rb"

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_visitorreg,node_otp,node_regpage,node_qrpass toneBlue
class node_scan,node_leads,node_leadmodel,node_liveleads toneAmber
class node_organizerapi,node_stalladmin,node_adminapi,node_draw,node_analytics,node_exports toneMint
class node_messaging,node_feedback,node_logs,node_jobs,node_models,node_appconfig toneRose
class node_visitor,node_stallowner,node_organizer,node_admin toneIndigo
```

## Components

### Registration & Passes

- [Visitor Registration](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/auth/visitors_controller.rb): `app/controllers/api/v1/auth/visitors_controller.rb`
- [OTP Verification](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/models/otp_verification.rb): `app/models/otp_verification.rb`
- [Registration Page](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/registrations_controller.rb): `app/controllers/registrations_controller.rb`
- [QR Passes](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/qr_service.rb): `app/services/qr_service.rb`

### Lead Capture

- [QR Scanning](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/stall_owner/scans_controller.rb): `app/controllers/api/v1/stall_owner/scans_controller.rb`
- [Lead Management](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/stall_owner/leads_controller.rb): `app/controllers/api/v1/stall_owner/leads_controller.rb`
- [Lead Records](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/models/lead.rb): `app/models/lead.rb`
- [Live Lead Updates](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/channels/leads_channel.rb): `app/channels/leads_channel.rb`

### Event Management

- [Organizer API](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/organizer/events_controller.rb): `app/controllers/api/v1/organizer/events_controller.rb`
- [Stall Administration](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/organizer/stall_owners_controller.rb): `app/controllers/api/v1/organizer/stall_owners_controller.rb`
- [Super Admin API](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/super_admin/events_controller.rb): `app/controllers/api/v1/super_admin/events_controller.rb`
- [Lucky Draw](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/api/v1/organizer/lucky_draw_results_controller.rb): `app/controllers/api/v1/organizer/lucky_draw_results_controller.rb`
- [Analytics](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/analytics_service.rb): `app/services/analytics_service.rb`
- [Data Exports](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/leads_export_service.rb): `app/services/leads_export_service.rb`

### Platform Services

- [Messaging](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/services/whatsapp_service.rb): `app/services/whatsapp_service.rb`
- [Event Feedback](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/controllers/feedback_controller.rb): `app/controllers/feedback_controller.rb`
- [Error Logging](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/app/models/error_log.rb): `app/models/error_log.rb`
- [Background Jobs](https://github.com/siva-ganesh-vr/letskonnect_app_og/tree/master/app/jobs): `app/jobs`
- [Domain Models](https://github.com/siva-ganesh-vr/letskonnect_app_og/tree/master/app/models): `app/models`
- [Rails Runtime](https://github.com/siva-ganesh-vr/letskonnect_app_og/blob/master/config/application.rb): `config/application.rb`

### Other components

- **Visitor**
- **Stall Owner**
- **Organizer**
- **Super Admin**

## Connections

- Visitor → Registration Page: opens registration
- Registration Page → Visitor Registration: registers via
- Visitor → Visitor Registration: submits registration
- Visitor Registration → OTP Verification: verifies OTP
- Visitor → QR Passes: views pass
- Stall Owner → QR Scanning: scans pass
- QR Scanning → Domain Models: finds visitor (evidence: `app/controllers/api/v1/stall_owner/scans_controller.rb`)
- QR Scanning → Lead Records: creates lead (evidence: `app/controllers/api/v1/stall_owner/scans_controller.rb`)
- Stall Owner → Lead Management: manages leads
- Lead Management → Lead Records: reads and updates
- Lead Management → Live Lead Updates: updates live
- Organizer → Organizer API: manages events
- Organizer → Stall Administration: manages stalls
- Super Admin → Super Admin API: manages platform
- Organizer → Lucky Draw: runs draws
- Organizer API → Analytics: views analytics
- Organizer → Data Exports: exports event data
- Stall Owner → Data Exports: exports leads
- Visitor → Event Feedback: submits feedback
- Messaging → Background Jobs: sent asynchronously
- Rails Runtime → Background Jobs: uses Sidekiq (evidence: `config/application.rb`)
- Rails Runtime → Live Lead Updates: mounts Action Cable
- QR Scanning → Background Jobs: queues notifications (evidence: `app/controllers/api/v1/stall_owner/scans_controller.rb`)
- Super Admin → Error Logging: reviews error logs
