# blossom-anolue/securewebopsapp architecture

> Architecture diagram of the GitHub repository blossom-anolue/securewebopsapp, 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/blossom-anolue/securewebopsapp
- Repository: https://github.com/blossom-anolue/securewebopsapp

## Overview

SecureWebOps combines a security-monitoring web app, an Express API, and browser-extension entry points. The main user workflow is account access, then starting and reviewing security scans; other product areas cover phishing checks and training, team/workspace administration, and secure PDF sharing and decryption. The backend scan and PDF routes delegate to services, while Supabase provides application data and storage. The README is empty, and several major pages and functions were not sampled; their presence is shown, but uncertain connections are omitted.

Main entry points: [`src/App.tsx`](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/App.tsx) (App routing), [`routes/pdfRoutes.js`](https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/pdfRoutes.js) (PDF API), [`server.js`](https://github.com/blossom-anolue/securewebopsapp/blob/main/server.js) (Express server), [`services/supabaseAdmin.js`](https://github.com/blossom-anolue/securewebopsapp/blob/main/services/supabaseAdmin.js) (Supabase admin client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routing<br/>[App.tsx]"]
  node_authpage["Sign-in<br/>[Auth.tsx]"]
  node_dashboard["Security dashboard<br/>[Dashboard.tsx]"]
  node_scanpages["Scan pages<br/>[NewScan.tsx]"]
  node_phishing["Phishing checks<br/>[PhishingCheck.tsx]"]
  node_training["Security training<br/>[Training.tsx]"]
  node_pdfpages["PDF workflows<br/>[PDFEncryption.tsx]"]
end

subgraph group_identity["Identity and teams"]
  node_auth["Auth context<br/>[AuthContext.tsx]"]
  node_orgs["Organization hooks"]
  node_userapi["User and workspace API<br/>[userRoutes.js]"]
end

subgraph group_scanning["Security monitoring"]
  node_scanapi["Scan API<br/>[scanRoutes.js]"]
  node_scanservice["Scan orchestration<br/>[zapScanService.js]"]
  node_scanfunction["Scheduled scans<br/>[index.ts]"]
  node_securityfunction["Security scan function<br/>[index.ts]"]
end

subgraph group_documents["Secure documents"]
  node_pdfapi["PDF API<br/>[pdfRoutes.js]"]
  node_access["Access controller"]
  node_encrypt["PDF encryption"]
  node_decrypt["PDF decryption"]
end

subgraph group_backend["API and services"]
  node_audit["Audit logging<br/>[auditService.js]"]
  node_extensionapi["Extension API<br/>[extensionRoutes.js]"]
  node_server["Express server<br/>[server.js]"]
  node_client["Supabase client<br/>[client.ts]"]
  node_admin["Supabase admin client<br/>[supabaseAdmin.js]"]
end

node_user(("User"))
node_supabase[("Supabase data and storage")]
node_zap["ZAP scanner"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authpage
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_scanpages
node_app -->|"routes to"| node_phishing
node_app -->|"routes to"| node_training
node_authpage -->|"uses"| node_auth
node_auth -->|"uses"| node_client
node_orgs -->|"queries"| node_client
node_orgs -->|"requests"| node_userapi
node_server -->|"mounts"| node_scanapi
node_server -->|"mounts"| node_pdfapi
node_server -->|"mounts"| node_userapi
node_server -->|"mounts"| node_extensionapi
node_scanapi -->|"dispatches"| node_scanservice
node_scanapi -->|"queries"| node_admin
node_scanservice -->|"uses"| node_admin
node_scanservice -->|"scans with"| node_zap
node_pdfapi -->|"uses"| node_admin
node_pdfapi -->|"encrypts with"| node_encrypt
node_pdfapi -->|"delegates to"| node_access
node_access -->|"decrypts with"| node_decrypt
node_pdfapi -->|"logs events"| node_audit
node_access -->|"logs events"| node_audit
node_audit -->|"writes logs"| node_supabase
node_client -->|"connects to"| node_supabase
node_admin -->|"connects to"| node_supabase

click node_app "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/App.tsx"
click node_authpage "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/Auth.tsx"
click node_dashboard "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/Dashboard.tsx"
click node_scanpages "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/NewScan.tsx"
click node_phishing "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/PhishingCheck.tsx"
click node_training "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/Training.tsx"
click node_pdfpages "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/PDFEncryption.tsx"
click node_auth "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/contexts/AuthContext.tsx"
click node_orgs "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/hooks/useOrganizations.ts"
click node_userapi "https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/userRoutes.js"
click node_scanapi "https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/scanRoutes.js"
click node_scanservice "https://github.com/blossom-anolue/securewebopsapp/blob/main/services/zapScanService.js"
click node_scanfunction "https://github.com/blossom-anolue/securewebopsapp/blob/main/supabase/functions/scheduled-scan/index.ts"
click node_securityfunction "https://github.com/blossom-anolue/securewebopsapp/blob/main/supabase/functions/security-scan/index.ts"
click node_pdfapi "https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/pdfRoutes.js"
click node_access "https://github.com/blossom-anolue/securewebopsapp/blob/main/services/SecureAccessController.js"
click node_encrypt "https://github.com/blossom-anolue/securewebopsapp/blob/main/services/encryptionServices.js"
click node_decrypt "https://github.com/blossom-anolue/securewebopsapp/blob/main/services/decryptionServices.js"
click node_audit "https://github.com/blossom-anolue/securewebopsapp/blob/main/services/auditService.js"
click node_extensionapi "https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/extensionRoutes.js"
click node_server "https://github.com/blossom-anolue/securewebopsapp/blob/main/server.js"
click node_client "https://github.com/blossom-anolue/securewebopsapp/blob/main/src/integrations/supabase/client.ts"
click node_admin "https://github.com/blossom-anolue/securewebopsapp/blob/main/services/supabaseAdmin.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_authpage,node_dashboard,node_scanpages,node_phishing,node_training,node_pdfpages,node_user toneBlue
class node_auth,node_orgs,node_userapi,node_supabase toneAmber
class node_scanapi,node_scanservice,node_scanfunction,node_securityfunction toneMint
class node_pdfapi,node_access,node_encrypt,node_decrypt toneRose
class node_audit,node_extensionapi,node_server,node_client,node_admin,node_zap toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/App.tsx): `src/App.tsx`
- [Sign-in](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/Auth.tsx): `src/pages/Auth.tsx`
- [Security dashboard](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Scan pages](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/NewScan.tsx): `src/pages/NewScan.tsx`
- [Phishing checks](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/PhishingCheck.tsx): `src/pages/PhishingCheck.tsx`
- [Security training](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/Training.tsx): `src/pages/Training.tsx`
- [PDF workflows](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/pages/PDFEncryption.tsx): `src/pages/PDFEncryption.tsx`

### Identity and teams

- [Auth context](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Organization hooks](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/hooks/useOrganizations.ts): `src/hooks/useOrganizations.ts`
- [User and workspace API](https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/userRoutes.js): `routes/userRoutes.js`

### Security monitoring

- [Scan API](https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/scanRoutes.js): `routes/scanRoutes.js`
- [Scan orchestration](https://github.com/blossom-anolue/securewebopsapp/blob/main/services/zapScanService.js): `services/zapScanService.js`
- [Scheduled scans](https://github.com/blossom-anolue/securewebopsapp/blob/main/supabase/functions/scheduled-scan/index.ts): `supabase/functions/scheduled-scan/index.ts`
- [Security scan function](https://github.com/blossom-anolue/securewebopsapp/blob/main/supabase/functions/security-scan/index.ts): `supabase/functions/security-scan/index.ts`

### Secure documents

- [PDF API](https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/pdfRoutes.js): `routes/pdfRoutes.js`
- [Access controller](https://github.com/blossom-anolue/securewebopsapp/blob/main/services/SecureAccessController.js): `services/SecureAccessController.js`
- [PDF encryption](https://github.com/blossom-anolue/securewebopsapp/blob/main/services/encryptionServices.js): `services/encryptionServices.js`
- [PDF decryption](https://github.com/blossom-anolue/securewebopsapp/blob/main/services/decryptionServices.js): `services/decryptionServices.js`

### API and services

- [Audit logging](https://github.com/blossom-anolue/securewebopsapp/blob/main/services/auditService.js): `services/auditService.js`
- [Extension API](https://github.com/blossom-anolue/securewebopsapp/blob/main/routes/extensionRoutes.js): `routes/extensionRoutes.js`
- [Express server](https://github.com/blossom-anolue/securewebopsapp/blob/main/server.js): `server.js`
- [Supabase client](https://github.com/blossom-anolue/securewebopsapp/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- [Supabase admin client](https://github.com/blossom-anolue/securewebopsapp/blob/main/services/supabaseAdmin.js): `services/supabaseAdmin.js`

### Other components

- **User**
- **Supabase data and storage**
- **ZAP scanner**

## Connections

- User → App routing: uses (evidence: `src/App.tsx`)
- App routing → Sign-in: routes to (evidence: `src/App.tsx`)
- App routing → Security dashboard: routes to (evidence: `src/App.tsx`)
- App routing → Scan pages: routes to (evidence: `src/App.tsx`)
- App routing → Phishing checks: routes to (evidence: `src/App.tsx`)
- App routing → Security training: routes to (evidence: `src/App.tsx`)
- Sign-in → Auth context: uses (evidence: `src/pages/Auth.tsx`)
- Auth context → Supabase client: uses (evidence: `src/contexts/AuthContext.tsx`)
- Organization hooks → Supabase client: queries (evidence: `src/hooks/useOrganizations.ts`)
- Organization hooks → User and workspace API: requests (evidence: `src/hooks/useOrganizations.ts`)
- Express server → Scan API: mounts (evidence: `server.js`)
- Express server → PDF API: mounts (evidence: `server.js`)
- Express server → User and workspace API: mounts (evidence: `server.js`)
- Express server → Extension API: mounts (evidence: `server.js`)
- Scan API → Scan orchestration: dispatches (evidence: `routes/scanRoutes.js`)
- Scan API → Supabase admin client: queries (evidence: `routes/scanRoutes.js`)
- Scan orchestration → Supabase admin client: uses (evidence: `services/zapScanService.js`)
- Scan orchestration → ZAP scanner: scans with (evidence: `services/zapScanService.js`)
- PDF API → Supabase admin client: uses (evidence: `routes/pdfRoutes.js`)
- PDF API → PDF encryption: encrypts with (evidence: `routes/pdfRoutes.js`)
- PDF API → Access controller: delegates to (evidence: `routes/pdfRoutes.js`)
- Access controller → PDF decryption: decrypts with (evidence: `services/SecureAccessController.js`)
- PDF API → Audit logging: logs events (evidence: `routes/pdfRoutes.js`)
- Access controller → Audit logging: logs events (evidence: `services/SecureAccessController.js`)
- Audit logging → Supabase data and storage: writes logs (evidence: `services/auditService.js`)
- Supabase client → Supabase data and storage: connects to (evidence: `src/integrations/supabase/client.ts`)
- Supabase admin client → Supabase data and storage: connects to (evidence: `services/supabaseAdmin.js`)
