# vijaykarthick04/project1 architecture

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

- Interactive diagram: https://gitdiagram.com/vijaykarthick04/project1
- Repository: https://github.com/vijaykarthick04/project1

## Overview

This is a procurement-management application for employees and finance teams, with vendor-facing registration and assessment workflows. The principal flow is creating and approving a purchase requisition, converting it into a purchase order, and managing vendor documents and performance. The frontend routes users to workflow pages and service clients; a Flask API dispatches requests to domain routes backed by shared relational models. The graph also preserves dashboard, master-data, notification, and finance-document capabilities. Several subsystem implementations were not excerpted, so their presence and wiring are based on the source index and app routing; inferred HTTP integration is dashed.

Main entry points: [`finance-procurement-main/backend/app.py`](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/app.py) (Flask API and routing), [`finance-procurement-main/frontend/src/App.tsx`](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/App.tsx) (Web app router), [`finance-procurement-main/backend/models.py`](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/models.py) (Procurement data models), [`finance-procurement-main/backend/utils/notification_service.py`](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/utils/notification_service.py) (Notification service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web_app["Web app router<br/>[App.tsx]"]
  node_auth_context["Authentication context<br/>[AuthContext.tsx]"]
  node_pr_ui["Requisition pages"]
  node_create_pr_ui["Create requisition<br/>[CreatePR.tsx]"]
  node_po_ui["Purchase order pages<br/>[PurchaseOrders.tsx]"]
  node_vendor_ui["Vendor pages<br/>[Vendors.tsx]"]
  node_finance_docs_ui["Finance documents"]
  node_api_client["HTTP API client<br/>[api.ts]"]
  node_pr_service["Requisition service<br/>[PRService.ts]"]
  node_vendor_service["Vendor service<br/>[VendorService.ts]"]
end

subgraph group_api["API and access"]
  node_flask_app["Flask API and routing<br/>[app.py]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
end

subgraph group_procurement["Procurement workflows"]
  node_pr_routes["Requisition workflow<br/>[pr.py]"]
  node_po_routes["Purchase order workflow<br/>[po.py]"]
  node_assessment["Vendor assessment<br/>[assessment.py]"]
end

subgraph group_vendor_finance["Vendors and finance"]
  node_vendor_routes["Vendor management<br/>[vendors.py]"]
  node_finance_docs["Finance document handling"]
  node_storage_service["Document object storage<br/>[storage_service.py]"]
end

subgraph group_shared["Shared services"]
  node_master_data["Master data<br/>[master_data.py]"]
  node_dashboard["Dashboard data<br/>[dashboard.py]"]
  node_notifications["Notification routes<br/>[notifications.py]"]
  node_notify_service["Notification service"]
  node_email_service["Email delivery<br/>[email_service.py]"]
  node_domain_models[("Procurement data models<br/>[models.py]")]
end

node_employee(("Employee / finance user"))
node_vendor_actor(("Vendor"))

node_employee -->|"uses"| node_web_app
node_vendor_actor -->|"uses registration"| node_web_app
node_web_app -->|"provides auth"| node_auth_context
node_web_app -->|"routes to"| node_pr_ui
node_web_app -->|"routes to"| node_create_pr_ui
node_web_app -->|"routes to"| node_po_ui
node_web_app -->|"routes to"| node_vendor_ui
node_web_app -->|"routes to"| node_finance_docs_ui
node_auth_context -->|"requests identity"| node_api_client
node_create_pr_ui -->|"submits through"| node_pr_service
node_pr_ui -->|"loads through"| node_pr_service
node_vendor_ui -->|"loads through"| node_vendor_service
node_pr_service -->|"sends requests"| node_api_client
node_vendor_service -->|"sends requests"| node_api_client
node_api_client -.->|"calls API"| node_flask_app
node_flask_app -->|"registers"| node_auth_routes
node_flask_app -->|"registers"| node_vendor_routes
node_flask_app -->|"registers"| node_pr_routes
node_flask_app -->|"registers"| node_po_routes
node_flask_app -->|"registers"| node_assessment
node_flask_app -->|"registers"| node_finance_docs
node_flask_app -->|"registers"| node_master_data
node_flask_app -->|"registers"| node_dashboard
node_flask_app -->|"registers"| node_notifications
node_auth_routes -->|"queries users"| node_domain_models
node_pr_routes -->|"reads and writes"| node_domain_models
node_po_routes -->|"reads and writes"| node_domain_models
node_vendor_routes -->|"reads and writes"| node_domain_models
node_finance_docs -->|"reads and writes"| node_domain_models
node_assessment -->|"reads and writes"| node_domain_models
node_master_data -->|"uses models"| node_domain_models
node_dashboard -->|"queries"| node_domain_models
node_notifications -->|"queries"| node_domain_models
node_finance_docs -->|"stores files"| node_storage_service
node_pr_routes -->|"notifies users"| node_notify_service
node_po_routes -->|"notifies users"| node_notify_service
node_vendor_routes -->|"notifies users"| node_notify_service
node_auth_routes -->|"sends reset email"| node_notify_service
node_notify_service -->|"sends email"| node_email_service

click node_web_app "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/App.tsx"
click node_auth_context "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/context/AuthContext.tsx"
click node_pr_ui "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/PurchaseRequisitions.tsx"
click node_create_pr_ui "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/CreatePR.tsx"
click node_po_ui "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/PurchaseOrders.tsx"
click node_vendor_ui "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/Vendors.tsx"
click node_finance_docs_ui "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/FinanceDocuments.tsx"
click node_api_client "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/utils/api.ts"
click node_pr_service "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/services/PRService.ts"
click node_vendor_service "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/services/VendorService.ts"
click node_flask_app "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/app.py"
click node_auth_routes "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/auth.py"
click node_pr_routes "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/pr.py"
click node_po_routes "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/po.py"
click node_assessment "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/assessment.py"
click node_vendor_routes "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/vendors.py"
click node_finance_docs "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/finance_documents.py"
click node_master_data "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/master_data.py"
click node_dashboard "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/dashboard.py"
click node_notifications "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/notifications.py"
click node_notify_service "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/utils/notification_service.py"
click node_email_service "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/utils/email_service.py"
click node_storage_service "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/utils/storage_service.py"
click node_domain_models "https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/models.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_web_app,node_auth_context,node_pr_ui,node_create_pr_ui,node_po_ui,node_vendor_ui,node_finance_docs_ui,node_api_client,node_pr_service,node_vendor_service,node_employee toneBlue
class node_flask_app,node_auth_routes toneAmber
class node_pr_routes,node_po_routes,node_assessment toneMint
class node_vendor_routes,node_finance_docs,node_storage_service toneRose
class node_master_data,node_dashboard,node_notifications,node_notify_service,node_email_service,node_domain_models,node_vendor_actor toneIndigo
```

## Components

### Web application

- [Web app router](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/App.tsx): `finance-procurement-main/frontend/src/App.tsx`
- [Authentication context](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/context/AuthContext.tsx): `finance-procurement-main/frontend/src/context/AuthContext.tsx`
- [Requisition pages](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/PurchaseRequisitions.tsx): `finance-procurement-main/frontend/src/pages/PurchaseRequisitions.tsx`
- [Create requisition](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/CreatePR.tsx): `finance-procurement-main/frontend/src/pages/CreatePR.tsx`
- [Purchase order pages](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/PurchaseOrders.tsx): `finance-procurement-main/frontend/src/pages/PurchaseOrders.tsx`
- [Vendor pages](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/Vendors.tsx): `finance-procurement-main/frontend/src/pages/Vendors.tsx`
- [Finance documents](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/pages/FinanceDocuments.tsx): `finance-procurement-main/frontend/src/pages/FinanceDocuments.tsx`
- [HTTP API client](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/utils/api.ts): `finance-procurement-main/frontend/src/utils/api.ts`
- [Requisition service](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/services/PRService.ts): `finance-procurement-main/frontend/src/services/PRService.ts`
- [Vendor service](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/frontend/src/services/VendorService.ts): `finance-procurement-main/frontend/src/services/VendorService.ts`

### API and access

- [Flask API and routing](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/app.py): `finance-procurement-main/backend/app.py`
- [Authentication routes](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/auth.py): `finance-procurement-main/backend/routes/auth.py`

### Procurement workflows

- [Requisition workflow](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/pr.py): `finance-procurement-main/backend/routes/pr.py`
- [Purchase order workflow](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/po.py): `finance-procurement-main/backend/routes/po.py`
- [Vendor assessment](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/assessment.py): `finance-procurement-main/backend/routes/assessment.py`

### Vendors and finance

- [Vendor management](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/vendors.py): `finance-procurement-main/backend/routes/vendors.py`
- [Finance document handling](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/finance_documents.py): `finance-procurement-main/backend/routes/finance_documents.py`
- [Document object storage](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/utils/storage_service.py): `finance-procurement-main/backend/utils/storage_service.py`

### Shared services

- [Master data](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/master_data.py): `finance-procurement-main/backend/routes/master_data.py`
- [Dashboard data](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/dashboard.py): `finance-procurement-main/backend/routes/dashboard.py`
- [Notification routes](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/routes/notifications.py): `finance-procurement-main/backend/routes/notifications.py`
- [Notification service](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/utils/notification_service.py): `finance-procurement-main/backend/utils/notification_service.py`
- [Email delivery](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/utils/email_service.py): `finance-procurement-main/backend/utils/email_service.py`
- [Procurement data models](https://github.com/vijaykarthick04/project1/blob/main/finance-procurement-main/backend/models.py): `finance-procurement-main/backend/models.py`

### Other components

- **Employee / finance user**
- **Vendor**

## Connections

- Employee / finance user → Web app router: uses (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Vendor → Web app router: uses registration (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Web app router → Authentication context: provides auth (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Web app router → Requisition pages: routes to (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Web app router → Create requisition: routes to (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Web app router → Purchase order pages: routes to (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Web app router → Vendor pages: routes to (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Web app router → Finance documents: routes to (evidence: `finance-procurement-main/frontend/src/App.tsx`)
- Authentication context → HTTP API client: requests identity (evidence: `finance-procurement-main/frontend/src/context/AuthContext.tsx`)
- Create requisition → Requisition service: submits through (evidence: `finance-procurement-main/frontend/src/services/PRService.ts`)
- Requisition pages → Requisition service: loads through (evidence: `finance-procurement-main/frontend/src/pages/PurchaseRequisitions.tsx`)
- Vendor pages → Vendor service: loads through (evidence: `finance-procurement-main/frontend/src/pages/Vendors.tsx`)
- Requisition service → HTTP API client: sends requests (evidence: `finance-procurement-main/frontend/src/services/PRService.ts`)
- Vendor service → HTTP API client: sends requests (evidence: `finance-procurement-main/frontend/src/services/VendorService.ts`)
- HTTP API client → Flask API and routing: calls API
- Flask API and routing → Authentication routes: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Vendor management: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Requisition workflow: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Purchase order workflow: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Vendor assessment: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Finance document handling: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Master data: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Dashboard data: registers (evidence: `finance-procurement-main/backend/app.py`)
- Flask API and routing → Notification routes: registers (evidence: `finance-procurement-main/backend/app.py`)
- Authentication routes → Procurement data models: queries users (evidence: `finance-procurement-main/backend/routes/auth.py`)
- Requisition workflow → Procurement data models: reads and writes (evidence: `finance-procurement-main/backend/routes/pr.py`)
- Purchase order workflow → Procurement data models: reads and writes (evidence: `finance-procurement-main/backend/routes/po.py`)
- Vendor management → Procurement data models: reads and writes (evidence: `finance-procurement-main/backend/routes/vendors.py`)
- Finance document handling → Procurement data models: reads and writes (evidence: `finance-procurement-main/backend/routes/finance_documents.py`)
- Vendor assessment → Procurement data models: reads and writes (evidence: `finance-procurement-main/backend/routes/assessment.py`)
- Master data → Procurement data models: uses models (evidence: `finance-procurement-main/backend/routes/master_data.py`)
- Dashboard data → Procurement data models: queries (evidence: `finance-procurement-main/backend/routes/dashboard.py`)
- Notification routes → Procurement data models: queries (evidence: `finance-procurement-main/backend/routes/notifications.py`)
- Finance document handling → Document object storage: stores files (evidence: `finance-procurement-main/backend/routes/finance_documents.py`)
- Requisition workflow → Notification service: notifies users (evidence: `finance-procurement-main/backend/routes/pr.py`)
- Purchase order workflow → Notification service: notifies users (evidence: `finance-procurement-main/backend/routes/po.py`)
- Vendor management → Notification service: notifies users (evidence: `finance-procurement-main/backend/routes/vendors.py`)
- Authentication routes → Notification service: sends reset email (evidence: `finance-procurement-main/backend/routes/auth.py`)
- Notification service → Email delivery: sends email (evidence: `finance-procurement-main/backend/utils/notification_service.py`)
