Aventian SaaS Integration Docs
Welcome! This site is the starting point for onboarding a new product under the Aventian umbrella. Follow the quick start below, then dive deeper into the linked guides.
Quick Start (High-Level)
- Read the Integration Steps – a concise map of the whole journey.
- Contact Aventian – request an onboarding session & product registration credentials.
- Register Your Product – add metadata so provisioning & routing work.
- Set Up Authentication – implement Auth0 + token verification flows.
- Understand Tenant Databases – learn silo / schema model & provisioning expectations.
- Adopt Optional Services – notifications, management APIs, shared React components.
- Iterate & Review – regular check‑ins to validate roles, privileges & UX flow.
If you only do one thing first: read the high‑level page. It links every deep dive.
When to Use Which Doc
| Goal | Start Here |
|---|---|
| Confirm product eligibility | product-integration (minimum requirements) |
| Understand tenant DB isolation | tenant-architecture/intro |
| Implement login + secure routes | authentication/overview & authentication/integration |
| Define resources / privileges / roles | product-integration |
| Send user notifications | notification-service |
| Call platform / management APIs | external-api |
| Embed shared UI widgets | react-components |
Responsibilities
Aventian Team
- Provide onboarding session & sandbox credentials.
- Maintain platform & core integration docs.
- Provision / approve product registration & tenant resources.
- Support troubleshooting and review security / role models.
Product Team
- Study & follow integration and security guidelines.
- Supply product metadata (name, base URL, logo, redirects) promptly.
- Implement auth, resource + privilege modeling, and database schema per standards.
- Report blockers early; request scope changes before building divergences.
- Participate in integration reviews & suggest doc improvements.
Core Platform Stack
| Tech | Purpose |
|---|---|
| Auth0 | Centralized authentication & SSO |
| PostgreSQL | Per‑tenant silo DB engine |
| GKE | Container orchestration for tenant silos |
| Pub/Sub | Event & async messaging backbone |
| React | Shared UI & component library foundation |
These services underpin provisioning, multi‑tenant isolation, and product interoperability.