# muathoillah/laravel-security-assessment-app architecture

> Architecture diagram of the GitHub repository muathoillah/laravel-security-assessment-app, 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/muathoillah/laravel-security-assessment-app
- Repository: https://github.com/muathoillah/laravel-security-assessment-app

## Overview

This appears to be a multi-tenant project and document management application, with web and API surfaces. A user works within an organization to manage projects, move them through a controlled lifecycle, and handle project documents; imports, sharing, membership, audit, and webhooks provide supporting capabilities. The excerpts show project lifecycle and audit calls directly. Several other capabilities are visible in the tree and source index, but their runtime wiring is not sampled, so those links are omitted or marked unverified.

Main entry points: [`app/Http/Controllers`](https://github.com/muathoillah/laravel-security-assessment-app/tree/main/app/Http/Controllers) (Web controllers), [`app/Jobs/RunProjectImport.php`](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Jobs/RunProjectImport.php) (Import worker), [`app/Models/Organization.php`](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Organization.php) (Organization), [`app/Models/Project.php`](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Project.php) (Project records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; tenancy"]
  node_web["Web controllers"]
  node_api["API controllers"]
  node_membership[("Organization membership<br/>[Membership.php]")]
  node_organization[("Organization<br/>[Organization.php]")]
end

subgraph group_projects["Project management"]
  node_project[("Project records<br/>[Project.php]")]
  node_workflow["Project lifecycle"]
  node_projectviews["Project screens"]
end

subgraph group_documents["Documents &amp; imports"]
  node_document[("Document records<br/>[Document.php]")]
  node_documentflows["Document workflows"]
  node_import[("Project imports<br/>[Import.php]")]
  node_importjob["Import worker"]
  node_archive["Archive extraction"]
  node_remote["Remote fetcher<br/>[RemoteFetcher.php]"]
end

subgraph group_platform["Audit &amp; integrations"]
  node_auditlogger["Audit logger<br/>[AuditLogger.php]"]
  node_audit[("Audit records<br/>[AuditActivity.php]")]
  node_webhooks["Webhook dispatch"]
  node_webhookrecords[("Webhook records<br/>[Webhook.php]")]
  node_deliveries[("Delivery records")]
  node_storage["Storage quota<br/>[StorageQuota.php]"]
end

node_user(("User"))

node_user -->|"uses"| node_web
node_web -->|"loads"| node_organization
node_web -->|"creates and updates"| node_project
node_web -->|"transitions"| node_workflow
node_web -->|"records changes"| node_auditlogger
node_web -->|"renders"| node_projectviews
node_workflow -->|"updates lifecycle"| node_project
node_workflow -->|"records events"| node_auditlogger
node_auditlogger -->|"creates records"| node_audit
node_organization -->|"relates memberships"| node_membership
node_organization -->|"relates projects"| node_project
node_organization -->|"relates documents"| node_document
node_documentflows -->|"reads and writes"| node_document
node_importjob -->|"processes"| node_import
node_importjob -->|"creates or updates"| node_document
node_importjob -->|"extracts archives"| node_archive
node_importjob -->|"fetches sources"| node_remote
node_webhooks -->|"dispatches for"| node_webhookrecords
node_webhooks -->|"records deliveries"| node_deliveries
node_storage -->|"checks quota"| node_organization
node_api -->|"serves project operations"| node_project
node_api -->|"serves membership operations"| node_membership
node_api -.->|"serves document operations"| node_document
node_web -.->|"queues imports"| node_importjob

click node_web "https://github.com/muathoillah/laravel-security-assessment-app/tree/main/app/Http/Controllers"
click node_api "https://github.com/muathoillah/laravel-security-assessment-app/tree/main/app/Http/Controllers/Api/V1"
click node_membership "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Membership.php"
click node_organization "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Organization.php"
click node_project "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Project.php"
click node_workflow "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Domain/Project/ProjectWorkflow.php"
click node_projectviews "https://github.com/muathoillah/laravel-security-assessment-app/tree/main/resources/views/projects"
click node_document "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Document.php"
click node_documentflows "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Http/Controllers/DocumentController.php"
click node_import "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Import.php"
click node_importjob "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Jobs/RunProjectImport.php"
click node_archive "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/Documents/ArchiveExtractor.php"
click node_remote "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/Integrations/RemoteFetcher.php"
click node_auditlogger "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/AuditLogger.php"
click node_audit "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/AuditActivity.php"
click node_webhooks "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/WebhookDispatcher.php"
click node_webhookrecords "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Webhook.php"
click node_deliveries "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/WebhookDelivery.php"
click node_storage "https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/Storage/StorageQuota.php"

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_api,node_membership,node_organization,node_user toneBlue
class node_project,node_workflow,node_projectviews toneAmber
class node_document,node_documentflows,node_import,node_importjob,node_archive,node_remote toneMint
class node_auditlogger,node_audit,node_webhooks,node_webhookrecords,node_deliveries,node_storage toneRose
```

## Components

### Access & tenancy

- [Web controllers](https://github.com/muathoillah/laravel-security-assessment-app/tree/main/app/Http/Controllers): `app/Http/Controllers`
- [API controllers](https://github.com/muathoillah/laravel-security-assessment-app/tree/main/app/Http/Controllers/Api/V1): `app/Http/Controllers/Api/V1`
- [Organization membership](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Membership.php): `app/Models/Membership.php`
- [Organization](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Organization.php): `app/Models/Organization.php`

### Project management

- [Project records](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Project.php): `app/Models/Project.php`
- [Project lifecycle](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Domain/Project/ProjectWorkflow.php): `app/Domain/Project/ProjectWorkflow.php`
- [Project screens](https://github.com/muathoillah/laravel-security-assessment-app/tree/main/resources/views/projects): `resources/views/projects`

### Documents & imports

- [Document records](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Document.php): `app/Models/Document.php`
- [Document workflows](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Http/Controllers/DocumentController.php): `app/Http/Controllers/DocumentController.php`
- [Project imports](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Import.php): `app/Models/Import.php`
- [Import worker](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Jobs/RunProjectImport.php): `app/Jobs/RunProjectImport.php`
- [Archive extraction](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/Documents/ArchiveExtractor.php): `app/Services/Documents/ArchiveExtractor.php`
- [Remote fetcher](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/Integrations/RemoteFetcher.php): `app/Services/Integrations/RemoteFetcher.php`

### Audit & integrations

- [Audit logger](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/AuditLogger.php): `app/Services/AuditLogger.php`
- [Audit records](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/AuditActivity.php): `app/Models/AuditActivity.php`
- [Webhook dispatch](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/WebhookDispatcher.php): `app/Services/WebhookDispatcher.php`
- [Webhook records](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/Webhook.php): `app/Models/Webhook.php`
- [Delivery records](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Models/WebhookDelivery.php): `app/Models/WebhookDelivery.php`
- [Storage quota](https://github.com/muathoillah/laravel-security-assessment-app/blob/main/app/Services/Storage/StorageQuota.php): `app/Services/Storage/StorageQuota.php`

### Other components

- **User**

## Connections

- User → Web controllers: uses (evidence: `app/Http/Controllers/ProjectController.php`)
- Web controllers → Organization: loads (evidence: `app/Http/Controllers/ProjectController.php`)
- Web controllers → Project records: creates and updates (evidence: `app/Http/Controllers/ProjectController.php`)
- Web controllers → Project lifecycle: transitions (evidence: `app/Http/Controllers/ProjectController.php`)
- Web controllers → Audit logger: records changes (evidence: `app/Http/Controllers/ProjectController.php`)
- Web controllers → Project screens: renders (evidence: `app/Http/Controllers/ProjectController.php`)
- Project lifecycle → Project records: updates lifecycle (evidence: `app/Domain/Project/ProjectWorkflow.php`)
- Project lifecycle → Audit logger: records events (evidence: `app/Domain/Project/ProjectWorkflow.php`)
- Audit logger → Audit records: creates records (evidence: `app/Services/AuditLogger.php`)
- Organization → Organization membership: relates memberships (evidence: `app/Models/Organization.php`)
- Organization → Project records: relates projects (evidence: `app/Models/Organization.php`)
- Organization → Document records: relates documents (evidence: `app/Models/Organization.php`)
- Document workflows → Document records: reads and writes (evidence: `app/Http/Controllers/DocumentController.php`)
- Import worker → Project imports: processes (evidence: `app/Jobs/RunProjectImport.php`)
- Import worker → Document records: creates or updates (evidence: `app/Jobs/RunProjectImport.php`)
- Import worker → Archive extraction: extracts archives (evidence: `app/Jobs/RunProjectImport.php`)
- Import worker → Remote fetcher: fetches sources (evidence: `app/Jobs/RunProjectImport.php`)
- Webhook dispatch → Webhook records: dispatches for (evidence: `app/Services/WebhookDispatcher.php`)
- Webhook dispatch → Delivery records: records deliveries (evidence: `app/Services/WebhookDispatcher.php`)
- Storage quota → Organization: checks quota (evidence: `app/Services/Storage/StorageQuota.php`)
- API controllers → Project records: serves project operations (evidence: `app/Http/Controllers/Api/V1/ProjectController.php`)
- API controllers → Organization membership: serves membership operations (evidence: `app/Http/Controllers/Api/V1/MemberController.php`)
- API controllers → Document records: serves document operations
- Web controllers → Import worker: queues imports
