# mohan095/karpagam-traders-sivakasi- architecture

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

- Interactive diagram: https://gitdiagram.com/mohan095/karpagam-traders-sivakasi-
- Repository: https://github.com/mohan095/karpagam-traders-sivakasi-

## Overview

This repository contains a FastAPI backend for Karpagam Traders’ corporate admin and customer-inquiry workflows. Customers submit inquiries; the API records them and logs activity, while admin-facing endpoints expose inquiries, statistics, user history, and logs. The sampled main module persists these records to Firestore with in-memory fallbacks. Separate SQLAlchemy models, database setup, and JWT/password utilities indicate an additional relational-admin foundation, but the sampled API does not show those components wired into its routes. No frontend implementation is present in the supplied tree.

Main entry points: [`backend/main.py`](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py) (Inquiry and admin routes), [`backend/database.py`](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/database.py) (SQLAlchemy setup), [`backend/models.py`](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/models.py) (Admin and message models), [`backend/security.py`](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/security.py) (Password and JWT security)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Inquiry API"]
  node_api_routes["Inquiry and admin routes<br/>[main.py]"]
  node_inquiry_records[("Inquiry fallback records<br/>[main.py]")]
  node_activity_logs[("Activity log fallback<br/>[main.py]")]
  node_user_history[("User history fallback<br/>[main.py]")]
end

subgraph group_firestore["Firestore Persistence"]
  node_firestore_helpers["Firestore REST helpers<br/>[main.py]"]
  node_firestore[("Firebase Firestore")]
end

subgraph group_admin["Admin Foundation"]
  node_db_setup["SQLAlchemy setup<br/>[database.py]"]
  node_admin_models[("Admin and message models<br/>[models.py]")]
  node_auth_security["Password and JWT security<br/>[security.py]"]
end

node_customer(("Customer"))
node_admin_user(("Admin user"))

node_customer -->|"submits inquiry"| node_api_routes
node_api_routes -->|"updates fallback"| node_inquiry_records
node_api_routes -->|"updates fallback"| node_activity_logs
node_api_routes -->|"calls"| node_firestore_helpers
node_firestore_helpers -->|"reads and writes"| node_firestore
node_api_routes -->|"reads fallback"| node_user_history
node_api_routes -->|"reads and deletes"| node_inquiry_records
node_api_routes -->|"reads and deletes"| node_activity_logs
node_api_routes -->|"deletes"| node_user_history
node_admin_user -.->|"requests admin data"| node_api_routes
node_db_setup -->|"creates tables"| node_admin_models
node_db_setup -->|"hashes seed password"| node_auth_security

click node_api_routes "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py"
click node_inquiry_records "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py"
click node_activity_logs "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py"
click node_user_history "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py"
click node_firestore_helpers "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py"
click node_db_setup "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/database.py"
click node_admin_models "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/models.py"
click node_auth_security "https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/security.py"

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_api_routes,node_inquiry_records,node_activity_logs,node_user_history,node_admin_user toneBlue
class node_firestore_helpers,node_firestore toneAmber
class node_db_setup,node_admin_models,node_auth_security toneMint
class node_customer toneIndigo
```

## Components

### Inquiry API

- [Inquiry and admin routes](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py): `backend/main.py`
- [Inquiry fallback records](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py): `backend/main.py`
- [Activity log fallback](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py): `backend/main.py`
- [User history fallback](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py): `backend/main.py`

### Firestore Persistence

- [Firestore REST helpers](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/main.py): `backend/main.py`
- **Firebase Firestore**

### Admin Foundation

- [SQLAlchemy setup](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/database.py): `backend/database.py`
- [Admin and message models](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/models.py): `backend/models.py`
- [Password and JWT security](https://github.com/mohan095/karpagam-traders-sivakasi-/blob/main/backend/security.py): `backend/security.py`

### Other components

- **Customer**
- **Admin user**

## Connections

- Customer → Inquiry and admin routes: submits inquiry (evidence: `backend/main.py`)
- Inquiry and admin routes → Inquiry fallback records: updates fallback (evidence: `backend/main.py`)
- Inquiry and admin routes → Activity log fallback: updates fallback (evidence: `backend/main.py`)
- Inquiry and admin routes → Firestore REST helpers: calls (evidence: `backend/main.py`)
- Firestore REST helpers → Firebase Firestore: reads and writes (evidence: `backend/main.py`)
- Inquiry and admin routes → User history fallback: reads fallback (evidence: `backend/main.py`)
- Inquiry and admin routes → Inquiry fallback records: reads and deletes (evidence: `backend/main.py`)
- Inquiry and admin routes → Activity log fallback: reads and deletes (evidence: `backend/main.py`)
- Inquiry and admin routes → User history fallback: deletes (evidence: `backend/main.py`)
- Admin user → Inquiry and admin routes: requests admin data
- SQLAlchemy setup → Admin and message models: creates tables (evidence: `backend/database.py`)
- SQLAlchemy setup → Password and JWT security: hashes seed password (evidence: `backend/database.py`)
