# serdire/andriidrok1 architecture

> Architecture diagram of the GitHub repository serdire/andriidrok1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/serdire/andriidrok1
- Repository: https://github.com/serdire/andriidrok1

## Overview

This repository generates graphics for a personal profile page: a one-off photo-to-ASCII portrait and contribution/language graphics refreshed from GitHub data. The graph follows each generation path through its meaningful transformation stages to the SVG outputs. The scheduled stats trigger and font-inlining step are documented in the README or source docstrings; unsampled workflow wiring is not assumed.

Main entry points: [`scripts/generate_stats.py`](https://github.com/serdire/andriidrok1/blob/main/scripts/generate_stats.py) (GitHub data fetch), [`scripts/make_portrait.py`](https://github.com/serdire/andriidrok1/blob/main/scripts/make_portrait.py) (Image preparation), [`README.md`](https://github.com/serdire/andriidrok1/blob/main/README.md) (Profile README), [`scripts/embed_portrait_font.py`](https://github.com/serdire/andriidrok1/blob/main/scripts/embed_portrait_font.py) (Font inliner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portrait["Portrait generation"]
  node_portrait_prep["Image preparation<br/>[make_portrait.py]"]
  node_portrait_chars["ASCII conversion<br/>[make_portrait.py]"]
  node_portrait_svg["Portrait SVG builder<br/>[make_portrait.py]"]
  node_font_embed["Font inliner"]
end

subgraph group_stats["Profile statistics"]
  node_stats_fetch["GitHub data fetch<br/>[generate_stats.py]"]
  node_stats_summary["Contribution summary<br/>[generate_stats.py]"]
  node_stats_draw["Graphic rendering<br/>[generate_stats.py]"]
end

subgraph group_output["SVG outputs"]
  node_svg_files["Generated SVGs"]
  node_profile_page["Profile README<br/>[README.md]"]
end

node_visitor(("Page visitor"))
node_photo["Source photo"]
node_stats_schedule(("Daily scheduler"))
node_github["GitHub GraphQL API"]

node_photo -->|"prepares"| node_portrait_prep
node_portrait_prep -->|"converts"| node_portrait_chars
node_portrait_chars -->|"renders"| node_portrait_svg
node_portrait_svg -->|"writes portrait"| node_svg_files
node_font_embed -->|"inlines font"| node_svg_files
node_stats_schedule -->|"runs daily"| node_stats_fetch
node_stats_fetch -->|"queries"| node_github
node_github -->|"returns data"| node_stats_fetch
node_stats_fetch -->|"summarizes"| node_stats_summary
node_stats_summary -->|"renders"| node_stats_draw
node_stats_draw -->|"writes graphics"| node_svg_files
node_svg_files -->|"displays"| node_profile_page
node_profile_page -->|"shown to"| node_visitor

click node_portrait_prep "https://github.com/serdire/andriidrok1/blob/main/scripts/make_portrait.py"
click node_portrait_chars "https://github.com/serdire/andriidrok1/blob/main/scripts/make_portrait.py"
click node_portrait_svg "https://github.com/serdire/andriidrok1/blob/main/scripts/make_portrait.py"
click node_font_embed "https://github.com/serdire/andriidrok1/blob/main/scripts/embed_portrait_font.py"
click node_stats_fetch "https://github.com/serdire/andriidrok1/blob/main/scripts/generate_stats.py"
click node_stats_summary "https://github.com/serdire/andriidrok1/blob/main/scripts/generate_stats.py"
click node_stats_draw "https://github.com/serdire/andriidrok1/blob/main/scripts/generate_stats.py"
click node_profile_page "https://github.com/serdire/andriidrok1/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_portrait_prep,node_portrait_chars,node_portrait_svg,node_font_embed toneBlue
class node_stats_fetch,node_stats_summary,node_stats_draw toneAmber
class node_svg_files,node_profile_page,node_github toneMint
class node_visitor,node_photo toneIndigo
class node_stats_schedule toneRose
```

## Components

### Portrait generation

- [Image preparation](https://github.com/serdire/andriidrok1/blob/main/scripts/make_portrait.py): `scripts/make_portrait.py`
- [ASCII conversion](https://github.com/serdire/andriidrok1/blob/main/scripts/make_portrait.py): `scripts/make_portrait.py`
- [Portrait SVG builder](https://github.com/serdire/andriidrok1/blob/main/scripts/make_portrait.py): `scripts/make_portrait.py`
- [Font inliner](https://github.com/serdire/andriidrok1/blob/main/scripts/embed_portrait_font.py): `scripts/embed_portrait_font.py`

### Profile statistics

- [GitHub data fetch](https://github.com/serdire/andriidrok1/blob/main/scripts/generate_stats.py): `scripts/generate_stats.py`
- [Contribution summary](https://github.com/serdire/andriidrok1/blob/main/scripts/generate_stats.py): `scripts/generate_stats.py`
- [Graphic rendering](https://github.com/serdire/andriidrok1/blob/main/scripts/generate_stats.py): `scripts/generate_stats.py`

### SVG outputs

- **Generated SVGs**
- [Profile README](https://github.com/serdire/andriidrok1/blob/main/README.md): `README.md`

### Other components

- **Page visitor**
- **Source photo**
- **Daily scheduler**
- **GitHub GraphQL API**

## Connections

- Source photo → Image preparation: prepares (evidence: `scripts/make_portrait.py`)
- Image preparation → ASCII conversion: converts (evidence: `scripts/make_portrait.py`)
- ASCII conversion → Portrait SVG builder: renders (evidence: `scripts/make_portrait.py`)
- Portrait SVG builder → Generated SVGs: writes portrait (evidence: `scripts/make_portrait.py`)
- Font inliner → Generated SVGs: inlines font (evidence: `scripts/embed_portrait_font.py`)
- Daily scheduler → GitHub data fetch: runs daily (evidence: `README.md`)
- GitHub data fetch → GitHub GraphQL API: queries (evidence: `scripts/generate_stats.py`)
- GitHub GraphQL API → GitHub data fetch: returns data (evidence: `scripts/generate_stats.py`)
- GitHub data fetch → Contribution summary: summarizes (evidence: `scripts/generate_stats.py`)
- Contribution summary → Graphic rendering: renders (evidence: `scripts/generate_stats.py`)
- Graphic rendering → Generated SVGs: writes graphics (evidence: `scripts/generate_stats.py`)
- Generated SVGs → Profile README: displays (evidence: `README.md`)
- Profile README → Page visitor: shown to (evidence: `README.md`)
