# springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1 architecture

> Architecture diagram of the GitHub repository springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1
- Repository: https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1

## Overview

MarketMind AI is a small-business sales intelligence platform. A user signs in to the frontend and uses dashboards, sales and inventory tools, invoices, and AI insights; the security gateway protects requests and proxies business operations to the database-backed API. AI capabilities include anomaly detection, churn prediction, recommendations, segmentation, and forecasting. The repository also contains a unified FastAPI application and standalone AI API apps. Some links to unsampled feature implementations are omitted or marked unverified.

Main entry points: [`Security_API_gateway/src/app.js`](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/app.js) (Gateway app), [`Backend_Databse/src/app.js`](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/app.js) (Backend app), [`Frontend/src/routes/AppRoutes.jsx`](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Frontend/src/routes/AppRoutes.jsx) (Frontend routes), [`Security_API_gateway/src/auth/auth.controller.js`](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/auth/auth.controller.js) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_web["Frontend routes<br/>[AppRoutes.jsx]"]
  node_webfeatures["Business workspace"]
end

subgraph group_security["Security gateway"]
  node_gateway["Gateway app<br/>[app.js]"]
  node_auth["Authentication<br/>[auth.controller.js]"]
  node_authstore[("Gateway user store<br/>[prisma.js]")]
  node_audit["Audit logging<br/>[auditLogger.js]"]
  node_invoiceproxy["Invoice proxy<br/>[invoices.routes.js]"]
  node_inventoryproxy["Inventory proxy"]
  node_serviceconfig["Service endpoints<br/>[services.config.js]"]
end

subgraph group_business["Business API and data"]
  node_backend["Backend app<br/>[app.js]"]
  node_invoiceroutes["Invoice routes<br/>[invoice.routes.js]"]
  node_invoicecontroller["Invoice operations"]
  node_invoiceservice["Invoice service<br/>[invoice.service.js]"]
  node_salescontroller["Sales operations"]
  node_db[("Business database<br/>[prisma.js]")]
end

subgraph group_intelligence["AI intelligence"]
  node_fastapi["Unified AI API<br/>[main.py]"]
  node_airouters["AI feature routers"]
  node_aiservices["AI domain services"]
  node_standalone["AI service APIs"]
end

node_user(("Business user"))

node_user -->|"uses"| node_web
node_web -->|"routes to"| node_webfeatures
node_web -.->|"requests API"| node_gateway
node_gateway -->|"mounts auth"| node_auth
node_auth -->|"reads and writes"| node_authstore
node_gateway -->|"mounts invoices"| node_invoiceproxy
node_gateway -->|"mounts inventory"| node_inventoryproxy
node_gateway -->|"logs rejected requests"| node_audit
node_auth -->|"logs auth events"| node_audit
node_invoiceproxy -->|"gets backend URL"| node_serviceconfig
node_invoiceproxy -->|"forwards requests"| node_backend
node_inventoryproxy -->|"gets backend URL"| node_serviceconfig
node_inventoryproxy -->|"forwards requests"| node_backend
node_backend -->|"mounts invoices"| node_invoiceroutes
node_invoiceroutes -->|"dispatches invoice actions"| node_invoicecontroller
node_invoicecontroller -->|"calls service"| node_invoiceservice
node_invoicecontroller -->|"queries data"| node_db
node_invoiceservice -->|"queries data"| node_db
node_backend -->|"mounts sales routes"| node_salescontroller
node_salescontroller -->|"reads and writes sales"| node_db
node_salescontroller -->|"uses invoice service"| node_invoiceservice
node_fastapi -->|"mounts routers"| node_airouters
node_airouters -.->|"delegates to services"| node_aiservices
node_fastapi -.->|"provides parallel AI APIs"| node_standalone

click node_web "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Frontend/src/routes/AppRoutes.jsx"
click node_webfeatures "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/Frontend/src/pages"
click node_gateway "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/app.js"
click node_auth "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/auth/auth.controller.js"
click node_authstore "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/config/prisma.js"
click node_audit "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/middleware/auditLogger.js"
click node_invoiceproxy "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/routes/invoices.routes.js"
click node_inventoryproxy "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/routes/inventory.routes.js"
click node_serviceconfig "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/config/services.config.js"
click node_backend "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/app.js"
click node_invoiceroutes "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/routes/invoice.routes.js"
click node_invoicecontroller "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/controllers/invoice.controller.js"
click node_invoiceservice "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/services/invoice.service.js"
click node_salescontroller "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/controllers/sales.controller.js"
click node_db "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/config/prisma.js"
click node_fastapi "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/server/main.py"
click node_airouters "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/server/routers"
click node_aiservices "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/server/services"
click node_standalone "https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/AIML/api"

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,node_webfeatures,node_user toneBlue
class node_gateway,node_auth,node_authstore,node_audit,node_invoiceproxy,node_inventoryproxy,node_serviceconfig toneAmber
class node_backend,node_invoiceroutes,node_invoicecontroller,node_invoiceservice,node_salescontroller,node_db toneMint
class node_fastapi,node_airouters,node_aiservices,node_standalone toneRose
```

## Components

### Web application

- [Frontend routes](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Frontend/src/routes/AppRoutes.jsx): `Frontend/src/routes/AppRoutes.jsx`
- [Business workspace](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/Frontend/src/pages): `Frontend/src/pages`

### Security gateway

- [Gateway app](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/app.js): `Security_API_gateway/src/app.js`
- [Authentication](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/auth/auth.controller.js): `Security_API_gateway/src/auth/auth.controller.js`
- [Gateway user store](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/config/prisma.js): `Security_API_gateway/src/config/prisma.js`
- [Audit logging](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/middleware/auditLogger.js): `Security_API_gateway/src/middleware/auditLogger.js`
- [Invoice proxy](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/routes/invoices.routes.js): `Security_API_gateway/src/routes/invoices.routes.js`
- [Inventory proxy](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/routes/inventory.routes.js): `Security_API_gateway/src/routes/inventory.routes.js`
- [Service endpoints](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Security_API_gateway/src/config/services.config.js): `Security_API_gateway/src/config/services.config.js`

### Business API and data

- [Backend app](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/app.js): `Backend_Databse/src/app.js`
- [Invoice routes](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/routes/invoice.routes.js): `Backend_Databse/src/routes/invoice.routes.js`
- [Invoice operations](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/controllers/invoice.controller.js): `Backend_Databse/src/controllers/invoice.controller.js`
- [Invoice service](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/services/invoice.service.js): `Backend_Databse/src/services/invoice.service.js`
- [Sales operations](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/controllers/sales.controller.js): `Backend_Databse/src/controllers/sales.controller.js`
- [Business database](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/Backend_Databse/src/config/prisma.js): `Backend_Databse/src/config/prisma.js`

### AI intelligence

- [Unified AI API](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/blob/main/server/main.py): `server/main.py`
- [AI feature routers](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/server/routers): `server/routers`
- [AI domain services](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/server/services): `server/services`
- [AI service APIs](https://github.com/springboardmentor54321v/small-business-sales-intelligence-platform-sb7-team1/tree/main/AIML/api): `AIML/api`

### Other components

- **Business user**

## Connections

- Business user → Frontend routes: uses (evidence: `Frontend/src/routes/AppRoutes.jsx`)
- Frontend routes → Business workspace: routes to (evidence: `Frontend/src/routes/AppRoutes.jsx`)
- Frontend routes → Gateway app: requests API
- Gateway app → Authentication: mounts auth (evidence: `Security_API_gateway/src/app.js`)
- Authentication → Gateway user store: reads and writes (evidence: `Security_API_gateway/src/auth/auth.controller.js`)
- Gateway app → Invoice proxy: mounts invoices (evidence: `Security_API_gateway/src/app.js`)
- Gateway app → Inventory proxy: mounts inventory (evidence: `Security_API_gateway/src/app.js`)
- Gateway app → Audit logging: logs rejected requests (evidence: `Security_API_gateway/src/app.js`)
- Authentication → Audit logging: logs auth events (evidence: `Security_API_gateway/src/auth/auth.controller.js`)
- Invoice proxy → Service endpoints: gets backend URL (evidence: `Security_API_gateway/src/routes/invoices.routes.js`)
- Invoice proxy → Backend app: forwards requests (evidence: `Security_API_gateway/src/routes/invoices.routes.js`)
- Inventory proxy → Service endpoints: gets backend URL (evidence: `Security_API_gateway/src/routes/inventory.routes.js`)
- Inventory proxy → Backend app: forwards requests (evidence: `Security_API_gateway/src/routes/inventory.routes.js`)
- Backend app → Invoice routes: mounts invoices (evidence: `Backend_Databse/src/app.js`)
- Invoice routes → Invoice operations: dispatches invoice actions (evidence: `Backend_Databse/src/routes/invoice.routes.js`)
- Invoice operations → Invoice service: calls service (evidence: `Backend_Databse/src/controllers/invoice.controller.js`)
- Invoice operations → Business database: queries data (evidence: `Backend_Databse/src/controllers/invoice.controller.js`)
- Invoice service → Business database: queries data (evidence: `Backend_Databse/src/services/invoice.service.js`)
- Backend app → Sales operations: mounts sales routes (evidence: `Backend_Databse/src/app.js`)
- Sales operations → Business database: reads and writes sales (evidence: `Backend_Databse/src/controllers/sales.controller.js`)
- Sales operations → Invoice service: uses invoice service (evidence: `Backend_Databse/src/controllers/sales.controller.js`)
- Unified AI API → AI feature routers: mounts routers (evidence: `server/main.py`)
- AI feature routers → AI domain services: delegates to services
- Unified AI API → AI service APIs: provides parallel AI APIs
