Getting Started

Welcome to the MPAC SmartPOS Cloud Platform documentation. This guide will help you navigate the project and get up and running.

Project Structure

MPAC is a monorepo with git submodules managing a payment processing platform:

Submodule	Purpose	Tech Stack
mpac-pgw	Payment gateway service	Go 1.24, Gin, GORM, PostgreSQL 16, Redis 7
mpac-infra	AWS infrastructure	CloudFormation YAML
mpac-obs	Observability stack	Alloy, Prometheus, Loki, Tempo, Grafana

Quick Start

Payment Gateway (mpac-pgw)

cd mpac-pgw
make docker-up         # Start PostgreSQL + Redis
make migrate           # Apply database migrations
make run               # Run server (port 8080)
make test              # All tests with coverage

Infrastructure (mpac-infra)

cd mpac-infra
make lint              # cfn-lint validation
make validate          # Validate via AWS API
make deploy-pgw-dev    # Deploy PGW to dev
make status            # Check stack status

Observability (mpac-obs)

cd mpac-obs
make up                # Start local observability stack
make down              # Stop stack
make logs              # Tail all logs

Onboarding Path

For New Developers

1. Read the Product Overview
2. Understand the System Architecture
3. Explore the relevant Business Domains
4. Review the Technical Architecture

For Feature Development

1. Find your domain in the Domain Catalog
2. Check the API Reference
3. Review Database Architecture
4. Consult the Testing Strategy

For DevOps/SRE

1. Review AWS Infrastructure
2. Understand the Deployment Strategy
3. Check Observability
4. Review the CI/CD Pipeline

Next Steps

• Architecture Overview - System diagrams and multi-tenant hierarchy
• SDK Quick Start - Integrate payments with JS, Go, or Python
• API Reference - Full endpoint documentation