Adolfo Delorenzo
f1b79dffe0
- PROJECT.md updated to reflect v1.0 completion (10 phases, 39 plans, 67 requirements). All key decisions marked as shipped. - README.md: comprehensive project documentation with quick start, architecture, tech stack, configuration, and project structure. - CHANGELOG.md: detailed changelog covering all 10 phases with feature descriptions organized by phase. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
3.9 KiB
3.9 KiB
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