🌐 Alexander Suvorov - Automated Technical Portfolio ^v3.4.3

Modern, self-updating technical portfolio showcasing expertise in Python development, system architecture, and open-source contributions. This isn't just a static site—it's a fully automated ecosystem that fetches live data and builds itself daily.

---

🤖 Zero-Cost Automated Static Site Generator

Serverless Static Site Generator with CI/CD:

🔄 How It Works

This site is fully automated — it builds and updates itself daily without any manual intervention or hosting costs!

🚀 Key Features

Feature	How It Works	Benefit
🤖 Fully Automated	GitHub Actions cron job runs daily	Always up-to-date, zero manual work
📦 Dynamic Content	Fetches live data from GitHub & PyPI APIs	Shows real repository/package info
⚡ Atomic Deployment	Generates all pages in temp directory first	Never broken site — all or nothing
🗺️ Auto Sitemap	Dynamically includes all pages	Perfect SEO, always current
💰 Zero Cost	Hosted on GitHub Pages	Only pay for domain name
🔒 Secure	No database, no backend	Static = unhackable

📊 By The Numbers

📚 Repository Pages: 53+ (and growing)
📦 Package Pages:   20+ PyPI packages
📄 Static Pages:    11 core pages
🤖 Updates:         Daily automatic
💸 Hosting Cost:    $0 (only domain)

🛠️ Tech Stack

# The magic happens here ↓
[
    "Python 3.8+",
    "GitHub Actions (CI/CD)",
    "Jinja2 Templating",
    "GitHub API v3",
    "PyPI JSON API",
    "Markdown parsing",
    "XML Sitemap generation",
    "Atomic file operations"
]

🎯 What It Does

1. Every day at midnight UTC, GitHub Actions wakes up
2. Fetches live data from GitHub and PyPI
3. Generates 60+ HTML pages in a temporary directory
4. Creates fresh sitemap.xml with all URLs
5. If ALL pages generate successfully — replaces old site atomically
6. If ANY error occurs — keeps old site untouched
7. Deploys to GitHub Pages automatically

💡 Why This Matters

"Build once, deploy manually" is so 2010.
"Build automatically, host for free" is 2026.

This architecture demonstrates that you can run a professional, dynamic-looking website with zero infrastructure costs, zero maintenance, and zero security headaches — just smart automation and free tier services.

---

Zero Cost • Zero Maintenance • Maximum Automation

---

🛠 Technology Stack: Under the Hood

Frontend: The User Experience

Technology	Purpose
HTML5	Semantic, accessible markup
CSS3	Custom properties, keyframe animations, responsive design
Bootstrap 5	Robust grid system and pre-built components
Bootstrap Icons	Consistent, lightweight icon set
Vanilla JavaScript (ES6+)	No bloat. Modular classes for particles, scroll, animations, and active nav.

Build System & Automation: The Engine

Tool/Library	Purpose
GitHub Actions	The cron job that runs the entire show daily.
Python 3.8+	Core language for all build scripts.
Jinja2	Powerful templating engine to generate 70+ detail pages from a single template.
BeautifulSoup4	Parses and surgically updates the main HTML files (projects.html, etc.) with fresh data.
Requests	Fetches data from GitHub, PyPI, and Dev.to APIs.
Markdown	Converts PyPI package descriptions from markdown to beautiful HTML for detail pages.
Pygments	Provides syntax highlighting for code blocks in those markdown descriptions.
Temporary Directory + shutil.move()	Implements the atomic deployment strategy.

Data Sources

Source	API Endpoint	Data Fetched
GitHub	api.github.com/users/smartlegionlab/repos	Repo names, descriptions, stars, forks, languages, topics, dates.
PyPI	pypi.org/pypi/{package_name}/json	Version, summary, full description (in markdown), project URLs.
Dev.to	dev.to/api/articles?username=smartlegionlab	Titles, descriptions, tags, reactions, comments, reading time.

---

📁 Project Structure: A Deep Dive

/
├── .github/workflows/
│   └── update_data.yml        # The daily cron job configuration
│
├── scripts/                    # The brains of the operation
│   ├── fetch_github.py         # Fetches repo data, handles errors
│   ├── fetch_devto.py          # Fetches article data
│   ├── fetch_pypi.py           # Fetches package data with rate limiting
│   ├── generate_pages.py       # Updates main pages (projects.html, etc.) with cards
│   └── generate_repo_pages.py  # THE BIG ONE: Generates 50+ detail pages + sitemap atomically
│
├── templates/                   # Templates for the detail pages
│   ├── repo_template.html       # Jinja2 template for every GitHub repo page
│   └── package_template.html    # Jinja2 template for every PyPI package page
│
├── data/                        # Auto-generated JSON data (cached from APIs)
│   ├── repos.json
│   ├── articles.json
│   └── pypi.json
│
├── js/                           # Modular front-end logic
│   ├── active-nav.js             # Highlights current page in navigation
│   ├── animation-manager.js      # Controls priority-based animations (avatar, scroll)
│   ├── particle-background.js    # Canvas-based animated tech word background
│   ├── scroll-manager.js         # Handles scroll-to-top button and progress bar
│   └── config.js                 # Global config (usernames, counters)
│
├── css/                          # Styles
│   ├── style.css                 # All custom styles (dark theme, cards, animations)
│   └── bootstrap/                # Full Bootstrap framework
│
├── repositories/                  # OUTPUT: Dynamically generated GitHub repo pages
│   ├── smartpasslib.html
│   ├── clipassman.html
│   └── ... (50+ files)
│
├── packages/                      # OUTPUT: Dynamically generated PyPI package pages
│   ├── smartpasslib.html
│   └── ... (20+ files)
│
├── research/                      # Research pages
│   ├── pointer-based-security.html
│   ├── local-data-regeneration.html
│   ├── deterministic-game-engine.html
│   └── position-candidate-hypothesis.html
│
├── index.html                     # Home page
├── about.html                     # Professional profile
├── projects.html                  # Main GitHub repo listing (auto-updated)
├── packages.html                  # Main PyPI package listing (auto-updated)
├── articles.html                  # Main Dev.to article listing (auto-updated)
├── research.html                  # Academic research overview
├── skills.html                    # Technical skills
└── sitemap.xml                    # AUTO-GENERATED sitemap for all 80+ pages

---

🎯 The Main Sections: What You'll See

• Hero Section: Professional introduction with key metrics (Experience, Projects, Repos).
• Professional Profile: Technical leadership, business impact, and published research.
• Research & Paradigms: Cards linking to detailed pages for groundbreaking concepts (Pointer-Based Security, PCH, etc.).
• Automated Project Showcase:
  • Projects (projects.html): A grid of GitHub repos with live stats (stars, forks), topics, and a "View" button linking to its dedicated detail page.
  • Packages (packages.html): A grid of PyPI packages with descriptions, version badges, and a one-click pip install button that copies the command to your clipboard.
  • Articles (articles.html): A grid of Dev.to articles with engagement metrics.
• Detailed Project, Package and Research Pages:
  • Repository Pages (/repositories/*.html): A full-page deep dive into a single repo, including all metadata, topics, and a direct link to GitHub.
  • Package Pages (/packages/*.html): A full-page view of a PyPI package, showing its full README (markdown rendered!), version, and a "View on PyPI" link.
  • Research Pages (/research/*.html): A full-page view of a research paradigms.

---

🚀 Local Development & Manual Build

You can run the entire build process locally to test changes.

Prerequisites

• Python 3.8+
• Git

Setup & Build

1. Clone the repository

   git clone https://github.com/smartlegionlab/smartlegionlab.github.io.git
   cd smartlegionlab.github.io

2. Install Python dependencies

   pip install -r scripts/requirements.txt

3. Run the full build pipeline (in the correct order)

   # 1. Fetch the latest data from all sources
   python scripts/fetch_github.py
   python scripts/fetch_devto.py
   python scripts/fetch_pypi.py
   
   # 2. Update the main listing pages (projects.html, etc.) with new data cards
   python scripts/generate_pages.py
   
   # 3. **Generate all 70+ detail pages AND the sitemap atomically**
   #    This script handles the atomic swap, so it's safe to run.
   python scripts/generate_repo_pages.py

4. Preview the site locally

   python -m http.server 8000

   Open your browser to http://localhost:8000. You'll see the fully built site, including all generated pages in the repositories/ and packages/ folders.

---

📄 License

This project is licensed under the BSD 3-Clause License. See the LICENSE file for details.

---

📬 Connect with Alexander Suvorov

• 🌐 Portfolio: smartlegionlab.ru
• 🎓 Academic Work: alexander-suvorov.ru
• 💻 GitHub: @smartlegionlab
• 📝 Dev.to Blog: @smartlegionlab
• 📦 PyPI Packages: @smartlegionlab

---

_{Built with ❤️ by Alexander Suvorov
© 2026 Alexander Suvorov. All rights reserved.}