# kafidas/just-text architecture

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

- Interactive diagram: https://gitdiagram.com/kafidas/just-text
- Repository: https://github.com/kafidas/just-text

## Overview

##### Project type and purpose
- This is an open-source data repository (“just-text”) that hosts plain-text extractions of Greek laws published in the Official Government Gazette (FEK A’).
- It also includes a Python extraction script (fekpdf2txt) under the subfolder **pdf-text-processing**.

##### File structure
- Top-level:
- **2021**, **2022**, **2023**, **2024** folders – each containing plain-text law files named by issue number (“nXXXX.txt”) and a **contents.txt** index.
- **pdf-text-processing/** – the Python script and its README for converting source PDFs to text.
- **README.md**, **LICENSE**, and repo metadata under **.github/**.
- No database or service code—data lives as flat files. The script folder is the only “executable” component.

##### Key insights from the README
- The extraction pipeline uses `fekpdf2txt_2024.py`.
- Source PDFs come from the National Printing House website.
- No downstream services or front-end; it’s a raw data supply.

##### Detail level
- Call out the year-folder hierarchy as part of the storage component.
- That the README and LICENSE are metadata in the GitHub layer.

## Diagram (Mermaid)

```mermaid
flowchart TD
    extPDF["Source PDFs"]:::external

    subgraph "Just-text Local Repository"
        direction TB

        subgraph "pdf-text-processing"
            direction TB
            script["Extraction Script\nfekpdf2text_2024.py"]:::process
            scriptDoc["Script README\nREADME.md"]:::process
        end

        subgraph "Year-based Text Files"
            direction TB
            y2021["2021/"]:::storage
            y2022["2022/"]:::storage
            y2023["2023/"]:::storage
            subgraph "2024 Batch"
                direction TB
                y2024["2024/"]:::storage
                y2024b["2024b/"]:::storage
            end
        end

        subgraph "Metadata"
            direction TB
            repoReadme["README.md"]:::version
            license["LICENSE"]:::version
            funding[".github/FUNDING.yml"]:::version
        end
    end

    github["GitHub Remote"]:::version

    extPDF -->|"input"| script
    script -->|"outputs text files"| y2021
    script --> y2022
    script --> y2023
    script --> y2024
    script --> y2024b
    repoReadme -->|"push changes"| github

    click script "https://github.com/kafidas/just-text/blob/main/pdf-text-processing/fekpdf2text_2024.py"
    click scriptDoc "https://github.com/kafidas/just-text/blob/main/pdf-text-processing/README.md"
    click y2021 "https://github.com/kafidas/just-text/tree/main/2021/"
    click y2022 "https://github.com/kafidas/just-text/tree/main/2022/"
    click y2023 "https://github.com/kafidas/just-text/tree/main/2023/"
    click y2024 "https://github.com/kafidas/just-text/tree/main/2024/"
    click y2024b "https://github.com/kafidas/just-text/tree/main/2024/2024b/"
    click repoReadme "https://github.com/kafidas/just-text/blob/main/README.md"
    click license "https://github.com/kafidas/just-text/tree/main/LICENSE"
    click funding "https://github.com/kafidas/just-text/blob/main/.github/FUNDING.yml"

    classDef external fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef process fill:#90EE90,stroke:#333,stroke-width:1px
    classDef storage fill:#FFFFE0,stroke:#333,stroke-width:1px
    classDef version fill:#F0E68C,stroke:#333,stroke-width:1px
```
