SysGuru logo

SysGuru™

Case Study • AWS Microservices • Payments & KYC • React‑Native

NNAKKI — Beauty services platform at scale

From concept to production: SysGuru™ designed and built a secure, resilient platform for bookings, payments, provider onboarding and chat — optimized for the African market.

Overview

NNAKKI connects customers with beauty professionals. The platform supports discovery, booking, payments, provider onboarding (KYC) and in‑app messaging, with admin oversight and audit trails.

  • Multi‑service architecture: User, Payments, Calendar, Catalogue.
  • Role‑based access (guest, customer, provider, admin).
  • Secure document uploads to S3 with signed read URLs.
  • Email/SMS notifications and moderation workflows.

Outcomes

  • Fast booking flow with calendar availability & conflict checks.
  • Automated payment split and payout to providers.
  • Reduced fraud exposure via KYC and webhook verification.
  • Operational visibility with structured logs & metrics.
Launched pilot in South Africa
Architecture

AWS reference implementation

S3/CloudFront hosts the web app and asset delivery. API Gateway fronts Lambda/ECS services. Data spans RDS/DynamoDB with SQS/SNS events. Security via IAM, WAF, KMS and signed URLs. CI/CD via GitHub Actions.

S3 + CloudFront API Gateway Lambda/ECS RDS/DynamoDB IAM/KMS/WAF SQS/SNS CloudWatch OpenTelemetry

Bookings & Calendar

Double‑booking prevention, rescheduling, status transitions (PENDING, BOOKED, COMPLETED, DISPUTED) and reminders.

Payments & Payouts

Paystack sub‑accounts, split charges, refunds and webhooks. Admin approvals and payout records for audit.

KYC & Documents

Secure uploads to S3, signed read URLs for preview, email notifications and admin review queues.

Chat

Booking‑scoped chat windows, provider/client roles, admin ability to assist and enforce guidelines.

Observability

Correlation IDs, structured logs, dashboards and alerts for errors, latency and payment exceptions.

Mobile‑first UX

React‑Native app with web support, image tiles, modals and accessible forms for onboarding and booking.

Tech stack

Selected components

  • Back‑end: Java Spring Boot microservices (User, Payments, Calendar, Catalogue)
  • Front‑end: React‑Native (mobile + web), role‑based routing & modals
  • AWS: API Gateway, Lambda/ECS, S3 (signed URLs), RDS/DynamoDB, SQS/SNS, CloudWatch
  • Payments: Paystack (sub‑accounts, split payments, webhooks, payouts)
  • Security: IAM, WAF, KMS, OAuth/JWT, audit logs, least privilege
  • Tooling: GitHub Actions CI/CD, Infrastructure as Code where applicable

Request a deeper walkthrough