Skip to main content

C4 Workflow Diagram - Level 1: System Context Workflows

CODITECT Context Intelligence Platform

Diagram Level: 1 (System Context) Focus: High-level user workflows across systems Audience: All stakeholders Purpose: Understand end-to-end user journeys

Workflow 1: Developer Saves and Searches Conversations​

Key Steps:

  1. Developer has AI conversation
  2. Developer saves conversation to platform
  3. Developer commits code to GitHub
  4. Platform receives webhook and auto-correlates
  5. Developer searches and finds linked conversation + commit

Duration: Varies (conversation: 5-30 min, save: 2 sec, commit: 1 min, search: 5 sec)

Workflow 2: Engineering Manager Reviews Team Productivity​

Key Steps:

  1. Manager logs into platform
  2. Views team analytics dashboard
  3. Filters by date range
  4. Explores topics and patterns
  5. Exports report for leadership

Duration: 15-30 minutes (weekly review)

Workflow 3: CTO Runs Compliance Audit​

Key Steps:

  1. CTO logs in via enterprise SSO
  2. Navigates to compliance reports
  3. Generates data export (GDPR request)
  4. Reviews retention policies
  5. Downloads encrypted audit package

Duration: 10-15 minutes (quarterly audit)

Workflow 4: OAuth Authentication Flow​

Key Steps:

  1. User initiates OAuth login
  2. Platform redirects to provider
  3. User grants permissions
  4. Provider returns authorization code
  5. Platform exchanges code for token
  6. Platform creates/updates user in database
  7. Platform issues JWT token
  8. User redirected to dashboard

Duration: 5-10 seconds

Workflow 5: GitHub Webhook Processing​

Key Steps:

  1. Developer pushes code to GitHub
  2. GitHub sends webhook to platform
  3. Platform verifies signature and queues job
  4. Background worker processes webhook
  5. Worker correlates conversations and commits
  6. Real-time notification sent to user

Duration: <1 second (webhook ack), 1-2 seconds (background processing)

Workflow 6: Tier-Based Feature Gating​

Key Features by Tier:

FeatureStarterProEnterprise
Keyword Search✅✅✅
Semantic Search❌✅✅
Team Analytics❌✅✅
SSO (SAML)❌❌✅
Compliance Reports❌❌✅
API Access❌✅✅

Workflow 7: Conversation-Commit Correlation​

Scoring Formula:

final_score = (0.6 * temporal_score) + (0.3 * semantic_score) + (0.1 * explicit_score)

temporal_score = 1 - (time_diff_hours / 6)  # 0-6 hours → 1.0-0.0
semantic_score = cosine_similarity(commit_message, conversation_text)  # 0.0-1.0
explicit_score = 1.0 if manually linked, else 0.0

Workflow 8: Data Export (GDPR Compliance)​

Export Contents (JSON format):

  • All conversations (title, messages, timestamps)
  • All commits linked to conversations
  • User profile data
  • Usage statistics
  • Audit log (logins, actions)

Security:

  • Encrypted with user's public key (or temporary password)
  • Signed download URL (expires in 7 days)
  • Deleted from S3 after download or 7 days

Next Level: Container Workflows​

The System Context workflows show end-to-end user journeys across external systems. The next level (Container Workflows) will show workflows within the platform across containers (API, databases, workers).

See: c4-l2-workflow-container.md

Diagram Maintained By: Product & Engineering Teams Last Updated: 2025-11-26 Review Cycle: Quarterly Related Documents: