Technical Blueprint

High-Level
Architecture

System design, component interactions, and infrastructure overview for the QWIKO home interior maintenance platform.

System Design

Platform Architecture Overview

QWIKO is built on a layered, microservices-inspired architecture ensuring scalability, maintainability, and rapid feature delivery. The platform connects homeowners, service professionals, and administrators through a unified digital backbone.

Client Layer
๐Ÿ“ฑ
Mobile App
iOS & Android (React Native)
๐ŸŒ
Web App
Progressive Web App (Next.js)
๐Ÿ”ง
Pro Dashboard
Service provider portal
โš™๏ธ
Admin Panel
Operations & analytics
API Gateway
๐Ÿ›ก๏ธ
API Gateway
Auth, rate limiting, routing (Kong / NGINX)
๐Ÿ”
Auth Service
JWT, OAuth 2.0, OTP via Firebase
๐Ÿ“ก
WebSocket Server
Real-time job tracking & chat
Core Services
๐Ÿ“‹
Booking Service
Job creation, scheduling, status lifecycle
๐Ÿ‘ฅ
User Service
Profiles, preferences, KYC
๐Ÿ”
Search & Match
Geo-based pro discovery, availability
๐Ÿ’ฐ
Payment Service
Razorpay / Stripe, escrow, payouts
โญ
Review Service
Ratings, feedback, reputation scoring
๐Ÿ””
Notification Service
Push, SMS (Exotel), Email
Data Layer
๐Ÿ—„๏ธ
PostgreSQL
Core transactional data, bookings, users
โšก
Redis
Session cache, job queues, geo-index
๐Ÿ”Ž
Elasticsearch
Full-text & geo search, pro listings
๐Ÿ“ฆ
S3 / Object Store
Images, documents, job media
Infra Layer
โ˜๏ธ
Cloud Hosting
AWS / GCP, auto-scaling groups
๐Ÿณ
Containers
Docker + Kubernetes (EKS/GKE)
๐Ÿ”„
CI/CD Pipeline
GitHub Actions, blue-green deploys
๐Ÿ“Š
Observability
Prometheus, Grafana, Sentry
Request Lifecycle

How a Booking Flows Through the System

From homeowner request to job completion, every interaction passes through defined service boundaries with full auditability.

1
Request
Homeowner submits service request via app/web
2
Match
Search engine geo-matches nearby verified pros
3
Quote
Pro reviews job details and submits a quote
4
Confirm
Homeowner accepts; payment is held in escrow
5
Execute
Pro completes job; real-time status updates sent
6
Close
Payment released; review collected; records updated

Component Details

Core Platform Modules

Each module is independently deployable and communicates over well-defined REST/gRPC APIs and async message queues.

๐Ÿ“‹
Booking Engine
Core Service

Manages the full lifecycle of a service request โ€” creation, assignment, status transitions, cancellations, and rescheduling with conflict resolution.

Node.js PostgreSQL Redis Queue
๐Ÿ”
Smart Matching
Discovery Service

Geo-spatial search across service professionals filtered by skill, availability, rating, and distance. Uses PostGIS and Elasticsearch for sub-100ms results.

Elasticsearch PostGIS Redis Geo
๐Ÿ’ฐ
Payment & Escrow
Financial Service

Handles payment collection, escrow holding, automatic release on job completion, refund workflows, and automated payouts to service professionals.

Razorpay Stripe Webhook Events
๐Ÿ””
Notification Hub
Comms Service

Unified notification dispatching via push (FCM/APNS), SMS (Exotel/Twilio), and email (SendGrid). Event-driven triggers through message queue.

FCM / APNS Exotel SendGrid RabbitMQ
๐Ÿ“Š
Analytics Engine
Insights Service

Real-time operational metrics and business intelligence โ€” booking conversion funnels, pro utilisation, revenue analytics, and SLA monitoring.

Metabase Grafana BigQuery
๐Ÿ›ก๏ธ
Trust & Safety
Compliance Module

KYC verification for professionals, fraud detection on transactions, dispute resolution workflows, and community reporting mechanisms.

Aadhaar API DigiLocker ML Scoring

Infrastructure

Deployment & Technology Stack

Production-grade infrastructure designed for 99.9% uptime with auto-scaling and zero-downtime deployments.

Component Technology Purpose Status
Web & Mobile Frontend Next.js + React Native PWA + iOS/Android client applications Planned
API Gateway Kong / NGINX Rate limiting, routing, auth enforcement Planned
Backend Services Node.js (TypeScript) Core microservices โ€” booking, user, payment Planned
Primary Database PostgreSQL 15 + PostGIS Transactional data, geo queries Planned
Cache & Queues Redis 7 Session store, job queues, pub/sub Planned
Search Elasticsearch 8 Full-text & geo-spatial pro discovery Planned
Media Storage AWS S3 / Cloudflare R2 User uploads, job photos, documents Planned
Containerisation Docker + Kubernetes Orchestrated microservice deployment Planned
CI/CD GitHub Actions Automated test, build & deploy pipeline Planned
Monitoring Prometheus + Grafana Metrics, alerts, SLA dashboards Planned
Error Tracking Sentry Real-time error reporting & triage Planned
CDN Cloudflare Global edge caching, DDoS protection Evaluating