> ## 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.

# External integrations

> Third-party and platform dependencies evidenced in the repositories.

| Integration            | Consumers                                                        | Purpose                                            |
| ---------------------- | ---------------------------------------------------------------- | -------------------------------------------------- |
| AWS Secrets Manager    | Many Python services                                             | Runtime credentials and configuration              |
| SNS/SQS                | Atlas, Gearbox, Konsilo, Notify, Orderbox, Storehouse, Vector    | Async events and worker delivery                   |
| S3                     | Atlas, Dermadesk, Gearbox, Konsilo, Medusa, Orderbox, Storehouse | Object/media/payload storage                       |
| Medusa                 | Atlas, Compass, Dermadesk, Hodor, Orderbox, Storehouse, Vector   | Commerce state and product/cart/order capabilities |
| Shopify                | Hodor, Orderbox, Storehouse                                      | Customer, order, and inventory synchronization     |
| JuSPay / Cashfree      | Mint; Dermadesk also has JuSPay evidence                         | Payment processing                                 |
| Business Central / ERP | Orderbox, Storehouse                                             | Order and inventory integration                    |
| Shipway                | Orderbox                                                         | Shipping status and fulfilment                     |
| Netcore / Unbxd        | Compass, Gearbox, Notify                                         | Search/recommendations, feeds, messaging           |
| Vialogue / Gupshup     | Hodor, Notify                                                    | OTP and communication channels                     |
| Strapi                 | Tetris                                                           | CMS source                                         |
| Google Maps            | Estimo, Vector                                                   | Geocoding, location/delivery support               |
| 100ms                  | Konsilo                                                          | Video consultation                                 |
| PostHog                | Dermadesk, Gearbox                                               | Product/event analytics                            |

## Integration rules

* Isolate each provider behind a service/client module; do not call third-party APIs from unrelated route handlers.
* Keep provider credentials in AWS Secrets or the approved secret mechanism.
* Make webhooks authenticated, idempotent, observable, and safe to retry.
* Record provider request IDs and internal correlation IDs in structured logs/traces.
* Document ownership, failure mode, retry policy, rate limits, and data classification for each new integration.