> ## Documentation Index
> Fetch the complete documentation index at: https://engineering.clinikally.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform overview

> The Clinikally service topology and ownership boundaries.

## Logical topology

```mermaid theme={null}
flowchart LR
  Client[Web / mobile clients]
  Client --> Hodor[Hodor\nIdentity and profiles]
  Client --> Atlas[Atlas\nCatalog]
  Client --> Compass[Compass\nSearch and recommendations]
  Client --> Tetris[Tetris\nCMS and widgets]
  Client --> Vector[Vector\nCheckout edge]
  Client --> Sesh[Sesh\nSession tracking]

  Atlas --> Medusa[Medusa Store\nCommerce core]
  Compass --> Atlas
  Compass --> Medusa
  Compass --> Netcore[Netcore / Unbxd]
  Tetris --> Strapi[Strapi CMS]
  Tetris --> Compass

  Vector --> Medusa
  Vector <-->|gRPC| Mint[Mint\nPayments]
  Mint --> Gateways[JuSPay / Cashfree]
  Mint --> Orderbox[Orderbox\nOrder management]

  Orderbox --> Estimo[Estimo\nAllocation and ETA]
  Orderbox --> Storehouse[Storehouse\nInventory and reservations]
  Storehouse --> Medusa
  Storehouse --> Shopify[Shopify]
  Orderbox --> ERP[Business Central / ERP]
  Orderbox --> Shipway[Shipway]

  Dermadesk[Dermadesk\nConsultations] <-->|gRPC| Konsilo[Konsilo\nClinical backend]
  Dermadesk --> Mint

  Producers[Atlas / Vector / Orderbox / Storehouse] --> Events[SNS / SQS]
  Events --> Notify[Notify\nMultichannel notifications]
  Gearbox[Gearbox\nScheduled jobs] --> Events
```

## Service layers

### Customer-facing edge

* **Hodor** owns OTP authentication, JWT lifecycle, profiles, and Shopify customer synchronization.
* **Atlas** serves catalog, menus, collections, brands, and restock registration.
* **Compass** provides search, browse, autosuggest, and recommendations through Atlas, Medusa, and Netcore/Unbxd clients.
* **Tetris** serves cached CMS content from Strapi and recommendation widgets using Compass gRPC.
* **Vector** provides marketplace checkout, address, promotions, payments, delivery, and abandoned-checkout functionality.
* **Sesh** maintains Redis-backed visitor/session state separately from Hodor identity.

### Transaction and fulfilment

* **Medusa Store** is the headless commerce core: carts, orders, promotions, product extensions, restock flows, workflow/event handling, and admin capabilities.
* **Mint** handles payment APIs, payment gateway webhooks, and an in-process gRPC interface used by callers such as Vector.
* **Orderbox** owns post-order processing, marketplace/consult orders, ERP interactions, shipment, returns, and worker execution.
* **Storehouse** integrates inventory, reservations, ERP events, and inventory synchronization with Medusa and Shopify.
* **Estimo** calculates warehouse eligibility and delivery ETA using inventory/cache and geographic/cutoff logic.

### Consultations and engagement

* **Dermadesk** owns consultation booking, slots, consult carts/orders/payments, and prescriptions.
* **Konsilo** is the NestJS clinical backend for doctors, availability, consultations, prescriptions, patients, and video.
* **Notify** consumes SQS queues and dispatches email, SMS, WhatsApp, activity, and webhook events.
* **Reflekt** manages reviews, ratings, questions, moderation, tags, and associated media.
* **Gearbox** runs scheduled/background work such as feeds, reminders, reviews, and analytics jobs.

## Evidence boundaries

The diagram represents directly evidenced clients, service URLs, gRPC calls, queue consumers/producers, and integrations. The precise request sequence for a completed marketplace order is partially inferred from these interfaces; see [Commerce flow](/architecture/commerce-flow) for the confidence boundary.