🏗️ The Architecture of Mentor Hub

1. Decoupled, Service-to-Service Microservices
   The backend is completely modular. A core philosophy of the app is domain isolation—meaning individual services (like your encounter_service.py) handle their own specific business logic and talk to other services through strict API channels. This prevents a bug in one repository from taking down the entire platform.

2. Model-Less API Design & Database Data Quality
   Mentor Hub relies heavily on a sophisticated, cutting-edge architecture pattern: delegating data validation directly to the database layer.

Instead of maintaining redundant, fragile data models in both the frontend and backend, the APIs are built to be flexible and “model-less.”

Data quality is rigidly enforced directly inside MongoDB using strict schema validation. If a service tries to write malformed JSON or data that violates the system’s “code craftsmanship” standards, MongoDB rejects it at the gate.

3. Centralized API Utilities (api_utils)
   To keep the 15 repositories from duplicating code, the team uses a centralized utility paradigm. System constants, shared configurations, and reusable logic are pulled into a universal api_utils framework, ensuring that all services remain perfectly aligned on standards like Role-Based Access Control (RBAC).

🛠️ The Local Developer Ecosystem
Because running 15 repositories simultaneously on a single computer can be a nightmare, you have a highly optimized local environment:

The Ecosystem Controller (mh): You use a custom command-line tool (with commands like mh up) to spin up, manage, and orchestrate the various microservices seamlessly.

Containerization: The architecture is fully containerized using Docker, allowing your 4-person development team to run identical, isolated environments locally on Windows via WSL2.

Enterprise Security Pipelines: The stack is built to mirror multi-account cloud topologies safely, integrating secure AWS SSO profiles to handle authentication and configuration management right from your local terminal.