# jyothi324/uii architecture

> Architecture diagram of the GitHub repository jyothi324/uii, 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/jyothi324/uii
- Repository: https://github.com/jyothi324/uii

## Overview

This tree contains three independent Go backends: delivery tracking, inventory operations, and lead/job management with billing. The principal workflows are HTTP request routing into domain handlers and persistence; delivery also exposes live tracking, while inventory relays activity over WebSockets and lead management includes AI and subscription billing. Edges are limited to registrations and calls visible in the excerpts; several substantial domain modules are represented without inferred internal call chains.

Main entry points: [`inventory-develop/cmd/main.go`](https://github.com/jyothi324/uii/blob/main/inventory-develop/cmd/main.go) (HTTP server), [`inventory-develop/routes/routes.go`](https://github.com/jyothi324/uii/blob/main/inventory-develop/routes/routes.go) (API routes), [`geo-backend-develop/cmd/main.go`](https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/main.go) (HTTP routes), [`lead-services-develop/routes/routes.go`](https://github.com/jyothi324/uii/blob/main/lead-services-develop/routes/routes.go) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["Delivery tracking"]
  node_delivery_server["HTTP routes<br/>[main.go]"]
  node_delivery_handlers["Task handlers<br/>[handlers.go]"]
  node_delivery_services["Geo services<br/>[services.go]"]
  node_delivery_hub["Realtime hub<br/>[hub.go]"]
end

subgraph group_inventory["Inventory operations"]
  node_inventory_server["HTTP server<br/>[main.go]"]
  node_inventory_routes["API routes<br/>[routes.go]"]
  node_inventory_materials["Materials and chunks"]
  node_inventory_purchases["Purchasing"]
  node_inventory_receiving["Purchase receiving"]
  node_inventory_visualizer["Customer visualizer"]
  node_inventory_audit["Audit activity<br/>[audit_handler.go]"]
  node_inventory_db[("Tenant database<br/>[connection.go]")]
  node_inventory_listener["Activity listener<br/>[listener.go]"]
  node_inventory_ws["Activity WebSockets<br/>[manager.go]"]
end

subgraph group_leads["Lead management"]
  node_lead_server["HTTP server<br/>[main.go]"]
  node_lead_routes["API routes<br/>[routes.go]"]
  node_lead_leads["Lead lifecycle<br/>[lead.handler.go]"]
  node_lead_estimates["Estimates"]
  node_lead_stages["Estimate stages"]
  node_lead_stage_ops["Stage operations<br/>[stage.handler.go]"]
  node_lead_users["User management<br/>[user_handler.go]"]
  node_lead_jobs["Job synchronization<br/>[job_service.go]"]
  node_lead_ai["AI assistance<br/>[gemini_service.go]"]
  node_lead_billing_handler["Billing endpoints<br/>[handler.go]"]
  node_lead_billing_service["Billing and Stripe<br/>[service.go]"]
end

node_delivery_user(("API client"))
node_inventory_user(("API client"))
node_lead_user(("API client"))

node_delivery_user -->|"sends requests"| node_delivery_server
node_delivery_server -->|"routes task requests"| node_delivery_handlers
node_delivery_server -->|"starts hub"| node_delivery_hub
node_delivery_server -->|"routes WebSockets"| node_delivery_hub
node_inventory_user -->|"sends requests"| node_inventory_server
node_inventory_server -->|"registers routes"| node_inventory_routes
node_inventory_routes -->|"routes material requests"| node_inventory_materials
node_inventory_routes -->|"routes purchases"| node_inventory_purchases
node_inventory_routes -->|"routes receipts"| node_inventory_receiving
node_inventory_routes -->|"routes customer requests"| node_inventory_visualizer
node_inventory_server -->|"initializes manager"| node_inventory_db
node_inventory_server -->|"starts listener"| node_inventory_listener
node_inventory_server -->|"serves activity sockets"| node_inventory_ws
node_lead_user -->|"sends requests"| node_lead_server
node_lead_server -->|"registers routes"| node_lead_routes
node_lead_routes -->|"routes lead requests"| node_lead_leads
node_lead_routes -->|"routes job requests"| node_lead_jobs
node_lead_routes -->|"routes AI requests"| node_lead_ai

click node_delivery_server "https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/main.go"
click node_delivery_handlers "https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/handlers.go"
click node_delivery_services "https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/services.go"
click node_delivery_hub "https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/hub.go"
click node_inventory_server "https://github.com/jyothi324/uii/blob/main/inventory-develop/cmd/main.go"
click node_inventory_routes "https://github.com/jyothi324/uii/blob/main/inventory-develop/routes/routes.go"
click node_inventory_materials "https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/material.handler.go"
click node_inventory_purchases "https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/purchase.handler.go"
click node_inventory_receiving "https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/purchaserecived.handler.go"
click node_inventory_visualizer "https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/visualizecustomer.handler.go"
click node_inventory_audit "https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/audit_handler.go"
click node_inventory_db "https://github.com/jyothi324/uii/blob/main/inventory-develop/db/connection.go"
click node_inventory_listener "https://github.com/jyothi324/uii/blob/main/inventory-develop/internal/postgreslistener/listener.go"
click node_inventory_ws "https://github.com/jyothi324/uii/blob/main/inventory-develop/internal/websocket/manager.go"
click node_lead_server "https://github.com/jyothi324/uii/blob/main/lead-services-develop/cmd/main.go"
click node_lead_routes "https://github.com/jyothi324/uii/blob/main/lead-services-develop/routes/routes.go"
click node_lead_leads "https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/lead.handler.go"
click node_lead_estimates "https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/estimate.handler.go"
click node_lead_stages "https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/estimateStages.handler.go"
click node_lead_stage_ops "https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/stage.handler.go"
click node_lead_users "https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/user_handler.go"
click node_lead_jobs "https://github.com/jyothi324/uii/blob/main/lead-services-develop/services/job_service.go"
click node_lead_ai "https://github.com/jyothi324/uii/blob/main/lead-services-develop/services/gemini_service.go"
click node_lead_billing_handler "https://github.com/jyothi324/uii/blob/main/lead-services-develop/billing/handler.go"
click node_lead_billing_service "https://github.com/jyothi324/uii/blob/main/lead-services-develop/billing/service.go"

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_delivery_server,node_delivery_handlers,node_delivery_services,node_delivery_hub,node_delivery_user,node_inventory_user,node_lead_user toneBlue
class node_inventory_server,node_inventory_routes,node_inventory_materials,node_inventory_purchases,node_inventory_receiving,node_inventory_visualizer,node_inventory_audit,node_inventory_db,node_inventory_listener,node_inventory_ws toneAmber
class node_lead_server,node_lead_routes,node_lead_leads,node_lead_estimates,node_lead_stages,node_lead_stage_ops,node_lead_users,node_lead_jobs,node_lead_ai,node_lead_billing_handler,node_lead_billing_service toneMint
```

## Components

### Delivery tracking

- [HTTP routes](https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/main.go): `geo-backend-develop/cmd/main.go`
- [Task handlers](https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/handlers.go): `geo-backend-develop/cmd/handlers.go`
- [Geo services](https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/services.go): `geo-backend-develop/cmd/services.go`
- [Realtime hub](https://github.com/jyothi324/uii/blob/main/geo-backend-develop/cmd/hub.go): `geo-backend-develop/cmd/hub.go`

### Inventory operations

- [HTTP server](https://github.com/jyothi324/uii/blob/main/inventory-develop/cmd/main.go): `inventory-develop/cmd/main.go`
- [API routes](https://github.com/jyothi324/uii/blob/main/inventory-develop/routes/routes.go): `inventory-develop/routes/routes.go`
- [Materials and chunks](https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/material.handler.go): `inventory-develop/handlers/material.handler.go`
- [Purchasing](https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/purchase.handler.go): `inventory-develop/handlers/purchase.handler.go`
- [Purchase receiving](https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/purchaserecived.handler.go): `inventory-develop/handlers/purchaserecived.handler.go`
- [Customer visualizer](https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/visualizecustomer.handler.go): `inventory-develop/handlers/visualizecustomer.handler.go`
- [Audit activity](https://github.com/jyothi324/uii/blob/main/inventory-develop/handlers/audit_handler.go): `inventory-develop/handlers/audit_handler.go`
- [Tenant database](https://github.com/jyothi324/uii/blob/main/inventory-develop/db/connection.go): `inventory-develop/db/connection.go`
- [Activity listener](https://github.com/jyothi324/uii/blob/main/inventory-develop/internal/postgreslistener/listener.go): `inventory-develop/internal/postgreslistener/listener.go`
- [Activity WebSockets](https://github.com/jyothi324/uii/blob/main/inventory-develop/internal/websocket/manager.go): `inventory-develop/internal/websocket/manager.go`

### Lead management

- [HTTP server](https://github.com/jyothi324/uii/blob/main/lead-services-develop/cmd/main.go): `lead-services-develop/cmd/main.go`
- [API routes](https://github.com/jyothi324/uii/blob/main/lead-services-develop/routes/routes.go): `lead-services-develop/routes/routes.go`
- [Lead lifecycle](https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/lead.handler.go): `lead-services-develop/handlers/lead.handler.go`
- [Estimates](https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/estimate.handler.go): `lead-services-develop/handlers/estimate.handler.go`
- [Estimate stages](https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/estimateStages.handler.go): `lead-services-develop/handlers/estimateStages.handler.go`
- [Stage operations](https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/stage.handler.go): `lead-services-develop/handlers/stage.handler.go`
- [User management](https://github.com/jyothi324/uii/blob/main/lead-services-develop/handlers/user_handler.go): `lead-services-develop/handlers/user_handler.go`
- [Job synchronization](https://github.com/jyothi324/uii/blob/main/lead-services-develop/services/job_service.go): `lead-services-develop/services/job_service.go`
- [AI assistance](https://github.com/jyothi324/uii/blob/main/lead-services-develop/services/gemini_service.go): `lead-services-develop/services/gemini_service.go`
- [Billing endpoints](https://github.com/jyothi324/uii/blob/main/lead-services-develop/billing/handler.go): `lead-services-develop/billing/handler.go`
- [Billing and Stripe](https://github.com/jyothi324/uii/blob/main/lead-services-develop/billing/service.go): `lead-services-develop/billing/service.go`

### Other components

- **API client**
- **API client**
- **API client**

## Connections

- API client → HTTP routes: sends requests (evidence: `geo-backend-develop/cmd/main.go`)
- HTTP routes → Task handlers: routes task requests (evidence: `geo-backend-develop/cmd/main.go`)
- HTTP routes → Realtime hub: starts hub (evidence: `geo-backend-develop/cmd/main.go`)
- HTTP routes → Realtime hub: routes WebSockets (evidence: `geo-backend-develop/cmd/main.go`)
- API client → HTTP server: sends requests (evidence: `inventory-develop/cmd/main.go`)
- HTTP server → API routes: registers routes (evidence: `inventory-develop/cmd/main.go`)
- API routes → Materials and chunks: routes material requests (evidence: `inventory-develop/routes/routes.go`)
- API routes → Purchasing: routes purchases (evidence: `inventory-develop/routes/routes.go`)
- API routes → Purchase receiving: routes receipts (evidence: `inventory-develop/routes/routes.go`)
- API routes → Customer visualizer: routes customer requests (evidence: `inventory-develop/routes/routes.go`)
- HTTP server → Tenant database: initializes manager (evidence: `inventory-develop/cmd/main.go`)
- HTTP server → Activity listener: starts listener (evidence: `inventory-develop/cmd/main.go`)
- HTTP server → Activity WebSockets: serves activity sockets (evidence: `inventory-develop/cmd/main.go`)
- API client → HTTP server: sends requests (evidence: `lead-services-develop/cmd/main.go`)
- HTTP server → API routes: registers routes (evidence: `lead-services-develop/cmd/main.go`)
- API routes → Lead lifecycle: routes lead requests (evidence: `lead-services-develop/routes/routes.go`)
- API routes → Job synchronization: routes job requests (evidence: `lead-services-develop/routes/routes.go`)
- API routes → AI assistance: routes AI requests (evidence: `lead-services-develop/routes/routes.go`)
