DukaSmart

Overview

• DukaSmart demonstrates the combination of full-stack application development and cloud infrastructure automation. It delivers a multi-tenant POS application where retail businesses operate within isolated scopes, backed by declarative AWS infrastructure and automated Kubernetes deployment pipelines.

Architectural Data Flow

The Problem

• Retail operators managing multiple physical branches require a unified POS platform without cross-tenant data leaks or infrastructure deployment drift.

The Solution

• Engineered tenant scoping into the Laravel core application layer and codified AWS resource management in Terraform to ensure deterministic, zero-downtime container releases.

Architecture

• Application layer built with Laravel + PHP + MySQL enforcing tenant context globally across API requests.
• Multi-stage Docker builds creating light container images.
• Terraform provisioning AWS VPC networking, EC2 nodes, Security Groups, and IAM roles.
• Kubernetes managing high-availability pod deployment, internal DNS, and service rollouts.
• GitHub Actions executing CI/CD linting, image packaging, and automated cluster updates.

Technology Stack & Tools

Application Features

• Multi-tenant data isolation
• Role-based access control (RBAC)
• Inventory tracking & management
• Customer management & receipt logs
• AWS infrastructure provisioning
• Declarative Terraform IaC
• Docker containerization
• Kubernetes orchestration
• GitHub Actions CI/CD
• Deployment automation

Infrastructure & Containerization

• Terraform code defining AWS VPC subnets, internet gateways, and security boundaries.
• Docker images packaging the Laravel runtime and worker queues independently.
• Kubernetes Deployments and Services managing worker replica scaling and ingress traffic.

CI/CD & Deployment Pipeline

• GitHub Actions pipeline triggered on release branch updates.
• Container tags bound to git commit SHA hashes for version tracking and rollback confidence.

Engineering Highlights

• Multi-tenant architecture with global query scoping
• Role-based access control (RBAC)
• Inventory management & sales receipt processing
• Customer account tracking
• AWS infrastructure provisioned with Terraform
• Docker containerized runtime
• Kubernetes pod orchestration
• GitHub Actions deployment automation

Architectural Decisions

• Selected scoped shared-schema tenancy for high query performance and simplified database administration.
• Mandated Terraform as the exclusive path for cloud changes to maintain environment reproducibility.