# mdriabi/saas-compliance-b2b architecture

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

- Interactive diagram: https://gitdiagram.com/mdriabi/saas-compliance-b2b
- Repository: https://github.com/mdriabi/saas-compliance-b2b

## Overview

This is a multi-tenant Flask compliance application for RGPD privacy audits, ISO 27001 control tracking, security-policy generation, and report exports. Users authenticate with role-based access; administrators also complete MFA. The main workflow runs through a feature route, records tenant-scoped results and audit events, and may export reports to local storage and S3. The graph includes authentication, persistence, observability, and audit-log export. Evidence is limited to the supplied excerpts and source index; unsampled implementation details and deployment wiring are not inferred.

Main entry points: [`app/__init__.py`](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/__init__.py) (Flask application), [`app/routes_rgpd.py`](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_rgpd.py) (RGPD audits), [`app/utils_aws.py`](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/utils_aws.py) (Export storage), [`app/audit.py`](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/audit.py) (Audit events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and identity"]
  node_app["Flask application<br/>[__init__.py]"]
  node_auth["Role authorization<br/>[auth.py]"]
end

subgraph group_compliance["Compliance workflows"]
  node_rgpd["RGPD audits<br/>[routes_rgpd.py]"]
  node_iso["ISO 27001 controls<br/>[routes_iso.py]"]
  node_policies["Policy generation<br/>[routes_policies.py]"]
  node_rgpd_ui["RGPD audit page"]
  node_iso_ui["ISO dashboard<br/>[iso_dashboard.html]"]
  node_policy_ui["Policy dashboard"]
end

subgraph group_records["Records and audit"]
  node_models["Tenant data models<br/>[models.py]"]
  node_database[("Application database")]
  node_audit["Audit events<br/>[audit.py]"]
  node_logging["Structured logging"]
end

subgraph group_exports["Exports and operations"]
  node_exports["Browser exports<br/>[routes_exports.py]"]
  node_pdf["PDF rendering<br/>[pdf_export.py]"]
  node_audit_export["Audit log export<br/>[audit_export.py]"]
  node_storage["Export storage<br/>[utils_aws.py]"]
end

node_user(("Tenant user"))
node_s3["AWS S3"]
node_local_files["Local export files"]

node_user -->|"uses"| node_app
node_app -.->|"configures identity"| node_auth
node_app -->|"configures logging"| node_logging
node_app -->|"registers routes"| node_rgpd
node_app -->|"registers routes"| node_iso
node_app -->|"registers routes"| node_policies
node_app -->|"registers routes"| node_exports
node_rgpd -->|"checks roles"| node_auth
node_iso -->|"checks roles"| node_auth
node_policies -->|"checks roles"| node_auth
node_exports -->|"checks roles"| node_auth
node_rgpd -->|"renders page"| node_rgpd_ui
node_iso -.->|"renders dashboard"| node_iso_ui
node_policies -->|"renders dashboard"| node_policy_ui
node_rgpd -->|"reads and writes"| node_models
node_iso -->|"reads and writes"| node_models
node_rgpd -->|"records events"| node_audit
node_iso -->|"records events"| node_audit
node_policies -->|"records events"| node_audit
node_exports -->|"records events"| node_audit
node_audit -->|"creates audit records"| node_models
node_app -->|"initializes database"| node_database
node_models -.->|"persists entities"| node_database
node_rgpd -->|"uploads report"| node_storage
node_policies -->|"uploads policy"| node_storage
node_exports -->|"renders PDF"| node_pdf
node_exports -->|"uploads export"| node_storage
node_storage -->|"uploads objects"| node_s3
node_storage -->|"writes fallback"| node_local_files
node_audit_export -->|"queries audit logs"| node_models
node_audit_export -->|"uploads batches"| node_storage
node_audit_export -->|"records export event"| node_audit
node_app -.->|"invokes export"| node_audit_export

click node_app "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/__init__.py"
click node_auth "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/auth.py"
click node_rgpd "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_rgpd.py"
click node_iso "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_iso.py"
click node_policies "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_policies.py"
click node_rgpd_ui "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/templates/audit-rgpd-module1.html"
click node_iso_ui "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/templates/iso_dashboard.html"
click node_policy_ui "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/templates/policies_dashboard.html"
click node_models "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/models.py"
click node_audit "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/audit.py"
click node_logging "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/structured_logging.py"
click node_exports "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_exports.py"
click node_pdf "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/pdf_export.py"
click node_audit_export "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/audit_export.py"
click node_storage "https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/utils_aws.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_app,node_auth,node_user toneBlue
class node_rgpd,node_iso,node_policies,node_rgpd_ui,node_iso_ui,node_policy_ui toneAmber
class node_models,node_database,node_audit,node_logging toneMint
class node_exports,node_pdf,node_audit_export,node_storage toneRose
class node_s3,node_local_files toneIndigo
```

## Components

### Web and identity

- [Flask application](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/__init__.py): `app/__init__.py`
- [Role authorization](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/auth.py): `app/auth.py`

### Compliance workflows

- [RGPD audits](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_rgpd.py): `app/routes_rgpd.py`
- [ISO 27001 controls](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_iso.py): `app/routes_iso.py`
- [Policy generation](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_policies.py): `app/routes_policies.py`
- [RGPD audit page](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/templates/audit-rgpd-module1.html): `app/templates/audit-rgpd-module1.html`
- [ISO dashboard](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/templates/iso_dashboard.html): `app/templates/iso_dashboard.html`
- [Policy dashboard](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/templates/policies_dashboard.html): `app/templates/policies_dashboard.html`

### Records and audit

- [Tenant data models](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/models.py): `app/models.py`
- **Application database**
- [Audit events](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/audit.py): `app/audit.py`
- [Structured logging](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/structured_logging.py): `app/structured_logging.py`

### Exports and operations

- [Browser exports](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/routes_exports.py): `app/routes_exports.py`
- [PDF rendering](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/pdf_export.py): `app/pdf_export.py`
- [Audit log export](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/audit_export.py): `app/audit_export.py`
- [Export storage](https://github.com/mdriabi/saas-compliance-b2b/blob/main/app/utils_aws.py): `app/utils_aws.py`

### Other components

- **Tenant user**
- **AWS S3**
- **Local export files**

## Connections

- Tenant user → Flask application: uses
- Flask application → Role authorization: configures identity
- Flask application → Structured logging: configures logging (evidence: `app/__init__.py`)
- Flask application → RGPD audits: registers routes (evidence: `app/__init__.py`)
- Flask application → ISO 27001 controls: registers routes (evidence: `app/__init__.py`)
- Flask application → Policy generation: registers routes (evidence: `app/__init__.py`)
- Flask application → Browser exports: registers routes (evidence: `app/__init__.py`)
- RGPD audits → Role authorization: checks roles (evidence: `app/routes_rgpd.py`)
- ISO 27001 controls → Role authorization: checks roles (evidence: `app/routes_iso.py`)
- Policy generation → Role authorization: checks roles (evidence: `app/routes_policies.py`)
- Browser exports → Role authorization: checks roles (evidence: `app/routes_exports.py`)
- RGPD audits → RGPD audit page: renders page (evidence: `app/routes_rgpd.py`)
- ISO 27001 controls → ISO dashboard: renders dashboard
- Policy generation → Policy dashboard: renders dashboard (evidence: `app/routes_policies.py`)
- RGPD audits → Tenant data models: reads and writes (evidence: `app/routes_rgpd.py`)
- ISO 27001 controls → Tenant data models: reads and writes (evidence: `app/routes_iso.py`)
- RGPD audits → Audit events: records events (evidence: `app/routes_rgpd.py`)
- ISO 27001 controls → Audit events: records events (evidence: `app/routes_iso.py`)
- Policy generation → Audit events: records events (evidence: `app/routes_policies.py`)
- Browser exports → Audit events: records events (evidence: `app/routes_exports.py`)
- Audit events → Tenant data models: creates audit records (evidence: `app/audit.py`)
- Flask application → Application database: initializes database (evidence: `app/__init__.py`)
- Tenant data models → Application database: persists entities
- RGPD audits → Export storage: uploads report (evidence: `app/routes_rgpd.py`)
- Policy generation → Export storage: uploads policy (evidence: `app/routes_policies.py`)
- Browser exports → PDF rendering: renders PDF (evidence: `app/routes_exports.py`)
- Browser exports → Export storage: uploads export (evidence: `app/routes_exports.py`)
- Export storage → AWS S3: uploads objects (evidence: `app/utils_aws.py`)
- Export storage → Local export files: writes fallback (evidence: `app/utils_aws.py`)
- Audit log export → Tenant data models: queries audit logs (evidence: `app/audit_export.py`)
- Audit log export → Export storage: uploads batches (evidence: `app/audit_export.py`)
- Audit log export → Audit events: records export event (evidence: `app/audit_export.py`)
- Flask application → Audit log export: invokes export (evidence: `app/__init__.py`)
