# devisingh2007/quickbiz-smart-business-card-scanner-app architecture

> Architecture diagram of the GitHub repository devisingh2007/quickbiz-smart-business-card-scanner-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/devisingh2007/quickbiz-smart-business-card-scanner-app
- Repository: https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app

## Overview

QuickBiz turns a photographed business card into an editable, categorized contact: the mobile app captures and recognizes text, parses fields and a quality score, then lets the user review and save locally or synchronize to the cloud. The app also supports contact browsing/search, native address-book export, and account management. The backend authenticates users and provides isolated contact operations backed by MongoDB. Mobile stage links and native/offline capabilities are documented in the README; unsampled route and screen internals are not inferred beyond those statements.

Main entry points: [`server/src/routes/auth.routes.ts`](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/routes/auth.routes.ts) (Auth Routes), [`server/src/routes/contact.routes.ts`](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/routes/contact.routes.ts) (Contact Routes), [`mobile/services/contact.store.js`](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/contact.store.js) (Contact Store), [`mobile/app/review.jsx`](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/review.jsx) (Review Contact)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Card Capture"]
  node_scanner["Card Scanner<br/>[scan.jsx]"]
  node_ocr["On-device OCR<br/>[ocr.service.js]"]
  node_parser["Field Parser"]
end

subgraph group_contacts["Contact Management"]
  node_review["Review Contact<br/>[review.jsx]"]
  node_contact_store["Contact Store<br/>[contact.store.js]"]
  node_contact_list["Contact Search<br/>[contacts.jsx]"]
  node_contact_detail["Contact Details"]
  node_dashboard["Dashboard<br/>[index.jsx]"]
end

subgraph group_sync["Sync and Identity"]
  node_api_client["API Client<br/>[api.service.js]"]
  node_auth_screen["Sign-in Screens<br/>[auth.jsx]"]
end

subgraph group_backend["API Backend"]
  node_server_app["Express App<br/>[app.ts]"]
  node_auth_routes["Auth Routes<br/>[auth.routes.ts]"]
  node_contact_routes["Contact Routes<br/>[contact.routes.ts]"]
  node_auth_controller["Auth Controller<br/>[auth.controller.ts]"]
  node_contact_controller["Contact Controller"]
  node_auth_service["Auth Service<br/>[auth.service.ts]"]
  node_contact_service["Contact Service<br/>[contact.service.ts]"]
  node_auth_middleware["JWT Middleware<br/>[auth.middleware.ts]"]
  node_validation["Request Validation"]
end

subgraph group_persistence["Persistence"]
  node_user_model["User Model<br/>[user.model.ts]"]
  node_contact_model["Contact Model<br/>[contact.model.ts]"]
  node_database[("MongoDB<br/>[database.ts]")]
end

node_professional(("Professional"))
node_native_contacts["Phone Address Book"]

node_professional -->|"starts scan"| node_scanner
node_scanner -->|"captures for"| node_ocr
node_ocr -->|"provides text"| node_parser
node_parser -->|"extracts fields"| node_review
node_review -->|"saves locally"| node_contact_store
node_review -.->|"exports contact"| node_native_contacts
node_professional -.->|"uses app"| node_dashboard
node_contact_list -.->|"loads contacts"| node_contact_store
node_contact_detail -.->|"edits contact"| node_contact_store
node_contact_store -->|"calls API"| node_api_client
node_auth_screen -.->|"authenticates"| node_api_client
node_api_client -.->|"REST requests"| node_server_app
node_server_app -->|"mounts routes"| node_auth_routes
node_server_app -->|"mounts routes"| node_contact_routes
node_auth_routes -->|"validates requests"| node_validation
node_auth_routes -->|"protects account"| node_auth_middleware
node_auth_routes -->|"dispatches to"| node_auth_controller
node_contact_routes -->|"validates requests"| node_validation
node_contact_routes -->|"protects routes"| node_auth_middleware
node_contact_routes -->|"dispatches to"| node_contact_controller
node_auth_controller -->|"calls service"| node_auth_service
node_contact_controller -->|"calls service"| node_contact_service
node_auth_service -->|"reads and writes"| node_user_model
node_auth_service -->|"deletes contacts"| node_contact_model
node_contact_service -->|"queries and writes"| node_contact_model
node_database -.->|"backs models"| node_contact_model
node_database -.->|"backs models"| node_user_model

click node_scanner "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/(tabs)/scan.jsx"
click node_ocr "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/ocr.service.js"
click node_parser "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/contact-parser.service.js"
click node_review "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/review.jsx"
click node_contact_store "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/contact.store.js"
click node_contact_list "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/(tabs)/contacts.jsx"
click node_contact_detail "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/contact-details.jsx"
click node_dashboard "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/(tabs)/index.jsx"
click node_api_client "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/api.service.js"
click node_auth_screen "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/auth.jsx"
click node_server_app "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/app.ts"
click node_auth_routes "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/routes/auth.routes.ts"
click node_contact_routes "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/routes/contact.routes.ts"
click node_auth_controller "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/controllers/auth.controller.ts"
click node_contact_controller "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/controllers/contact.controller.ts"
click node_auth_service "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/services/auth.service.ts"
click node_contact_service "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/services/contact.service.ts"
click node_auth_middleware "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/middleware/auth.middleware.ts"
click node_validation "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/middleware/validation.middleware.ts"
click node_user_model "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/models/user.model.ts"
click node_contact_model "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/models/contact.model.ts"
click node_database "https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/config/database.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_scanner,node_ocr,node_parser toneBlue
class node_review,node_contact_store,node_contact_list,node_contact_detail,node_dashboard toneAmber
class node_api_client,node_auth_screen toneMint
class node_server_app,node_auth_routes,node_contact_routes,node_auth_controller,node_contact_controller,node_auth_service,node_contact_service,node_auth_middleware,node_validation toneRose
class node_user_model,node_contact_model,node_database,node_professional,node_native_contacts toneIndigo
```

## Components

### Card Capture

- [Card Scanner](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/(tabs)/scan.jsx): `mobile/app/(tabs)/scan.jsx`
- [On-device OCR](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/ocr.service.js): `mobile/services/ocr.service.js`
- [Field Parser](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/contact-parser.service.js): `mobile/services/contact-parser.service.js`

### Contact Management

- [Review Contact](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/review.jsx): `mobile/app/review.jsx`
- [Contact Store](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/contact.store.js): `mobile/services/contact.store.js`
- [Contact Search](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/(tabs)/contacts.jsx): `mobile/app/(tabs)/contacts.jsx`
- [Contact Details](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/contact-details.jsx): `mobile/app/contact-details.jsx`
- [Dashboard](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/(tabs)/index.jsx): `mobile/app/(tabs)/index.jsx`

### Sync and Identity

- [API Client](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/services/api.service.js): `mobile/services/api.service.js`
- [Sign-in Screens](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/mobile/app/auth.jsx): `mobile/app/auth.jsx`

### API Backend

- [Express App](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/app.ts): `server/src/app.ts`
- [Auth Routes](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/routes/auth.routes.ts): `server/src/routes/auth.routes.ts`
- [Contact Routes](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/routes/contact.routes.ts): `server/src/routes/contact.routes.ts`
- [Auth Controller](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/controllers/auth.controller.ts): `server/src/controllers/auth.controller.ts`
- [Contact Controller](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/controllers/contact.controller.ts): `server/src/controllers/contact.controller.ts`
- [Auth Service](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/services/auth.service.ts): `server/src/services/auth.service.ts`
- [Contact Service](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/services/contact.service.ts): `server/src/services/contact.service.ts`
- [JWT Middleware](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/middleware/auth.middleware.ts): `server/src/middleware/auth.middleware.ts`
- [Request Validation](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/middleware/validation.middleware.ts): `server/src/middleware/validation.middleware.ts`

### Persistence

- [User Model](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/models/user.model.ts): `server/src/models/user.model.ts`
- [Contact Model](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/models/contact.model.ts): `server/src/models/contact.model.ts`
- [MongoDB](https://github.com/devisingh2007/quickbiz-smart-business-card-scanner-app/blob/main/server/src/config/database.ts): `server/src/config/database.ts`

### Other components

- **Professional**
- **Phone Address Book**

## Connections

- Professional → Card Scanner: starts scan
- Card Scanner → On-device OCR: captures for
- On-device OCR → Field Parser: provides text (evidence: `mobile/services/ocr.service.js`)
- Field Parser → Review Contact: extracts fields
- Review Contact → Contact Store: saves locally
- Review Contact → Phone Address Book: exports contact
- Professional → Dashboard: uses app
- Contact Search → Contact Store: loads contacts
- Contact Details → Contact Store: edits contact
- Contact Store → API Client: calls API (evidence: `mobile/services/contact.store.js`)
- Sign-in Screens → API Client: authenticates
- API Client → Express App: REST requests
- Express App → Auth Routes: mounts routes (evidence: `server/src/app.ts`)
- Express App → Contact Routes: mounts routes (evidence: `server/src/app.ts`)
- Auth Routes → Request Validation: validates requests (evidence: `server/src/routes/auth.routes.ts`)
- Auth Routes → JWT Middleware: protects account (evidence: `server/src/routes/auth.routes.ts`)
- Auth Routes → Auth Controller: dispatches to (evidence: `server/src/routes/auth.routes.ts`)
- Contact Routes → Request Validation: validates requests (evidence: `server/src/routes/contact.routes.ts`)
- Contact Routes → JWT Middleware: protects routes (evidence: `server/src/routes/contact.routes.ts`)
- Contact Routes → Contact Controller: dispatches to (evidence: `server/src/routes/contact.routes.ts`)
- Auth Controller → Auth Service: calls service (evidence: `server/src/controllers/auth.controller.ts`)
- Contact Controller → Contact Service: calls service (evidence: `server/src/controllers/contact.controller.ts`)
- Auth Service → User Model: reads and writes (evidence: `server/src/services/auth.service.ts`)
- Auth Service → Contact Model: deletes contacts (evidence: `server/src/services/auth.service.ts`)
- Contact Service → Contact Model: queries and writes (evidence: `server/src/services/contact.service.ts`)
- MongoDB → Contact Model: backs models
- MongoDB → User Model: backs models
