CODITECT Deployed Applications Summary

Date: November 24, 2025 Author: CODITECT Infrastructure Team Purpose: Reference for UI consistency and design system alignment

---

Executive Summary

This document catalogs all currently deployed CODITECT applications to ensure the new License Management Platform maintains design consistency, shared components, and standardized branding across the entire CODITECT ecosystem.

Deployed Applications:

1. workflow.coditect.ai - AgentFlow Workflow Analysis Platform
2. coditect.ai (formerly ide.coditect.ai) - CODITECT AI IDE

---

1. workflow.coditect.ai (AgentFlow)

Overview

Purpose: Subscription SaaS platform for discovering and analyzing where agentic workflows can be applied across organizations to determine optimal ROI for automation opportunities.

Status: ✅ 90% Complete, Production Deployed Deployed: October 29, 2025 GCP Project: agentflow-prod-2025 URL: https://workflow.coditect.ai

Infrastructure

GKE Cluster:

• Name: agentflow-cluster
• Location: us-central1
• Nodes: 3 nodes

Deployments:

Internet
    │
    ├─ DNS: workflow.coditect.ai (34.54.33.106)
    │
    └─▶ GCP HTTP(S) Load Balancer
          │
          ├─ SSL Certificate (Auto-managed)
          │
          ├─▶ /api/v1/* → agentflow-backend:8000 (2 pods)
          │                    │
          │                    └─▶ PostgreSQL (35.238.30.60:5432)
          │
          ├─▶ /health → agentflow-backend:8000
          │
          └─▶ /* → agentflow-frontend:80 (2 pods)

Backend:

• FastAPI (Python)
• PostgreSQL 15 (Cloud SQL)
• Redis 7.x
• Direct anthropic Python SDK (8 specialized AI agents)
• 2 replicas

Frontend:

• React 18
• TypeScript
• Next.js or Vite
• Tailwind CSS
• Zustand for state management
• 2 replicas

Design System

Colors:

// Primary Blue Scale
primary: {
  50: '#f0f9ff',
  100: '#e0f2fe',
  200: '#bae6fd',
  300: '#7dd3fc',
  400: '#38bdf8',
  500: '#0ea5e9',  // Primary brand color
  600: '#0284c7',
  700: '#0369a1',
  800: '#075985',
  900: '#0c4a6e',
}

Typography:

font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto',
             'Oxygen', 'Ubuntu', 'Cantarell', 'Fira Sans',
             'Droid Sans', 'Helvetica Neue', sans-serif;

Dark Mode:

• Strategy: CSS class-based (class)
• Tailwind config: darkMode: 'class'

Source Files:

• tailwind.config.js: Color palette, dark mode configuration
• index.css: Font stack, global styles

Key Features

1. Domain-Agnostic Analysis: Works with any workflow type
2. Multi-Agent System: 8 specialized AI agents (+ 10 proposed)
3. ROI-Focused: Identify automation opportunities with clear business value
4. Multi-Format Exports: 9 diagram formats, comprehensive documentation
5. Pure Anthropic Claude SDK: No abstraction layers

Backend Agents

1. Workflow Analyzer
2. Task Decomposer
3. Actor Identifier
4. Automation Assessor
5. Requirements Extractor
6. Process Designer
7. Quality Analyzer
8. Technical Analyzer

Documentation

Location: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/labs/coditect-labs-workflow/

Key Files:

• DEPLOYMENT.md - GCP/GKE deployment guide
• docs/reports/2025-10-29T07-12-45Z_gcp_deployment_status.md - Comprehensive deployment status
• frontend/tailwind.config.js - Design system configuration
• frontend/src/index.css - Global styles and font stack

Cost

Monthly Estimated Costs:

• GKE Cluster: ~$150/month (standard node pool)
• Cloud SQL: ~$50/month (db-f1-micro with 10GB storage)
• Load Balancer: ~$20/month (forwarding rules + data transfer)
• Cloud Storage: ~$5/month
• Static IP: $3/month

Total: ~$228/month

---

2. coditect.ai (CODITECT AI IDE)

Overview

Purpose: Cloud-based AI-powered IDE with multi-LLM integration, Eclipse Theia foundation, and persistent workspace storage using FoundationDB.

Status: ✅ Production Operational (Build #32) Deployed: October 29, 2025 (UI optimizations) GCP Project: [TBD - need to verify] URL: https://coditect.ai

Infrastructure

GKE Deployment:

GKE Ingress (34.8.51.57)
├─ coditect.ai → coditect-combined-service-hybrid
├─ www.coditect.ai → coditect-combined-service-hybrid
└─ api.coditect.ai → coditect-api-v5-service

StatefulSet: coditect-combined-hybrid (3 pods)
├─ React 18 frontend (dist/)
├─ Eclipse Theia 1.65 IDE
├─ NGINX reverse proxy
└─ PVCs (per pod):
   ├─ workspace (10 GB)
   └─ theia-config (5 GB)

Deployment: coditect-api-v5 (3 pods)
├─ Rust (Actix-web)
├─ JWT authentication
└─ FoundationDB client

FoundationDB: StatefulSet (3 coordinators + 2 proxies)

Backend:

• Rust (Actix-web framework)
• JWT authentication
• FoundationDB 7.1+ (ACID persistence)
• 3 replicas

Frontend:

• React 18
• TypeScript 5.3
• Vite 5.4
• Chakra UI 2.8
• Eclipse Theia 1.65 (Monaco Editor)

Storage:

• Hybrid Architecture: Shared Docker layers + user-specific PVCs
• Total: 45 GB (10 GB workspace + 5 GB config per pod)
• Cost Savings: $291.60/year (75% reduction from previous 180 GB)

Design System

Header:

• Height: 40px (optimized October 2025)
• Location: src/components/Header.tsx:66

Footer:

• Padding: py={2} (compact)
• Location: src/components/Footer.tsx:94

Colors:

• Consistent with workflow.coditect.ai (Primary blue #0ea5e9)

Typography:

• Same system font stack as workflow.coditect.ai

Key Features

1. React 18 Wrapper + Theia 1.65 IDE
2. NGINX Routing: / → Frontend, /theia → IDE
3. Icon Themes: vs-seti, vscode-icons + custom branding
4. 20+ VS Code Extensions: ESLint, Prettier, GitLens
5. Rust V5 Backend: Actix-web with JWT auth
6. FoundationDB Persistence: ACID transactions, sub-10ms latency
7. UI Optimizations: Compact header (40px), compact footer

FoundationDB Architecture

Data Model:

/az1ai-ide/
├── sessions/
│   ├── {session-id}/
│   │   ├── metadata       # Session info, timestamps
│   │   ├── editor-tabs/   # Open files, positions
│   │   ├── llm-messages/  # Conversation history
│   │   └── config/        # Session-specific settings
├── files/
│   ├── {file-path}/
│   │   ├── content        # File contents
│   │   ├── metadata       # Language, encoding, timestamps
│   │   └── versions/      # Version history
├── settings/
│   ├── global/            # Global preferences
│   └── workspace/         # Workspace settings
└── models/
    └── {model-id}/        # Model configurations

Key Features:

• ACID transactions with serializable isolation
• Sub-10ms latency
• Multi-model (key-value, document, graph)
• Session isolation via subspaces
• Watch API for real-time updates
• Automatic conflict resolution

Documentation

Location: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/cloud/coditect-cloud-ide/

Key Files:

• CLAUDE.md - AI assistant context and quick reference
• docs/DEFINITIVE-V5-architecture.md - Complete V5 design
• docs/07-adr/ADR-004-use-foundationdb-for-persistence.md - FoundationDB decision
• docs/10-execution-plans/BUILD-COMPLETION-SUMMARY.md - Build history
• cloudbuild-combined.yaml - Cloud Build configuration
• k8s/theia-statefulset-hybrid.yaml - Hybrid StatefulSet (current)

---

3. License Management Platform (NEW)

Overview

Purpose: Multi-tenant license management and authentication platform for CODITECT products with floating concurrent licensing.

Status: 🚧 Phase 0 Complete (Infrastructure), Phase 1-6 Pending Target Launch: December 13, 2025 GCP Project: coditect-cloud-infra Planned URLs:

• admin.coditect.ai - Django Admin (staff operations)
• api.coditect.ai - Django REST API (license API)
• app.coditect.ai - React Dashboard (customer self-service)

Infrastructure (Deployed)

GKE Cluster:

• Name: coditect-cluster
• Location: us-central1
• Status: Running (3 nodes)
• Current: Empty (only system pods)

Cloud SQL:

• Instance: coditect-db
• Database: PostgreSQL 16
• Tier: db-custom-2-8192
• Status: RUNNABLE
• Location: us-central1-c

Redis:

• Status: To be deployed (Memorystore)

Planned Architecture

┌─────────────────────────────────────────────────────────────┐
│                    GCP Load Balancer                         │
│           (SSL Termination + Path-Based Routing)             │
└─────────────┬──────────────┬──────────────┬─────────────────┘
              │              │              │
     ┌────────▼────────┐ ┌──▼──────────┐ ┌─▼──────────────┐
     │ Django Admin    │ │ Django REST │ │ React Frontend │
     │ (Staff Portal)  │ │ API         │ │ (Customer)     │
     │                 │ │             │ │                │
     │ admin.          │ │ api.        │ │ app.           │
     │ coditect.ai     │ │ coditect.ai │ │ coditect.ai    │
     └─────────────────┘ └─────────────┘ └────────────────┘
              │              │              │
              └──────────────┴──────────────┘
                           │
              ┌─────────────▼──────────────┐
              │ PostgreSQL 16 (Cloud SQL)  │
              │ + Redis Memorystore        │
              └────────────────────────────┘

Backend:

• Django 5.2.8
• Django REST Framework 3.16.1
• django-multitenant 3.2.1
• PostgreSQL 16
• Redis 7.x
• Celery 5.4.0
• Identity Platform (OAuth2)
• Cloud KMS (RSA-4096)

Frontend:

• React 18
• TypeScript 5.x (strict mode)
• Vite 5.x
• TanStack Query + Router
• Shadcn/ui + Tailwind CSS
• Design System: Matching workflow.coditect.ai + coditect.ai

Design System (Planned)

MUST match existing applications:

Colors: Primary blue #0ea5e9 and scale (from workflow.coditect.ai)

Typography: System font stack (same as workflow.coditect.ai and coditect.ai)

Dark Mode: CSS class-based (class)

Header/Footer: Standardized across all CODITECT apps with AZ1.AI logo

See: docs/ui-design-system.md for complete specifications

---

Design System Consistency

Shared Principles

All CODITECT applications MUST:

1. Use Primary Blue (#0ea5e9) as brand color
2. Use System Font Stack for optimal performance
3. Support Dark Mode via CSS class (class)
4. Include AZ1.AI Logo in header (top-left, 40px height)
5. Standardized Header/Footer with consistent navigation
6. Responsive Design (mobile, tablet, desktop)
7. Accessibility (WCAG AA compliance)

Colors (Standardized)

:root {
  --primary-500: #0ea5e9;  /* Primary blue - ALL apps */
  --primary-600: #0284c7;  /* Hover state */
  --primary-700: #0369a1;  /* Active state */
}

Typography (Standardized)

font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto',
             'Oxygen', 'Ubuntu', 'Cantarell', 'Fira Sans',
             'Droid Sans', 'Helvetica Neue', sans-serif;

Dark Mode (Standardized)

// Tailwind config (all apps)
export default {
  darkMode: 'class',
  // ...
}

// Implementation
<html className={isDark ? 'dark' : ''}>

---

Cross-Application Component Sharing

Potential Shared Components

Header Component:

• AZ1.AI logo
• Navigation links
• User profile dropdown
• Dark mode toggle

Footer Component:

• Company links (About, Careers, Contact)
• Legal links (Privacy, Terms, Security)
• Social icons
• Copyright

Authentication Forms:

• Login modal/page
• Registration form
• Password reset
• OAuth2 flows (Google, GitHub)

UI Primitives:

• Buttons (primary, secondary, danger)
• Input fields
• Cards
• Badges
• Tables
• Modals

Implementation Strategy

Option 1: Shared NPM Package

# Create @coditect/ui package
npm create @coditect/ui

# Use in all apps
npm install @coditect/ui

Option 2: Git Submodule

# Shared components repo
coditect-shared-components/

# Import in each app
git submodule add https://github.com/coditect-ai/coditect-shared-components

Option 3: Copy-Paste with Standards

• Maintain consistent component API
• Update all apps when design system changes
• Use design system documentation as single source of truth

---

Infrastructure Comparison

Aspect	workflow.coditect.ai	coditect.ai	License Platform
Status	90% complete	Production	Phase 0 only
GCP Project	agentflow-prod-2025	[TBD]	coditect-cloud-infra
GKE Cluster	agentflow-cluster	[TBD]	coditect-cluster
Backend	FastAPI + Python	Rust + Actix-web	Django + Python
Frontend	React 18 + Next.js	React 18 + Vite	React 18 + Vite (planned)
Database	PostgreSQL 15	FoundationDB 7.1	PostgreSQL 16
Cache	Redis 7.x	None	Redis 7.x (planned)
Auth	Custom	JWT	Identity Platform + JWT
SSL	Google-managed	Google-managed	Google-managed (planned)
Monthly Cost	~$228	[TBD]	~$290 (dev), ~$1,200 (prod)

---

Development Workflow Consistency

All Applications Should:

1. Use TypeScript Strict Mode for type safety
2. Use Tailwind CSS for styling
3. Follow Conventional Commits format
4. Create ADRs for architectural decisions
5. Use Docker for local development
6. Deploy via GKE for production
7. Use Google-Managed SSL certificates
8. Implement OAuth2 authentication
9. Support Dark Mode from day 1
10. Mobile-First Design approach

Build & Deploy

All frontends:

npm run build                    # Production build
gcloud builds submit             # Deploy to GKE

All backends:

• Dockerized
• Health check endpoint (/health)
• Structured logging
• Prometheus metrics (optional)

---

Security Consistency

All Applications Should:

1. HTTPS Only (TLS 1.3 minimum)
2. JWT Authentication with secure signing
3. CORS Configuration (allow specific origins only)
4. Rate Limiting on API endpoints
5. Input Validation (server-side + client-side)
6. SQL Injection Prevention (parameterized queries)
7. XSS Prevention (escape user input)
8. CSRF Protection (SameSite cookies, tokens)
9. Secrets Management (Google Secret Manager)
10. Audit Logging (who, what, when)

---

Next Steps

For License Management Platform

1. Apply UI Design System (docs/ui-design-system.md)
2. Reuse Components where possible from workflow.coditect.ai or coditect.ai
3. Maintain Consistency with existing applications
4. Follow ADR-001 (Django + React Hybrid Architecture)
5. Implement Phases 1-6 per project-plan.md

For All Applications

1. Document Design System Updates when changes occur
2. Share Component Libraries to reduce duplication
3. Standardize Build/Deploy pipelines across apps
4. Implement Shared Auth service (future)
5. Create Shared Monitoring dashboards (GCP Monitoring)

---

References

workflow.coditect.ai

• Deployment: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/labs/coditect-labs-workflow/DEPLOYMENT.md
• Status: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/labs/coditect-labs-workflow/docs/reports/2025-10-29T07-12-45Z_gcp_deployment_status.md
• Design System: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/labs/coditect-labs-workflow/frontend/tailwind.config.js

coditect.ai

• CLAUDE.md: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/cloud/coditect-cloud-ide/CLAUDE.md
• Architecture: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/cloud/coditect-cloud-ide/docs/DEFINITIVE-V5-architecture.md
• ADR-004: /Users/halcasteel/PROJECTS/coditect-rollout-master/submodules/cloud/coditect-cloud-ide/docs/07-adr/ADR-004-use-foundationdb-for-persistence.md

License Management Platform

• ADR-001: docs/adrs/adr-001-django-react-hybrid-architecture.md
• UI Design System: docs/ui-design-system.md
• Architecture Decision: ARCHITECTURE-DECISION-DJANGO-REACT.md

---

Document Version: 1.0 Last Updated: November 24, 2025 Status: APPROVED ✅ Maintained By: CODITECT Infrastructure Team