Stageflow
Event-driven platform for orchestrating website accessibility scans using containerized services and real-time status tracking.
Executive Summary
Challenge: Build a production-grade distributed system for accessibility scanning without cloud dependencies or Docker daemons. Approach: Implemented Clean Architecture with strict layer separation—Domain models isolated from Infrastructure (PodmanClient, MinIO). Event-driven core uses NATS JetStream for async job orchestration with event envelopes standardizing payloads. Custom Finite State Machine enforces valid job transitions (created→extraction→scan→completed), preventing race conditions in concurrent workflows. Podman integration enables rootless, lightweight containerization for scanner isolation. Frontend in Next.js showcases real-time scan dashboards with shadcn/ui components. Outcomes: Zero architectural violations, comprehensive test suite (unit, integration, E2E with Testcontainers), full local deployment scripts. Innovation: FSM-driven state management + Podman orchestration demonstrates advanced system design without heavyweight tooling.
The Challenge
Automates accessibility scanning of websites via containerized, event-driven pipelines.
The Solution
Implemented Clean Architecture in Go for services, layering domain models over infra. Event-driven core uses NATS JetStream for payloads. Frontend in Next.js app router integrates scan status hooks.
System Architecture
Key Features
Job Orchestration
Website Extraction
Accessibility Scanning with Axe
Event-Driven Messaging
Real-Time Scan Status
Container Management
Object Storage
Portfolio Frontend
Technical Skills Matrix
Technologies
Business Value
- Automates manual workflows
- Improves consistency & quality
- Scalable architecture design
See Also
Clear11y
Clear11y is a Python-based tool for scanning websites or ZIP archives of static sites to detect accessibility violations via Axe rules and custom keyboard navigation checks. It generates consolidated HTML reports with Jinja templates.
AlchemizeCV
AlchemizeCV is a multi-service tool that processes GitHub repositories via CLI commands or web interface to produce structured analyses, resume bullets, and portfolio content using LLM providers.