Skip to content

Instantly share code, notes, and snippets.

View bogorad's full-sized avatar

Eugene bogorad bogorad

View GitHub Profile
@bogorad
bogorad / devops-test-task.md
Last active January 14, 2026 13:54
reproducible infrastructure-as-code solution for secure, self-updating Hugo website server

The candidate's task is to build a reproducible infrastructure-as-code solution where Terraform provisions a Hetzner VPS and Cloudflare DNS, and Ansible configures a secure, self-updating Hugo website server.

Core Architecture

  1. Terraform (Infrastructure Layer)
    • Provider: hcloud (Hetzner) and cloudflare.
    • Compute: CX23 VPS (2 vCPU, 4GB RAM) in Nuremberg (nbg1).
    • Security:
      • Pre-configured SSH keys (referenced by name from Hetzner project).
  • Dedicated hcloud_firewall attached to the server allowing only TCP ports 22, 80, and 443.
@bogorad
bogorad / opencode.ps1
Last active January 13, 2026 13:19
Run opencode on windows using git-bash via server/client
# opencode.ps1 - Self-updating SST OpenCode wrapper (Windows)
<#
.SYNOPSIS
Self-updating wrapper for the SST OpenCode CLI on Windows.
.DESCRIPTION
This script manages the installation, update, and execution lifecycle of the opencode binary.
Key behaviors:
@bogorad
bogorad / dev-intro-str-forms.md
Created January 9, 2026 10:46
Developer Introduction to STR Forms

DEV-intro.md - Developer Introduction to STR Forms

Executive Summary

STR Forms is a multi-entity currency exchange ERP system built for local deployment (single Hetzner VPS). It handles transaction processing (5 types: exchange, expense, deposit, withdrawal, transfer), debt tracking, and financial reporting across multiple legal entities within a single organization. The system serves 4 user roles (admin, accountant, cashier, viewer) with role-based access control and entity-level data isolation.

Primary use case: Cashiers process currency exchanges at exchange bureaus. Accountants track expenses and generate P&L reports. Admins manage users, entities, wallets, and periods. Viewers (typically business owners) have read-only access to all reports.

Scale expectations: ~$1M daily transaction volume across 3 entities, 5-10 concurrent users. Single-tenant, single-instance deployment.

@bogorad
bogorad / 2026-01-08-hermes-bot-mvp-design.md
Last active January 10, 2026 15:41
# Hermes Bot MVP - Technical Design

Hermes Bot MVP - Technical Design

Date: 2026-01-08
Status: Approved
Version: 2.0 (Simplified - No Scraping Required)

Executive Summary

Hermes Bot is a subscription service that notifies customers when specific Hermes products become available in their chosen country. The system leverages shengsho.com's email notifications which already contain complete product data (name, price, SKU, direct Hermes URL, images) - eliminating the need for web scraping entirely.

@bogorad
bogorad / MIRYOKU-CHUCK.md
Created January 1, 2026 17:13
My current Miryoku modification architecture
@bogorad
bogorad / TR-ENERGY-Wallet-onboarding.md
Last active January 13, 2026 13:22
Wallet - Venue-Assisted Onboarding

TR.ENERGY Wallet - Venue-Assisted Onboarding

Document Type: Onboarding Flow Specification
Date: December 29, 2025
Status: READY FOR IMPLEMENTATION
Target: EU (MiCA) compliant, staff-assisted venue onboarding


EXECUTIVE SUMMARY

@bogorad
bogorad / 07_venue_booking_flow.md
Last active December 28, 2025 17:27
Flow 07: Venue Booking Flow

Flow 07: Venue Booking Flow

Purpose: Enable venue managers to discover and request artwork for display at their venues, with artist approval and delivery confirmation.

Actors:

  • Venue Manager - User with venue management rights via venueAdmins table
  • Artist - User with isArtist capability and artwork in draft status
  • System - Automated timeout processing and notification delivery
@bogorad
bogorad / direct-debit-ton-solana.md
Last active December 23, 2025 13:54
Compare TON and Solana approach for "direct debit"

Architectural Comparison: TON Actor Model vs. Solana Delegation

1. Executive Summary

This document contrasts two distinct architectural approaches for implementing automated cross-entity interactions (such as recurring payments or conditional transfers) on high-performance blockchains.

  • TON (The Open Network) employs an Actor Model where every wallet is a smart contract. Automation is achieved via asynchronous message passing and internal state transitions.
  • Solana employs a Delegation (Pull) Pattern on top of a stateless Account Model. Automation is achieved by authorizing a third-party system to execute transactions on your behalf.

The core difference lies in agency:

@bogorad
bogorad / wiki-to-groki.js
Last active December 18, 2025 12:56
userscript for TamperMonkey and the like - redirect wikipedia to grokipedia
// ==UserScript==
// @name Wikipedia to Grokipedia Redirector
// @namespace http://tampermonkey.net/
// @version 1.0
// @description Redirect to Grokipedia if page exists
// @author You
// @match https://en.wikipedia.org/wiki/*
// @connect grokipedia.com
// @grant GM_xmlhttpRequest
// @run-at document-start
@bogorad
bogorad / generate-host-key.sh
Created November 27, 2025 10:32
Auto-generate ssh+age keys for a new host, store in BitWarden, update SOPS config.
#!/usr/bin/env bash
set -euo pipefail
die() {
echo "$0: ERROR: $1" >&2
exit 1
}
log() {