CodeByMathabo/Kaizen-Flow

A "Self-Healing" system to replace manual human intervention to solve the "System is offline" problem at the South African Department of Home Affairs. # Kaizen Flow A automated system recovery for distributed networks of the South African Department of Home Affairs(DHA). --- ### The Problem: DHA "The System is Offline" At the South African Department of Home Affairs (DHA), citizens are frequently turned away due to "offline" systems. The reality is rarely a permanently destroyed server; it is often a localized connection timeout, a network drop from load-shedding, or an unoptimized server load. Currently, when a service hangs, it stays down until an IT technician manually resets it, causing hours of downtime. --- ### The Solution: Kaizen Flow Kaizen Flow is a localized, DevOps proof-of-concept demonstrating how to replace manual IT intervention with automated system recovery using modern infrastructure-as-code practices. Instead of writing complex applications, this project relies entirely on structured containerization and localized Bash scripting to monitor and auto-heal a simulated network. --- ### The Architecture The project spins up a private Docker network containing two lightweight Ubuntu nodes: 1. **Central System:** A simulated central database running an Nginx web server. 2. **Local Branch:** A remote node running a continuous monitoring Bash script. **The Automation:** If the Central System becomes offline, the Local Branch detects the failed ping instantly. It then reaches through the mounted Docker socket to execute a recovery sequence, rebooting the central server without human intervention. --- ### How to run: **Prerequisites:** - Docker and Docker Compose installed. - A Linux environment (or WSL on Windows). **1. Clone the repository** ```bash git clone github.com cd kaizen-flow ``` **2. Launch the Infrastructure** ```bash docker compose up -d --build ``` **3. View the Dashboard** Once the containers are running, open your web browser and navigate to: `localhost` to view the simulated DHA Central System gateway. > **What is th …