Concept Document — MapWhirl AI Solutions

Platform Overview

MapWhirl AI Solutions is a multi-app SaaS platform targeting small businesses and individuals. All apps run on a single AWS Lightsail instance behind Nginx reverse proxy, containerised via Docker Compose.

Host	AWS Lightsail (ca-central-1)
IP	3.98.6.180
Domain	api.mapwhirlsoftwaresolutions.com
Proxy	Nginx (services.conf)
Orchestration	Docker Compose
Database	AWS RDS PostgreSQL (ca-central-1)

Tech Stack

Backend: .NET 8 / C# APIs (Kestrel)

Frontend: Blazor WebAssembly, Static HTML/JS

AI/LLM: Claude (Anthropic), OpenAI, Gemini

Infra: Docker, Nginx, AWS Lightsail + RDS

Storage: PostgreSQL, local volumes, Google Drive API

Auth: JWT + session-based, per-service

App Inventory

App	Domain	Container	Port	API Route	Status
AI Tutor	AI	`platform-ai-tutor`	8010	/api/ai-tutor/	● Live
Thought2App	AI	`platform-thought2app`	8020	/api/thought2app/	● Live
NutriFusion	Healthcare	`platform-nutrifusion`	8030	/api/nutrifusion/	● Live
Food Advice AI	Healthcare	`platform-food-advice`	8031	/api/food-advice/	● Live
Smart Groceries	Healthcare	`platform-groceries`	8032	/api/groceries/	● Live
PersonalHub	Productivity	`platform-user-service`	8001	/api/v1/personalhub/	● Live
Todo App	Productivity	`platform-todo`	8033	/api/todo/	● Live
Ramayanam	Culture	`platform-ramayanam`	8040	/api/ramayanam/	● Live

Deployment

Docker multi-stage build
Transfer via SSH (no registry)
docker-compose recreate
Nginx reload + health check
Timestamped config backups

Security

SSH key auth (LightSail.pem)
RDS SSL connections
Per-user file isolation
HTTPS via Let's Encrypt
No shared credentials in .env

Roadmap

User auth consolidation (SSO)
Mobile app (React Native)
Analytics dashboard
Stripe payment integration
Multi-tenant workspace mode