Internal Documentation internal
TalkIDE internal documentation

UC-01: User Management

UC-01_user-management/README.md

  • Sign Up
  • Login
  • Refresh Token
  • Logout
  • Forgotten Password
  • My Profile (view & update, language picker, achievement stats)
  • Sound Preferences
  • Export User Data (GDPR Article 15)
  • Delete Account (GDPR Article 17 — Right to be Forgotten)

UC-02: Tenant Management

UC-02_tenant-management/README.md

  • View Tenant Settings
  • Update Tenant Settings

UC-03: Project Management

UC-03_project-management/README.md

  • List Projects
  • Create Project
  • Project Detail
  • Update Project
  • Archive Project
  • Restore Project
  • Delete Project

UC-04: Conversation

UC-04_conversation/README.md

  • Start Conversation
  • Send Message
  • List Conversations
  • Conversation Detail (history)
  • Close Conversation
  • Chat Attachments (file upload, long-text paste, Mara image/PDF/text reading)

UC-05: Workspace Activity & Team Status

UC-05_workspace-activity/README.md

  • Activity Feed (SSE stream)
  • Team Status

UC-06: Studio

UC-06_studio/README.md

  • Recent Activity (cross-project tenant feed, SSE stream)

UC-07: Project Explorer (Under-the-hood mode)

UC-07_project-explorer/README.md

  • Files Explorer (directory tree + file content read)
  • Database Explorer (table list, schema, paginated data)

UC-08: Mara Platform

UC-08_mara-platform/README.md

  • Anthropic Call Gateway (cost tracking, usage ledger)
  • Mara Fatigue & Quota Enforcement
  • Invite System
  • Admin Capacity Console
  • Reconciliation Log (drift detection PG ↔ Redis, per-user rebuild)
  • Billing & Usage View (user quota panel — 5h + weekly rolling windows, manual refresh)

UC-09: Issue Tracking

UC-09_issue-tracking/README.md

  • Report Platform Issue
  • Search Issues
  • Comment Issue
  • Admin Triage Issue
  • Report Project Issue
  • View Project Issues
  • Mara Injects Open Issues

UC-10: Stripe Billing

UC-10_stripe-billing/README.md

  • Register Payment Method (SetupIntent flow, Stripe Elements)
  • Get Payment Method (card brand / last4 / expiry)
  • Update Billing Email
  • List Invoices (paginated, PDF download via Stripe hosted_invoice_url)
  • Spending Limit GET + PUT (nullable = unlimited, soft alerts at 80 % / 100 %)
  • Stripe Webhook (signature verification, idempotent event processing)
  • BOGO Credit Bonus (early adopters 2× kredit za top-up, threshold v DB)
  • Per-Environment Secrets Management (K8s Secret source-of-truth, Mara widget, agent context injection)

UC-11: Waitlist

UC-11_waitlist/README.md

  • Join Waitlist (public form, idempotent, queue position + referral code)
  • Waitlist Referral Attribution (referral link capture, position bump, share intents)
  • Admin Waitlist List & CSV Export (paginated list, email search, full CSV download)

UC-12: Managed Storage

UC-12_managed-storage/README.md

  • Provision Storage (Cloudflare R2 per-project bucket + scoped token + K8s Secret + storage-svc deploy via K8sStorageProvisioner)
  • Presign Upload URL (storage-svc endpoint, 15min TTL, quota check)
  • Presign Download URL (storage-svc endpoint, 60min TTL, optional content-disposition)
  • List & Delete Files (storage-svc BE-proxy, R2 ListObjectsV2 + DeleteObject)
  • Storage SDK Scaffold (talkide-storage-sdk Kotlin lib + Mara prompt update v talkide-backend-dev.md)
  • Storage Usage View (30min snapshot scheduler → storage_usage_snapshot ledger + admin read endpoint; vstup pro budoucí UC-10019 storage billing line)
Was this page helpful?

Thanks for the feedback.