Platform Overview

Dockit is a product service. Its technical documentation focuses on how the service behaves for users, operators, and administrators.

Core Product Areas

Web Application

• Sign-in and account session handling
• Generator input flow
• Result review and editing
• Project history and template entry points
• Billing and settings

Generation Service

• Free template generation
• Pro AI generation through async jobs
• Validation and repair of required artifacts
• Cache reuse for identical input fingerprints

Billing and Access Layer

• Paddle checkout
• Immediate post-checkout confirmation
• Webhook processing
• Reconciliation for entitlement drift
• Admin test overrides

Product-Level Design Decisions

Separate Input from Results

The Generator screen stays focused on inputs. Result validation, editing, and export live on a dedicated result page.

Treat Pro Generation as Background Work

Pro generation is long-running enough to justify async job handling instead of a single blocking request.

Keep Access Control Server-Side

Dockit does not trust frontend plan state alone. Pro access comes from a server-side user profile projection.

Reuse Validated Output

When the same validated combination already exists, Dockit can reuse it instead of paying generation cost again.

High-Level Product Flow

1. A user signs in and configures a stack
2. Dockit checks plan and policy boundaries
3. Free generates immediately in the browser
4. Pro creates a generation job in the service layer
5. The service validates, repairs, and stores the output
6. The result page supports review, edits, and export