# Konstruct

## What This Is

Konstruct is an AI workforce platform where SMBs subscribe to AI employees that communicate through familiar messaging channels — Slack, WhatsApp, and the built-in web chat. Clients get AI workers that show up where their team already communicates, requiring zero behavior change. Think "hire an AI department" rather than "subscribe to another SaaS dashboard."

## Core Value

An AI employee that works in the channels your team already uses — no new tools to learn, no dashboards to check, just a capable coworker in Slack, WhatsApp, or the portal chat.

## Current State (v1.0 — Beta-Ready)

All 10 phases complete. 39 plans executed. 67 requirements satisfied.

### What's Shipped

| Feature | Status |
|---------|--------|
| Channel Gateway (Slack + WhatsApp + Web Chat) | ✓ Complete |
| Multi-tenant isolation (PostgreSQL RLS) | ✓ Complete |
| LLM Backend (Ollama + Anthropic/OpenAI via LiteLLM) | ✓ Complete |
| Conversational memory (Redis sliding window + pgvector) | ✓ Complete |
| Tool framework (web search, KB, HTTP, calendar) | ✓ Complete |
| Knowledge base (document upload, URL scraping, YouTube transcription) | ✓ Complete |
| Google Calendar integration (OAuth, CRUD) | ✓ Complete |
| Human escalation with assistant mode | ✓ Complete |
| Bidirectional media support (multimodal LLM) | ✓ Complete |
| Admin portal (Next.js 16, shadcn/ui, DM Sans) | ✓ Complete |
| Agent Designer + Wizard + 6 pre-built templates | ✓ Complete |
| Stripe billing (per-agent monthly, 14-day trial) | ✓ Complete |
| BYO API keys (Fernet encrypted) | ✓ Complete |
| Cost dashboard with Recharts | ✓ Complete |
| 3-tier RBAC (platform admin, customer admin, operator) | ✓ Complete |
| Email invitation flow (SMTP, HMAC tokens) | ✓ Complete |
| Web Chat with real-time streaming (bypass Celery) | ✓ Complete |
| Multilanguage (English, Spanish, Portuguese) | ✓ Complete |
| Mobile layout (bottom tab bar, full-screen chat) | ✓ Complete |
| PWA (service worker, push notifications, offline queue) | ✓ Complete |
| E2E tests (Playwright, 7 flows, 3 browsers) | ✓ Complete |
| CI pipeline (Gitea Actions) | ✓ Complete |
| Premium UI (indigo brand, dark sidebar, glass-morphism) | ✓ Complete |

### v2 Scope (Deferred)

- Multi-agent teams and coordinator pattern
- Microsoft Teams, Mattermost, Telegram channels
- Self-hosted deployment (Helm chart)
- Schema-per-tenant isolation
- Agent marketplace
- Voice/telephony channels
- SSO/SAML for enterprise
- Granular operator permissions

## Context

- **Market gap:** Existing AI tools are dashboards or chatbots, not channel-native workers. No coordinated AI teams. No self-hosted options for enterprises.
- **Target customer:** SMBs that need additional staff capacity but lack resources, are overwhelmed with processes, or want to grow faster.
- **Tech foundation:** Python 3.12+ (FastAPI, SQLAlchemy 2.0, Celery), Next.js 16 (App Router, shadcn/ui, next-intl, Serwist), PostgreSQL 16 + pgvector, Redis, Ollama, Docker Compose.

## Key Decisions

| Decision | Rationale | Outcome |
|----------|-----------|---------|
| Slack + WhatsApp + Web Chat channels | Covers office (Slack), customers (WhatsApp), and portal users (Web Chat) | ✓ Shipped |
| Single agent per tenant for v1 | Prove channel-native thesis before team complexity | ✓ Shipped |
| Full portal from day one | Beta users need UI, not config files | ✓ Shipped |
| Local + commercial LLMs | Ollama for dev/cost, commercial for quality | ✓ Shipped |
| PostgreSQL RLS multi-tenancy | Simplest, sufficient for Starter tier | ✓ Shipped |
| Web chat bypasses Celery | Direct LLM streaming from WebSocket for speed | ✓ Shipped |
| Per-agent monthly pricing | Matches "hire an employee" metaphor | ✓ Shipped |
| 3-tier RBAC with invite flow | Self-service for customers, control for operators | ✓ Shipped |
| DM Sans + indigo brand | Premium SaaS aesthetic for SMB market | ✓ Shipped |

---
*Last updated: 2026-03-26 after Phase 10 completion*