===================================
OIM Cameroon "Bridges" RAG Platform
===================================

**Socio-Economic Opportunities Recommendation System**

.. mermaid::

   graph LR
       U["Beneficiaries<br/>web · mobile · partners"] -->|HTTPS| API["FastAPI<br/>Backend API"]
       API --> ENG["AI Recommendation<br/>Engine"]
       ENG --> EMB["Ollama bge-m3<br/>embeddings"]
       ENG --> VEC["Qdrant<br/>vector search"]
       ENG --> LLM["Gemini 2.0 Flash"]
       ENG --> DB["PostgreSQL<br/>history · audit"]

       classDef c fill:#E3F2FD,stroke:#1976D2,color:#000
       classDef b fill:#FFF3E0,stroke:#F57C00,color:#000
       classDef a fill:#F3E5F5,stroke:#8E24AA,color:#000
       classDef d fill:#E8F5E9,stroke:#2E7D32,color:#000
       class U c
       class API,ENG b
       class EMB,VEC,LLM a
       class DB d

|

Welcome to the complete technical documentation for the **International
Organization for Migration (IOM) Cameroon Digital Economic Reintegration
Platform**, internally code-named **Bridges**. The platform uses Retrieval-Augmented
Generation (RAG) and generative AI to deliver personalized socio-economic
opportunity recommendations to migrants, internally displaced persons (IDPs),
returning migrants, and affected communities in Cameroon.

.. admonition:: Live API documentation
   :class: tip

   The interactive REST API (Swagger UI) is available at
   **https://backend.bridges.cm/docs** — and the raw OpenAPI schema at
   https://backend.bridges.cm/openapi.json. See :doc:`api-reference` for
   annotated endpoints and request/response schemas.

.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - Attribute
     - Value
   * - Project reference
     - IOM-CMR-2025-REINT
   * - Documentation version
     - 1.0
   * - Status
     - Production
   * - Maintainer
     - IOM Cameroon Technical Team

The platform is built from four independent code repositories that share a
common backend API and data model:

.. list-table::
   :header-rows: 1
   :widths: 25 20 55

   * - Component
     - Stack
     - Purpose
   * - AI Recommendation Engine
     - Python / FastAPI
     - RAG indexing, vector search, and Gemini-powered recommendations
   * - Web Frontend
     - Next.js / React
     - Beneficiary-facing web application
   * - Mobile App
     - React Native / Expo
     - Beneficiary-facing mobile application
   * - Partners Portal
     - Next.js / React
     - Portal for government, NGO, and private-sector partners

.. toctree::
   :maxdepth: 2
   :caption: Getting Started

   overview
   architecture
   installation
   configuration

.. toctree::
   :maxdepth: 2
   :caption: Components

   components/ai-engine
   components/web-frontend
   components/mobile-app
   components/partners-portal

.. toctree::
   :maxdepth: 2
   :caption: Reference

   api-reference
   data-model
   security
   deployment
   maintenance

Indices and tables
==================

* :ref:`genindex`
* :ref:`search`