# joaopsoliveira03/estg-ca architecture

> Architecture diagram of the GitHub repository joaopsoliveira03/estg-ca, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joaopsoliveira03/estg-ca
- Repository: https://github.com/joaopsoliveira03/estg-ca

## Overview

##### Project type and purpose
- This is a Maven-based, single-module Java application (an open-source CLI tool) for “Applied Cryptography” on PDF documents.
- It provides commands (Sign, Verify, Encrypt, Decrypt, Bruteforce, TSA timestamping) by wrapping Apache PDFBox and BouncyCastle libraries.

##### File structure
- Top-level: pom.xml defines dependencies (BouncyCastle jars, PDFBox).
- src/main/java: nine entry‐point classes—one per feature:
- SymmetricEncryption.java
- AssymetricEncryption.java
- PrivateKeyAccess.java
- PDFSigner.java (calls Sign.java)
- Verify.java
- PDFDecrypter.java
- UnencryptBruteforce.java
- OSCP_TSA.java
- src/main/resources: bundled library JARs (bcprov, bcpkix, bcutil, pdfbox-app).

##### README
- Title: “Java Applied Cryptography.” No further architecture notes, so we infer design from code.

##### Capturing essential elements
- Don’t over-complicate: group closely related classes into modules.
- Dependency edge is shown (e.g., PDFSigner → Sign.java → BouncyCastle → File).
- Maven build context if desired (pom.xml at top, showing dependency resolution).
- Configurations or resource files (the three BC JARs and the PDFBox JAR) under “External Libraries.”

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Top-level Build Configuration
    POM["pom.xml"]:::config

    %% CLI Launcher
    CLI["CLI Launcher"]:::module

    %% Feature Modules
    subgraph "Encryption Module"
        ENC_SYM["SymmetricEncryption"]:::module
        ENC_ASYM["AssymetricEncryption"]:::module
    end

    subgraph "Signing Module"
        SIGN_CLI["PDFSigner"]:::module
        SIGN_CORE["Sign"]:::module
    end

    subgraph "Verification Module"
        VERIFY["Verify"]:::module
    end

    subgraph "Decryption Module"
        DECRYPT["PDFDecrypter"]:::module
    end

    subgraph "Brute-Force Module"
        BRUTE["UnencryptBruteforce"]:::module
    end

    subgraph "Timestamping Module"
        TSA["OSCP_TSA"]:::module
    end

    %% Key Management
    KEY["PrivateKeyAccess"]:::module

    %% External Libraries
    subgraph "External Libraries"
        BC_PROV["BouncyCastle Provider"]:::lib
        BC_PKIX["BouncyCastle PKIX"]:::lib
        BC_UTIL["BouncyCastle Utilities"]:::lib
        PDFBOX["Apache PDFBox"]:::lib
    end

    %% File System
    FS["File System\n(PDF I/O, Key Store)"]:::fs

    %% Connections
    POM -->|manages dependencies| BC_PROV
    POM --> BC_PKIX
    POM --> BC_UTIL
    POM --> PDFBOX

    CLI -->|invokes| ENC_SYM
    CLI -->|invokes| ENC_ASYM
    CLI -->|invokes| SIGN_CLI
    CLI -->|invokes| VERIFY
    CLI -->|invokes| DECRYPT
    CLI -->|invokes| BRUTE
    CLI -->|invokes| TSA

    ENC_SYM -->|uses| PDFBOX
    ENC_SYM -->|uses| BC_PROV
    ENC_ASYM -->|uses| KEY
    ENC_ASYM -->|uses| PDFBOX
    ENC_ASYM -->|uses| BC_PROV

    SIGN_CLI -->|delegates to| SIGN_CORE
    SIGN_CLI -->|uses| PDFBOX
    SIGN_CORE -->|uses| KEY
    SIGN_CORE -->|uses| BC_PROV

    VERIFY -->|uses| PDFBOX
    VERIFY -->|uses| KEY
    VERIFY -->|uses| BC_PROV

    DECRYPT -->|uses| PDFBOX
    DECRYPT -->|uses| KEY
    DECRYPT -->|uses| BC_PROV

    BRUTE -->|uses| PDFBOX
    BRUTE -->|uses| BC_PROV

    TSA -->|uses| PDFBOX
    TSA -->|uses| BC_PKIX
    TSA -->|uses| BC_UTIL

    %% All modules output to File System or CLI
    ENC_SYM -->|outputs| FS
    ENC_ASYM -->|outputs| FS
    SIGN_CLI -->|outputs| FS
    VERIFY -->|outputs| FS
    DECRYPT -->|outputs| FS
    BRUTE -->|outputs| FS
    TSA -->|outputs| FS

    %% Click Events
    click ENC_SYM "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/SymmetricEncryption.java"
    click ENC_ASYM "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/AssymetricEncryption.java"
    click SIGN_CLI "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/PDFSigner.java"
    click SIGN_CORE "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/Sign.java"
    click VERIFY "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/Verify.java"
    click DECRYPT "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/PDFDecrypter.java"
    click BRUTE "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/UnencryptBruteforce.java"
    click TSA "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/OSCP_TSA.java"
    click KEY "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/java/PrivateKeyAccess.java"
    click BC_PROV "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/resources/bcprov-ext-jdk18on-173.jar"
    click BC_PKIX "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/resources/bcpkix-jdk18on-173.jar"
    click BC_UTIL "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/resources/bcutil-jdk18on-173.jar"
    click PDFBOX "https://github.com/joaopsoliveira03/estg-ca/blob/main/src/main/resources/pdfbox-app-3.0.0-alpha3.jar"
    click POM "https://github.com/joaopsoliveira03/estg-ca/blob/main/pom.xml"

    %% Styles
    classDef module fill:#D6EAF8,stroke:#2874A6,color:#1B4F72,stroke-width:1px
    classDef lib fill:#E8DAEF,stroke:#884EA0,color:#4A235A,stroke-width:1px,stroke-dasharray: 5 5
    classDef fs fill:#FADBD8,stroke:#C0392B,color:#641E16,stroke-width:1px
    classDef config fill:#FCF3CF,stroke:#D4AC0D,color:#7D6608,stroke-width:1px
```
