# kaiftaslim7-lang/ibm-project architecture

> Architecture diagram of the GitHub repository kaiftaslim7-lang/ibm-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kaiftaslim7-lang/ibm-project
- Repository: https://github.com/kaiftaslim7-lang/ibm-project

## Overview

PassTrack Pro is a visitor-management web app for reception and security teams. Staff authenticate, then use a dashboard to register and find visitors, edit or remove records, toggle check-in status, inspect details, print badges, view occupancy statistics, and export CSV. The React app calls an Express API; controllers apply visitor and account logic through Mongoose models backed by MongoDB, with an in-memory fallback. Edges reflect sampled calls and documented capabilities; some UI feature wiring is documented but not visible in the sampled App excerpt.

Main entry points: [`frontend/src/App.jsx`](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/App.jsx) (Dashboard state), [`backend/server.js`](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/server.js) (Express API server), [`backend/routes/authRoutes.js`](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/routes/authRoutes.js) (Auth routes), [`frontend/src/services/api.js`](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/services/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Dashboard state<br/>[App.jsx]"]
  node_authui["Login and signup<br/>[AuthPage.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_visitor_views["Visitor list and filters<br/>[VisitorList.jsx]"]
  node_visitor_form["Visitor edit form"]
  node_visitor_details["Visitor details"]
  node_badge["Printable badge"]
  node_delete_confirm["Delete confirmation"]
  node_stats["KPI cards<br/>[StatsOverview.jsx]"]
  node_navbar["Navigation and export<br/>[Navbar.jsx]"]
end

subgraph group_api["API and access"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Account authentication<br/>[authController.js]"]
  node_auth_middleware["JWT protection<br/>[authMiddleware.js]"]
  node_visitor_routes["Visitor routes<br/>[visitorRoutes.js]"]
  node_server["Express API server<br/>[server.js]"]
end

subgraph group_domain["Visitor operations"]
  node_visitor_controller["Visitor records and stats"]
end

subgraph group_persistence["Persistence"]
  node_visitor_model["Visitor schema<br/>[Visitor.js]"]
  node_user_model["User schema<br/>[User.js]"]
  node_db_config["MongoDB connection<br/>[db.js]"]
end

node_staff(("Reception / security staff"))
node_mongodb[("MongoDB or memory DB")]

node_staff -->|"signs in"| node_authui
node_staff -->|"manages visits"| node_app
node_authui -->|"submits credentials"| node_api_client
node_app -->|"requests visitor data"| node_api_client
node_app -->|"renders"| node_visitor_views
node_app -->|"renders"| node_visitor_form
node_app -->|"renders"| node_visitor_details
node_app -->|"renders"| node_badge
node_app -->|"renders"| node_delete_confirm
node_app -->|"renders"| node_stats
node_app -->|"renders"| node_navbar
node_visitor_views -.->|"sends actions"| node_app
node_visitor_form -.->|"submits edits"| node_app
node_delete_confirm -.->|"confirms deletion"| node_app
node_navbar -.->|"requests export"| node_app
node_api_client -->|"HTTP requests"| node_server
node_server -->|"mounts auth routes"| node_auth_routes
node_server -->|"mounts visitor routes"| node_visitor_routes
node_auth_routes -->|"dispatches auth"| node_auth_controller
node_auth_routes -->|"protects current user"| node_auth_middleware
node_visitor_routes -->|"dispatches visitor requests"| node_visitor_controller
node_auth_controller -->|"reads and writes users"| node_user_model
node_auth_middleware -->|"loads account"| node_user_model
node_visitor_controller -->|"queries and updates"| node_visitor_model
node_server -->|"connects database"| node_db_config
node_db_config -->|"connects or falls back"| node_mongodb

click node_app "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/AuthPage.jsx"
click node_api_client "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/services/api.js"
click node_visitor_views "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorList.jsx"
click node_visitor_form "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorFormModal.jsx"
click node_visitor_details "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorDetailsModal.jsx"
click node_badge "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorBadgeModal.jsx"
click node_delete_confirm "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/DeleteConfirmModal.jsx"
click node_stats "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/StatsOverview.jsx"
click node_navbar "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/Navbar.jsx"
click node_auth_routes "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/controllers/authController.js"
click node_auth_middleware "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/middleware/authMiddleware.js"
click node_visitor_routes "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/routes/visitorRoutes.js"
click node_server "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/server.js"
click node_visitor_controller "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/controllers/visitorController.js"
click node_visitor_model "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/models/Visitor.js"
click node_user_model "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/models/User.js"
click node_db_config "https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/config/db.js"

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_app,node_authui,node_api_client,node_visitor_views,node_visitor_form,node_visitor_details,node_badge,node_delete_confirm,node_stats,node_navbar toneBlue
class node_auth_routes,node_auth_controller,node_auth_middleware,node_visitor_routes,node_server,node_mongodb toneAmber
class node_visitor_controller toneMint
class node_visitor_model,node_user_model,node_db_config toneRose
class node_staff toneIndigo
```

## Components

### Web client

- [Dashboard state](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login and signup](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/AuthPage.jsx): `frontend/src/components/AuthPage.jsx`
- [API client](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Visitor list and filters](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorList.jsx): `frontend/src/components/VisitorList.jsx`
- [Visitor edit form](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorFormModal.jsx): `frontend/src/components/VisitorFormModal.jsx`
- [Visitor details](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorDetailsModal.jsx): `frontend/src/components/VisitorDetailsModal.jsx`
- [Printable badge](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/VisitorBadgeModal.jsx): `frontend/src/components/VisitorBadgeModal.jsx`
- [Delete confirmation](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/DeleteConfirmModal.jsx): `frontend/src/components/DeleteConfirmModal.jsx`
- [KPI cards](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/StatsOverview.jsx): `frontend/src/components/StatsOverview.jsx`
- [Navigation and export](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`

### API and access

- [Auth routes](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Account authentication](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [JWT protection](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Visitor routes](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/routes/visitorRoutes.js): `backend/routes/visitorRoutes.js`
- [Express API server](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/server.js): `backend/server.js`

### Visitor operations

- [Visitor records and stats](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/controllers/visitorController.js): `backend/controllers/visitorController.js`

### Persistence

- [Visitor schema](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/models/Visitor.js): `backend/models/Visitor.js`
- [User schema](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/models/User.js): `backend/models/User.js`
- [MongoDB connection](https://github.com/kaiftaslim7-lang/ibm-project/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **Reception / security staff**
- **MongoDB or memory DB**

## Connections

- Reception / security staff → Login and signup: signs in (evidence: `frontend/src/components/AuthPage.jsx`)
- Reception / security staff → Dashboard state: manages visits (evidence: `README.md`)
- Login and signup → API client: submits credentials (evidence: `frontend/src/components/AuthPage.jsx`)
- Dashboard state → API client: requests visitor data (evidence: `frontend/src/App.jsx`)
- Dashboard state → Visitor list and filters: renders (evidence: `frontend/src/App.jsx`)
- Dashboard state → Visitor edit form: renders (evidence: `frontend/src/App.jsx`)
- Dashboard state → Visitor details: renders (evidence: `frontend/src/App.jsx`)
- Dashboard state → Printable badge: renders (evidence: `frontend/src/App.jsx`)
- Dashboard state → Delete confirmation: renders (evidence: `frontend/src/App.jsx`)
- Dashboard state → KPI cards: renders (evidence: `frontend/src/App.jsx`)
- Dashboard state → Navigation and export: renders (evidence: `frontend/src/App.jsx`)
- Visitor list and filters → Dashboard state: sends actions (evidence: `frontend/src/App.jsx`)
- Visitor edit form → Dashboard state: submits edits (evidence: `frontend/src/App.jsx`)
- Delete confirmation → Dashboard state: confirms deletion (evidence: `frontend/src/App.jsx`)
- Navigation and export → Dashboard state: requests export (evidence: `frontend/src/App.jsx`)
- API client → Express API server: HTTP requests (evidence: `frontend/src/services/api.js`)
- Express API server → Auth routes: mounts auth routes (evidence: `backend/server.js`)
- Express API server → Visitor routes: mounts visitor routes (evidence: `backend/server.js`)
- Auth routes → Account authentication: dispatches auth (evidence: `backend/routes/authRoutes.js`)
- Auth routes → JWT protection: protects current user (evidence: `backend/routes/authRoutes.js`)
- Visitor routes → Visitor records and stats: dispatches visitor requests (evidence: `backend/routes/visitorRoutes.js`)
- Account authentication → User schema: reads and writes users (evidence: `backend/controllers/authController.js`)
- JWT protection → User schema: loads account (evidence: `backend/middleware/authMiddleware.js`)
- Visitor records and stats → Visitor schema: queries and updates (evidence: `backend/controllers/visitorController.js`)
- Express API server → MongoDB connection: connects database (evidence: `backend/server.js`)
- MongoDB connection → MongoDB or memory DB: connects or falls back (evidence: `backend/config/db.js`)
