# adityakumarprasad33-cpu/runixwebtech architecture

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

- Interactive diagram: https://gitdiagram.com/adityakumarprasad33-cpu/runixwebtech
- Repository: https://github.com/adityakumarprasad33-cpu/runixwebtech

## Overview

This is a digital-services ordering and project-management platform: customers discover services, create and pay for orders, then track delivery and maintenance; developers and administrators manage work and finances. The graph groups public discovery, identity, order/payment, and operations. It includes the documented-by-route capabilities for which the tree provides no further implementation detail. Source excerpts establish several server-side calls; other links are limited to relationships listed in the SOURCE INDEX, so unsampled behavior is not inferred.

Main entry points: [`src/lib/server/firebase-admin.ts`](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/firebase-admin.ts) (Admin Firebase access), [`src/app/api/payments/create-order/route.ts`](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/payments/create-order/route.ts) (Order creation), [`src/app/api/payments/paytm/callback/route.ts`](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/payments/paytm/callback/route.ts) (Paytm callback), [`src/app/api/admin`](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/admin) (Admin operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Service discovery"]
  node_public_site["Public pages"]
  node_service_catalog["Service catalog<br/>[services.ts]"]
  node_project_showcase["Project showcase<br/>[ShowcaseViewer.tsx]"]
  node_project_data["Project data<br/>[projects.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_pages["Login and registration"]
  node_auth_hero["Auth experience<br/>[Hero3DAuth.tsx]"]
  node_auth_hero_context["Auth hero context"]
  node_auth_provider["User and profile state<br/>[AuthContext.tsx]"]
  node_firebase_client["Firebase client<br/>[firebase.ts]"]
  node_auth_api["Auth support routes"]
end

subgraph group_commerce["Orders and payments"]
  node_dashboard["Customer dashboard"]
  node_order_creation["Order creation<br/>[route.ts]"]
  node_pricing["Authoritative pricing<br/>[pricingCatalog.ts]"]
  node_payment_callback["Paytm callback<br/>[route.ts]"]
  node_paytm_checksum["Paytm checksum<br/>[paytmChecksum.ts]"]
  node_order_api["Order payment routes"]
end

subgraph group_operations["Work and administration"]
  node_admin_api["Admin operations"]
  node_developer_api["Developer workflow"]
  node_maintenance_api["Maintenance tasks<br/>[route.ts]"]
  node_finance_panels["Finance panels"]
  node_developer_panel["Developer workspace"]
  node_maintenance_panel["Maintenance desk"]
  node_salary_panel["Salary panel<br/>[PaySalaryPanel.tsx]"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_guard["Permission checks<br/>[authGuard.ts]"]
  node_admin_firebase["Admin Firebase access<br/>[firebase-admin.ts]"]
  node_security_logger["Security audit logging<br/>[securityLogger.ts]"]
  node_client_ip["Trusted client IP<br/>[clientIp.ts]"]
  node_safe_fetch["Safe API fetch<br/>[safeFetch.ts]"]
end

node_visitor(("Customer or visitor"))
node_firebase_store[("Firebase services")]
node_paytm["Paytm"]

node_visitor -->|"browses"| node_public_site
node_public_site -->|"presents"| node_service_catalog
node_project_showcase -->|"loads projects"| node_project_data
node_project_showcase -->|"fetches through"| node_safe_fetch
node_visitor -->|"signs in"| node_auth_pages
node_auth_pages -.->|"renders"| node_auth_hero
node_auth_hero -->|"uses context"| node_auth_hero_context
node_auth_provider -->|"uses client"| node_firebase_client
node_auth_provider -->|"reads profile"| node_firebase_store
node_auth_pages -.->|"checks access"| node_auth_api
node_visitor -->|"uses"| node_dashboard
node_dashboard -.->|"starts checkout"| node_order_creation
node_order_creation -->|"calculates price"| node_pricing
node_order_creation -->|"reads and writes"| node_admin_firebase
node_order_creation -->|"resolves address"| node_client_ip
node_order_creation -->|"records event"| node_security_logger
node_paytm -.->|"sends callback"| node_payment_callback
node_payment_callback -->|"verifies signature"| node_paytm_checksum
node_payment_callback -->|"updates order"| node_admin_firebase
node_payment_callback -->|"records event"| node_security_logger
node_payment_callback -.->|"resolves address"| node_client_ip
node_order_api -.->|"handles payment data"| node_admin_firebase
node_admin_dashboard -.->|"manages platform"| node_admin_api
node_admin_api -->|"checks permissions"| node_admin_guard
node_admin_api -->|"reads and writes"| node_admin_firebase
node_admin_api -->|"records actions"| node_security_logger
node_admin_guard -->|"verifies identity"| node_admin_firebase
node_security_logger -->|"writes audit logs"| node_admin_firebase
node_maintenance_api -->|"checks permissions"| node_admin_guard
node_maintenance_api -->|"updates tasks"| node_admin_firebase
node_maintenance_api -->|"records actions"| node_security_logger
node_developer_api -.->|"checks permissions"| node_admin_guard
node_developer_api -.->|"manages work"| node_admin_firebase
node_finance_panels -->|"calls API through"| node_safe_fetch
node_developer_panel -.->|"manages assignments"| node_developer_api
node_maintenance_panel -.->|"manages tasks"| node_maintenance_api
node_salary_panel -.->|"manages payroll"| node_admin_api

click node_public_site "https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app"
click node_service_catalog "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/data/services.ts"
click node_project_showcase "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/showcase/ShowcaseViewer.tsx"
click node_project_data "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/data/projects.ts"
click node_auth_pages "https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/(auth)"
click node_auth_hero "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/auth/Hero3DAuth.tsx"
click node_auth_hero_context "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/auth/AuthHeroContext.tsx"
click node_auth_provider "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/contexts/AuthContext.tsx"
click node_firebase_client "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/firebase.ts"
click node_auth_api "https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/auth"
click node_dashboard "https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/dashboard"
click node_order_creation "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/payments/create-order/route.ts"
click node_pricing "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/pricingCatalog.ts"
click node_payment_callback "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/payments/paytm/callback/route.ts"
click node_paytm_checksum "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/paytmChecksum.ts"
click node_order_api "https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/orders"
click node_admin_api "https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/admin"
click node_developer_api "https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/developer/orders"
click node_maintenance_api "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/maintenance/tasks/route.ts"
click node_finance_panels "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/FinancialLedgerPanel.tsx"
click node_developer_panel "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/DeveloperInteractionRoom.tsx"
click node_maintenance_panel "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/MaintenanceDesk.tsx"
click node_salary_panel "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/PaySalaryPanel.tsx"
click node_admin_dashboard "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/dashboard/admin/page.tsx"
click node_admin_guard "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/authGuard.ts"
click node_admin_firebase "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/firebase-admin.ts"
click node_security_logger "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/securityLogger.ts"
click node_client_ip "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/clientIp.ts"
click node_safe_fetch "https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/safeFetch.ts"

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_public_site,node_service_catalog,node_project_showcase,node_project_data toneBlue
class node_auth_pages,node_auth_hero,node_auth_hero_context,node_auth_provider,node_firebase_client,node_auth_api,node_firebase_store toneAmber
class node_dashboard,node_order_creation,node_pricing,node_payment_callback,node_paytm_checksum,node_order_api toneMint
class node_admin_api,node_developer_api,node_maintenance_api,node_finance_panels,node_developer_panel,node_maintenance_panel,node_salary_panel,node_admin_dashboard,node_admin_guard,node_admin_firebase,node_security_logger,node_client_ip,node_safe_fetch toneRose
class node_visitor,node_paytm toneIndigo
```

## Components

### Service discovery

- [Public pages](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app): `src/app`
- [Service catalog](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/data/services.ts): `src/data/services.ts`
- [Project showcase](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/showcase/ShowcaseViewer.tsx): `src/components/showcase/ShowcaseViewer.tsx`
- [Project data](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/data/projects.ts): `src/data/projects.ts`

### Identity and access

- [Login and registration](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/(auth)): `src/app/(auth)`
- [Auth experience](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/auth/Hero3DAuth.tsx): `src/components/auth/Hero3DAuth.tsx`
- [Auth hero context](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/auth/AuthHeroContext.tsx): `src/components/auth/AuthHeroContext.tsx`
- [User and profile state](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Firebase client](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/firebase.ts): `src/lib/firebase.ts`
- [Auth support routes](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/auth): `src/app/api/auth`

### Orders and payments

- [Customer dashboard](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/dashboard): `src/app/dashboard`
- [Order creation](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/payments/create-order/route.ts): `src/app/api/payments/create-order/route.ts`
- [Authoritative pricing](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/pricingCatalog.ts): `src/lib/server/pricingCatalog.ts`
- [Paytm callback](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/payments/paytm/callback/route.ts): `src/app/api/payments/paytm/callback/route.ts`
- [Paytm checksum](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/paytmChecksum.ts): `src/lib/paytmChecksum.ts`
- [Order payment routes](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/orders): `src/app/api/orders`

### Work and administration

- [Admin operations](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/admin): `src/app/api/admin`
- [Developer workflow](https://github.com/adityakumarprasad33-cpu/runixwebtech/tree/master/src/app/api/developer/orders): `src/app/api/developer/orders`
- [Maintenance tasks](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/api/maintenance/tasks/route.ts): `src/app/api/maintenance/tasks/route.ts`
- [Finance panels](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/FinancialLedgerPanel.tsx): `src/components/dashboard/FinancialLedgerPanel.tsx`
- [Developer workspace](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/DeveloperInteractionRoom.tsx): `src/components/dashboard/DeveloperInteractionRoom.tsx`
- [Maintenance desk](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/MaintenanceDesk.tsx): `src/components/dashboard/MaintenanceDesk.tsx`
- [Salary panel](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/components/dashboard/PaySalaryPanel.tsx): `src/components/dashboard/PaySalaryPanel.tsx`
- [Admin dashboard](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/app/dashboard/admin/page.tsx): `src/app/dashboard/admin/page.tsx`
- [Permission checks](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/authGuard.ts): `src/lib/server/authGuard.ts`
- [Admin Firebase access](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/firebase-admin.ts): `src/lib/server/firebase-admin.ts`
- [Security audit logging](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/securityLogger.ts): `src/lib/server/securityLogger.ts`
- [Trusted client IP](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/server/clientIp.ts): `src/lib/server/clientIp.ts`
- [Safe API fetch](https://github.com/adityakumarprasad33-cpu/runixwebtech/blob/master/src/lib/safeFetch.ts): `src/lib/safeFetch.ts`

### Other components

- **Customer or visitor**
- **Firebase services**
- **Paytm**

## Connections

- Customer or visitor → Public pages: browses
- Public pages → Service catalog: presents
- Project showcase → Project data: loads projects (evidence: `src/components/showcase/ShowcaseViewer.tsx`)
- Project showcase → Safe API fetch: fetches through (evidence: `src/components/showcase/ShowcaseViewer.tsx`)
- Customer or visitor → Login and registration: signs in
- Login and registration → Auth experience: renders
- Auth experience → Auth hero context: uses context (evidence: `src/components/auth/Hero3DAuth.tsx`)
- User and profile state → Firebase client: uses client (evidence: `src/contexts/AuthContext.tsx`)
- User and profile state → Firebase services: reads profile (evidence: `src/contexts/AuthContext.tsx`)
- Login and registration → Auth support routes: checks access
- Customer or visitor → Customer dashboard: uses
- Customer dashboard → Order creation: starts checkout
- Order creation → Authoritative pricing: calculates price (evidence: `src/app/api/payments/create-order/route.ts`)
- Order creation → Admin Firebase access: reads and writes (evidence: `src/app/api/payments/create-order/route.ts`)
- Order creation → Trusted client IP: resolves address (evidence: `src/app/api/payments/create-order/route.ts`)
- Order creation → Security audit logging: records event (evidence: `src/app/api/payments/create-order/route.ts`)
- Paytm → Paytm callback: sends callback
- Paytm callback → Paytm checksum: verifies signature (evidence: `src/app/api/payments/paytm/callback/route.ts`)
- Paytm callback → Admin Firebase access: updates order (evidence: `src/app/api/payments/paytm/callback/route.ts`)
- Paytm callback → Security audit logging: records event (evidence: `src/app/api/payments/paytm/callback/route.ts`)
- Paytm callback → Trusted client IP: resolves address (evidence: `src/app/api/payments/paytm/callback/route.ts`)
- Order payment routes → Admin Firebase access: handles payment data (evidence: `src/app/api/orders/submit-utr/route.ts`)
- Admin dashboard → Admin operations: manages platform
- Admin operations → Permission checks: checks permissions (evidence: `src/app/api/admin/salaries/route.ts`)
- Admin operations → Admin Firebase access: reads and writes (evidence: `src/app/api/admin/salaries/route.ts`)
- Admin operations → Security audit logging: records actions (evidence: `src/app/api/admin/salaries/route.ts`)
- Permission checks → Admin Firebase access: verifies identity (evidence: `src/lib/server/authGuard.ts`)
- Security audit logging → Admin Firebase access: writes audit logs (evidence: `src/lib/server/securityLogger.ts`)
- Maintenance tasks → Permission checks: checks permissions (evidence: `src/app/api/maintenance/tasks/route.ts`)
- Maintenance tasks → Admin Firebase access: updates tasks (evidence: `src/app/api/maintenance/tasks/route.ts`)
- Maintenance tasks → Security audit logging: records actions (evidence: `src/app/api/maintenance/tasks/route.ts`)
- Developer workflow → Permission checks: checks permissions
- Developer workflow → Admin Firebase access: manages work
- Finance panels → Safe API fetch: calls API through (evidence: `src/components/dashboard/FinancialLedgerPanel.tsx`)
- Developer workspace → Developer workflow: manages assignments
- Maintenance desk → Maintenance tasks: manages tasks
- Salary panel → Admin operations: manages payroll