Ridy Comprehensive Migration Mega Document

Overview

This document synthesizes all provided documentation into a comprehensive guide for migrating the Ridy application from its current microservices architecture (NestJS, Flutter, Angular, MySQL) to a new stack using Python (FastAPI), PostgreSQL, and native mobile platforms (Swift, Kotlin).

Current Architecture Overview

Components

• Frontend:
  • Rider & Driver Apps: Flutter (BLoC pattern)
  • Admin Panel: Angular
• Backend:
  • Rider API, Driver API, Admin API: NestJS with JWT (Passport.js)
• Database: MySQL with TypeORM
• Communication: GraphQL & REST APIs
• Real-time: GraphQL Subscriptions

Shared Libraries

• Database: Entities, migrations
• Flutter Common: UI components, utilities
• Generic Map: Location and map services

Target Architecture

Backend

• Framework: Python (FastAPI)
• Database: PostgreSQL