# aquilax-ai/findings architecture

> Architecture diagram of the GitHub repository aquilax-ai/findings, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aquilax-ai/findings
- Repository: https://github.com/aquilax-ai/findings

## Overview

##### Project type and purpose
- This is not a running web or microservice application but a “Test Data Repository” whose sole purpose is to host vulnerable code and configuration examples.
- It’s used to validate and benchmark security‐scanning tools (e.g., Aquilax) across categories such as SAST, PII, Secrets, SCA (dependency scanning), IaC scanning, container security, malware detection, and mobile app vulnerabilities.

##### File structure
- Top‐level:
- .github/workflows/text.yml → CI orchestration via GitHub Actions
- FP/ → False‐positive test cases
- TP/ → True‐positive (actual vulnerable) test cases
- Root sample manifests: Dockerfile, package.json, pom.xml, requirements.txt (SCA targets)
- Under both FP/ and TP/: six main subfolders:
- IAC (Kubernetes YAML, Terraform)
- Malware (code in C, Go, PHP, Python, Java, etc.)
- PII (text files with fake PII)
- SAST (scripts and source illustrating injection, XSS, SSRF, etc.)
- SECRETS (hardcoded keys, env vars)
- Mobile (only in TP – an iOS Xcode project with insecure code examples)

##### README for additional insights
- Lists every category of vulnerability covered (SQLi, XSS, CSRF, IDOR, XXE, insecure Docker, outdated deps, etc.)
- Describes a simple usage flow: clone repo → run scanners → review findings

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Input Payload: Repository and samples
    subgraph "GitHub Repository" 
        direction TB
        Repo["/ (Test Data Repository)"]:::repo
        subgraph "False-Positive Samples (FP)"
            direction TB
            FP_IAC1["non_privileged_pod.yaml"]:::sample
            FP_IAC2["resource_limits.yaml"]:::sample
            FP_IAC3["secure_security_group.tf"]:::sample
            FP_SAST["SAST/"]:::sample
            FP_PII["PII/"]:::sample
            FP_SECRETS["SECRETS/"]:::sample
        end
        subgraph "True-Positive Samples (TP)"
            direction TB
            TP_IAC1["missing_resource_limits.yaml"]:::sample
            TP_IAC2["privileged_pod.yaml"]:::sample
            TP_IAC3["insecure_security_group.tf"]:::sample
            TP_SAST["SAST/"]:::sample
            TP_PII["PII/"]:::sample
            TP_SECRETS["SECRETS/"]:::sample
            TP_MOBILE["DVIA-v2/"]:::sample
        end
        subgraph "Root Sample Manifests"
            direction TB
            Pkg["package.json"]:::sample
            Pom["pom.xml"]:::sample
            Req["requirements.txt"]:::sample
            Doc["Dockerfile"]:::sample
        end
    end

    %% CI/CD Pipeline
    CI["GitHub Actions Workflow"]:::ci

    %% Scanner Modules
    subgraph "Aquilax Scanner Platform"
        direction TB
        SAST["SAST Engine"]:::scanner
        PII["PII Detector"]:::scanner
        SECRETS["Secrets Scanner"]:::scanner
        SCA["SCA/Dependency Analyzer"]:::scanner
        IaC["IaC Security Scanner"]:::scanner
        Container["Container/Dockerfile Scanner"]:::scanner
        Mobile["Mobile Code Scanner"]:::scanner
    end

    %% Results and Users
    Results["Results Dashboard / Artifacts"]:::results
    Users["End Users (Developers, Sec Eng)"]:::users

    %% Data Flows
    Repo -->|"push triggers"| CI
    CI -->|"analyzes FP_IAC samples"| IaC
    CI -->|"analyzes TP_IAC samples"| IaC
    CI -->|"analyzes FP_SAST & TP_SAST"| SAST
    CI -->|"analyzes FP_PII & TP_PII"| PII
    CI -->|"analyzes FP_SECRETS & TP_SECRETS"| SECRETS
    CI -->|"analyzes root manifests"| SCA
    CI -->|"analyzes Dockerfile"| Container
    CI -->|"analyzes DVIA-v2 mobile code"| Mobile

    SAST -->|"findings"| Results
    PII -->|"findings"| Results
    SECRETS -->|"findings"| Results
    SCA -->|"findings"| Results
    IaC -->|"findings"| Results
    Container -->|"findings"| Results
    Mobile -->|"findings"| Results

    Results -->|"review"| Users

    %% Click Events for component mapping
    click Repo "https://github.com/aquilax-ai/findings/tree/main//"
    click CI "https://github.com/aquilax-ai/findings/blob/main/.github/workflows/text.yml"
    click Pkg "https://github.com/aquilax-ai/findings/blob/main/package.json"
    click Pom "https://github.com/aquilax-ai/findings/blob/main/pom.xml"
    click Req "https://github.com/aquilax-ai/findings/blob/main/requirements.txt"
    click Doc "https://github.com/aquilax-ai/findings/tree/main/Dockerfile"
    click FP_IAC1 "https://github.com/aquilax-ai/findings/blob/main/FP/IAC/kubernetes/non_privileged_pod.yaml"
    click FP_IAC2 "https://github.com/aquilax-ai/findings/blob/main/FP/IAC/kubernetes/resource_limits.yaml"
    click FP_IAC3 "https://github.com/aquilax-ai/findings/blob/main/FP/IAC/terraform/secure_security_group.tf"
    click TP_IAC1 "https://github.com/aquilax-ai/findings/blob/main/TP/IAC/kubernetes/missing_resource_limits.yaml"
    click TP_IAC2 "https://github.com/aquilax-ai/findings/blob/main/TP/IAC/kubernetes/privileged_pod.yaml"
    click TP_IAC3 "https://github.com/aquilax-ai/findings/blob/main/TP/IAC/terraform/insecure_security_group.tf"

    %% Styles
    classDef repo fill:#D6E9FE,stroke:#4E79A7,color:#0D3B66;
    classDef sample fill:#E3F2FD,stroke:#64B5F6,color:#0D47A1;
    classDef ci fill:#E8F5E9,stroke:#66BB6A,color:#1B5E20;
    classDef scanner fill:#FFF3E0,stroke:#FFA726,color:#E65100;
    classDef results fill:#F3E5F5,stroke:#AB47BC,color:#4A148C;
    classDef users fill:#ECEFF1,stroke:#90A4AE,color:#37474F;
```
