RAIQL 1.0 · HANDS-ON SERIES

Learn RAIQL by building one real SaaS application.

Ten focused tutorials grow a single ServiceDesk application from a small Ticket model into a PostgreSQL-backed, authenticated, multi-tenant system with OpenAPI, jobs, tests, environment contracts and production deployment artifacts.

01Beginner · 15 min

Build Your First RAIQL App

Create a small ServiceDesk application, validate the specification, generate code and run it locally.

ServiceDeskContinue →
02Beginner · 20 min

Build a PostgreSQL CRUD Application

Move ServiceDesk from memory storage to PostgreSQL with generated Prisma persistence and Docker-backed local development.

ServiceDeskContinue →
03Intermediate · 25 min

Authentication with Email, Password and JWT

Add persisted users, email/password registration, password hashing and JWT sessions to ServiceDesk.

ServiceDeskContinue →
04Intermediate · 25 min

RBAC and Record Ownership

Protect ServiceDesk operations with ADMIN, AGENT and USER roles plus record-level ownership semantics.

ServiceDeskContinue →
05Advanced · 30 min

Build a Multi-Tenant SaaS

Add Tenant identity and tenant-scoped Ticket access so one generated ServiceDesk can safely serve multiple organizations.

ServiceDeskContinue →
06Intermediate · 20 min

Generate OpenAPI and a TypeScript SDK

Generate an OpenAPI 3.1 contract and typed TypeScript client from the same ServiceDesk requirements.

ServiceDeskContinue →
07Advanced · 25 min

Events and Background Jobs

Use the generated PostgreSQL outbox and worker adapter for asynchronous ServiceDesk processing.

ServiceDeskContinue →
08Intermediate · 20 min

Testing a RAIQL Application

Generate contract, security, password and PostgreSQL tests directly from the ServiceDesk requirements.

ServiceDeskContinue →
09Intermediate · 20 min

Environment Variables and Secrets

Keep development, staging and production configuration explicit without putting secret values into RAIQL source.

ServiceDeskContinue →
10Advanced · 30 min

Deploy a RAIQL Application

Generate Docker, Compose, Kubernetes and AWS ECS/Fargate deployment artifacts for the completed ServiceDesk application.

ServiceDeskContinue →
01

One application

Every tutorial continues the same ServiceDesk system, so each new capability has context.

02

Real syntax only

Examples use the frozen RAIQL 1.0 language surface—no roadmap syntax or imaginary commands.

03

Run every step

Each chapter includes commands you can execute with the stable RAIQL CLI.