# fastfire/deepdarkcti architecture

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

- Interactive diagram: https://gitdiagram.com/fastfire/deepdarkcti
- Repository: https://github.com/fastfire/deepdarkcti

## Overview

##### Project type and purpose
- deepdarkCTI is not a traditional multi-tier application but a content-centric, static documentation site.
- It collects and organizes Cyber Threat Intelligence (CTI) sources from Deep/Dark Web channels as Markdown files and publishes them as a browsable website.
- Contributors propose new sources (via Telegram, Twitter) and update the repository; end users (CTI analysts) consume the published site.

##### File structure
- Top-level items: LICENSE, README.md, and a set of category files (counterfeit_goods.md, telegram_infostealer.md, ransomware_gang.md, etc.).
- No “src” or “backend” code—content only.
- Implied use of a static site generator (Jekyll, Hugo) and GitHub Pages (or similar) for hosting.
- No explicit build scripts present, but standard GitOps CI/CD (e.g., GitHub Actions) is a best practice here.

##### README for insights
- Describes project goal, categories of sources, contribution workflow, external community channels (Telegram group), and donation integration.

##### Main components
a. Content Source Layer
- GitHub Repository (Markdown files grouped by CTI category)
- Contributors (via pull requests)
b. Build/Deployment Layer
- CI/CD Pipeline (GitHub Actions or equivalent)
- Static Site Generator (Jekyll/Hugo)
c. Hosting & Delivery Layer
- Hosting Platform (GitHub Pages / Netlify / Vercel)
- CDN (optional layer for performance)
d. Integration & Community Layer
- Telegram Group API (source proposals, discussion)
- Twitter Account (announcements, access requests)
- BuyMeACoffee (donation widget)
e. Consumers
- CTI Analysts / General Users browsing the published site

##### Relationships & Data Flows
- Contributors push updates → GitHub Repo
- GitHub Repo change triggers → CI/CD Pipeline
- Pipeline runs Static Site Generator → produces static HTML/CSS/JS
- Pipeline deploys → Hosting Platform (GitHub Pages)
- End Users → browse the site via web
- Users / Contributors → interact via Telegram & Twitter
- Users → donate via BuyMeACoffee widget embedded on site

##### Architectural patterns & design principles
- Content-as-Code: treat Markdown files as versioned source
- GitOps: repository-driven deployment
- Static Site Generation: simple, low-ops, highly cacheable
- Separation of concerns: content, build, deploy, consume

- GitHub (Repo + Actions)
- Jekyll or Hugo (static site generator)
- GitHub Pages / Netlify / Vercel (hosting/CDN)
- Telegram API, Twitter API
- BuyMeACoffee embed

## Diagram (Mermaid)

```mermaid
graph TD
    %% Actors
    Contrib["Contributors"]:::actor
    Users["CTI Analysts / End Users"]:::actor

    %% Content & Repo
    Repo["GitHub Repository"]:::content
    subgraph "CTI Content (Markdown Files)"
        COMM["commercial_services.md"]:::content
        COUT["counterfeit_goods.md"]:::content
        CVE["cve_most_exploited.md"]:::content
        DEFACE["defacement.md"]:::content
        DISCORD["discord.md"]:::content
        EXPLOITS["exploits.md"]:::content
        FORUM["forum.md"]:::content
        MAAS["maas.md"]:::content
        MARKETS["markets.md"]:::content
        METHODS["methods.md"]:::content
        OTHERS["others.md"]:::content
        PHISH["phishing.md"]:::content
        RANSOM["ransomware_gang.md"]:::content
        RAT["rat.md"]:::content
        SEARCH["search_engines.md"]:::content
        TELE_INFO["telegram_infostealer.md"]:::content
        TELE_TACTORS["telegram_threat_actors.md"]:::content
        TWIT["twitter.md"]:::content
        TWIT_TACTORS["twitter_threat_actors.md"]:::content
    end
    README["README.md"]:::content
    LICENSE["LICENSE"]:::content

    %% Build & Deploy
    CICD["CI/CD Pipeline (GitHub Actions)"]:::build
    SSG["Static Site Generator (Jekyll/Hugo)"]:::build

    %% Hosting & Delivery
    Host["Hosting Platform (GitHub Pages/Netlify/Vercel)"]:::hosting
    CDN["CDN (optional)"]:::hosting

    %% External Integrations
    Telegram["Telegram Group API"]:::external
    Twitter["Twitter API"]:::external
    Donate["BuyMeACoffee Widget"]:::external

    %% Flows
    Contrib -->|"git push / PR"| Repo
    Repo -->|"trigger build"| CICD
    CICD -->|"generate site"| SSG
    SSG -->|"deploy"| Host
    Host -->|"served via CDN"| CDN
    CDN -->|"HTTP(s) response"| Users

    Contrib <-->|"discuss / propose new sources"| Telegram
    Contrib <-->|"discuss / propose new sources"| Twitter
    Users <-->|"discuss / propose new sources"| Telegram
    Users <-->|"discuss / propose new sources"| Twitter
    Users -->|"payment"| Donate

    %% Associations
    Repo --- COMM
    Repo --- COUT
    Repo --- CVE
    Repo --- DEFACE
    Repo --- DISCORD
    Repo --- EXPLOITS
    Repo --- FORUM
    Repo --- MAAS
    Repo --- MARKETS
    Repo --- METHODS
    Repo --- OTHERS
    Repo --- PHISH
    Repo --- RANSOM
    Repo --- RAT
    Repo --- SEARCH
    Repo --- TELE_INFO
    Repo --- TELE_TACTORS
    Repo --- TWIT
    Repo --- TWIT_TACTORS
    Repo --- README
    Repo --- LICENSE

    %% Click Events
    click Repo "https://github.com/fastfire/deepdarkcti/tree/main//"
    click README "https://github.com/fastfire/deepdarkcti/blob/main//README.md"
    click LICENSE "https://github.com/fastfire/deepdarkcti/tree/main//LICENSE"
    click COMM "https://github.com/fastfire/deepdarkcti/blob/main//commercial_services.md"
    click COUT "https://github.com/fastfire/deepdarkcti/blob/main//counterfeit_goods.md"
    click CVE "https://github.com/fastfire/deepdarkcti/blob/main//cve_most_exploited.md"
    click DEFACE "https://github.com/fastfire/deepdarkcti/blob/main//defacement.md"
    click DISCORD "https://github.com/fastfire/deepdarkcti/blob/main//discord.md"
    click EXPLOITS "https://github.com/fastfire/deepdarkcti/blob/main//exploits.md"
    click FORUM "https://github.com/fastfire/deepdarkcti/blob/main//forum.md"
    click MAAS "https://github.com/fastfire/deepdarkcti/blob/main//maas.md"
    click MARKETS "https://github.com/fastfire/deepdarkcti/blob/main//markets.md"
    click METHODS "https://github.com/fastfire/deepdarkcti/blob/main//methods.md"
    click OTHERS "https://github.com/fastfire/deepdarkcti/blob/main//others.md"
    click PHISH "https://github.com/fastfire/deepdarkcti/blob/main//phishing.md"
    click RANSOM "https://github.com/fastfire/deepdarkcti/blob/main//ransomware_gang.md"
    click RAT "https://github.com/fastfire/deepdarkcti/blob/main//rat.md"
    click SEARCH "https://github.com/fastfire/deepdarkcti/blob/main//search_engines.md"
    click TELE_INFO "https://github.com/fastfire/deepdarkcti/blob/main//telegram_infostealer.md"
    click TELE_TACTORS "https://github.com/fastfire/deepdarkcti/blob/main//telegram_threat_actors.md"
    click TWIT "https://github.com/fastfire/deepdarkcti/blob/main//twitter.md"
    click TWIT_TACTORS "https://github.com/fastfire/deepdarkcti/blob/main//twitter_threat_actors.md"

    %% Styles
    classDef content fill:#D0E6FF,stroke:#0366d6,color:#000;
    classDef build fill:#DFFFE0,stroke:#28a745,color:#000;
    classDef hosting fill:#EAD8FF,stroke:#6f42c1,color:#000;
    classDef external fill:#FFE4B2,stroke:#FF8C00,color:#000;
    classDef actor fill:#FFF0F5,stroke:#FF69B4,color:#000;
```
