# qtrl

> qtrl is an AI-powered QA automation platform that uses browser automation agents to generate, execute, and manage software tests. It is a multi-tenant SaaS application built with Next.js 14, Supabase (PostgreSQL), Stripe billing, and GCP Cloud Run workers.

## Key Concepts

- **Organizations**: Multi-tenant workspaces with role-based access control (owner, admin, member) and subscription tiers (Free, Starter, Pro, Teams)
- **Projects**: Test projects within organizations, each with their own environment configuration, members, and knowledge base
- **Tasks**: AI agent execution units that perform browser automation (test generation, test execution, review). Tasks consume credits and produce logs, screenshots, and videos
- **Tests**: Test definitions with step-by-step instructions, versioning, audit trails, and execution history. Support both structured test cases and freeform instructions
- **Test Runs**: Grouped test executions with reports, allowing batch execution of multiple tests
- **Knowledge Agent**: AI-powered chat that answers questions about a project's application using stored page knowledge and Jira data
- **Credit System**: Usage-based billing where AI operations consume credits from the organization's monthly allocation or top-up balance

## Architecture

- **Frontend**: Next.js 14 App Router with React 18, TypeScript, Tailwind CSS, and shadcn/ui components
- **Backend**: Next.js API routes with Supabase Auth (email OTP) and Row Level Security
- **Database**: PostgreSQL via Supabase with 18+ migrations, RLS on all tables, and immutable audit logging
- **Workers**: Two GCP Cloud Run services — a task worker (Playwright browser automation) and a knowledge worker (Jira issue processing)
- **Messaging**: Google Cloud Pub/Sub for async task dispatch between the web app and workers
- **Payments**: Stripe for subscriptions, credit top-ups, and billing portal
- **AI**: OpenAI for test generation, execution planning, knowledge chat, and browser agent reasoning

## Documentation

- [Getting Started](/docs/getting-started): How to set up and start using qtrl
- [Projects](/docs/concepts/projects): Understanding projects and their configuration
- [Tasks](/docs/concepts/tasks): How AI agent tasks work
- [Test Management](/docs/concepts/test-management): Managing tests, folders, and versions
- [Test Runs](/docs/concepts/test-runs): Running and reviewing test executions
- [Memory](/docs/concepts/memory): How the knowledge agent learns about your application

## Best Practices

- [Creating Tasks](/docs/best-practices/creating-tasks): Writing effective task instructions
- [Test Management](/docs/best-practices/test-management): Organizing and maintaining tests
- [Test Results](/docs/best-practices/test-results): Interpreting execution results
- [Test Runs](/docs/best-practices/test-runs): Running tests effectively

## Legal

- [Terms of Service](/legal/terms)
- [Privacy Policy](/legal/privacy)
- [Cookie Policy](/legal/cookies)
- [Data Processing Agreement](/legal/dpa)
- [Security](/legal/security)
- [Acceptable Use Policy](/legal/acceptable-use)

## Pricing

- [Pricing](/pricing): Subscription tiers and credit-based pricing details

## Optional

- [Request Demo](/request-demo): Request a guided demo of the platform