# kaitola/facebookcorpus architecture

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

- Interactive diagram: https://gitdiagram.com/kaitola/facebookcorpus
- Repository: https://github.com/kaitola/facebookcorpus

## Overview

##### Main Components

a) Client Layer:
- Web Browser Interface
- PHP Frontend Components (index.php)

b) Application Layer:
- Facebook Authentication Module (FacebookLogin.php)
- Corpus Processing Module (CorpusCrawler.php)
- Data Parser Module (JsonParser.php)
- Main Corpus Handler (corpus.php)

c) External Services:
- Facebook Graph API
- Facebook OAuth Service

d) Facebook SDK Integration Layer:
- Authentication Components
- HTTP Clients
- Graph Node Handlers
- File Upload Handlers

##### User Flow
Browser -> Frontend -> Facebook Login -> Facebook OAuth

##### Data Flow
Facebook Graph API -> SDK Components -> Corpus Crawler -> JSON Parser -> Frontend Display

##### Detailed Component Breakdown

Frontend Layer (Blue):

- Web Interface  |
- index.php   |

Application Layer (Green):

- Facebook Login   |     | Corpus Crawler   |     | JSON Parser    |
- Management      |     | Data Retrieval   |     | Data Processing|

SDK Integration Layer (Purple):

- Authentication   |     | HTTP Clients     |     | Graph Nodes    |
- Components      |     | & Requests       |     | & Responses    |

External Services (Orange):

- Facebook         |     | Facebook         |
- Graph API        |     | OAuth Service    |

##### Important Elements to Highlight

- Authentication flow between the application and Facebook
- Data retrieval process from Facebook Pages
- JSON parsing and data transformation pipeline
- Error handling and exception flows
- Session management and token storage

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef frontend fill:#a8d1f0,stroke:#000
    classDef application fill:#90EE90,stroke:#000
    classDef external fill:#FFB347,stroke:#000
    classDef sdk fill:#DDA0DD,stroke:#000

    %% Client Layer
    subgraph ClientLayer
        Browser["Web Browser"]:::frontend
        Frontend["Frontend Interface"]:::frontend
    end

    %% Application Layer
    subgraph AppLayer
        FBLogin["Facebook Authentication Module"]:::application
        CorpusCrawler["Corpus Processing Module"]:::application
        JsonParser["Data Parser Module"]:::application
        CorpusHandler["Main Corpus Handler"]:::application
    end

    %% SDK Integration Layer
    subgraph SDKLayer
        AuthComp["SDK Authentication Components"]:::sdk
        HTTPClient["SDK HTTP Clients"]:::sdk
        GraphNode["SDK Graph Node Handlers"]:::sdk
        FileUpload["SDK File Upload Handlers"]:::sdk
        CoreClient["SDK Core Client"]:::sdk
        ExceptionHandler["SDK Exception Handler"]:::sdk
        HelperComp["SDK Helper Components"]:::sdk
    end

    %% External Services
    subgraph ExternalServices
        GraphAPI["Facebook Graph API"]:::external
        OAuth["Facebook OAuth Service"]:::external
    end

    %% Relationships
    Browser --> Frontend
    Frontend --> FBLogin
    FBLogin --> OAuth
    FBLogin --> AuthComp
    CorpusCrawler --> HTTPClient
    HTTPClient --> GraphAPI
    GraphAPI --> GraphNode
    GraphNode --> JsonParser
    JsonParser --> CorpusHandler
    CorpusHandler --> Frontend
    CoreClient --> HTTPClient
    ExceptionHandler -.-> AuthComp
    ExceptionHandler -.-> HTTPClient
    HelperComp -.-> AuthComp
    FileUpload -.-> CoreClient

    %% Click Events
    click Frontend "https://github.com/kaitola/FacebookCorpus/blob/master/index.php"
    click FBLogin "https://github.com/kaitola/FacebookCorpus/blob/master/FacebookLogin.php"
    click CorpusCrawler "https://github.com/kaitola/FacebookCorpus/blob/master/CorpusCrawler.php"
    click JsonParser "https://github.com/kaitola/FacebookCorpus/blob/master/JsonParser.php"
    click CorpusHandler "https://github.com/kaitola/FacebookCorpus/blob/master/corpus.php"
    click AuthComp "https://github.com/kaitola/FacebookCorpus/tree/master/facebook-php-sdk-v4-5.0-dev/src/Facebook/Authentication"
    click HTTPClient "https://github.com/kaitola/FacebookCorpus/tree/master/facebook-php-sdk-v4-5.0-dev/src/Facebook/HttpClients"
    click GraphNode "https://github.com/kaitola/FacebookCorpus/tree/master/facebook-php-sdk-v4-5.0-dev/src/Facebook/GraphNodes"
    click FileUpload "https://github.com/kaitola/FacebookCorpus/tree/master/facebook-php-sdk-v4-5.0-dev/src/Facebook/FileUpload"
    click CoreClient "https://github.com/kaitola/FacebookCorpus/blob/master/facebook-php-sdk-v4-5.0-dev/src/Facebook/FacebookClient.php"
    click ExceptionHandler "https://github.com/kaitola/FacebookCorpus/tree/master/facebook-php-sdk-v4-5.0-dev/src/Facebook/Exceptions"
    click HelperComp "https://github.com/kaitola/FacebookCorpus/tree/master/facebook-php-sdk-v4-5.0-dev/src/Facebook/Helpers"

    %% Legend
    subgraph Legend
        Frontend_L["Frontend Components"]:::frontend
        App_L["Application Components"]:::application
        SDK_L["SDK Components"]:::sdk
        External_L["External Services"]:::external
    end
```
