Skip to content

GovStack Building Block integrations — Security, Identity, Registration, Payments, Messaging, Scheduler (consolidates Sprint 15 P2-P3)

GovStack Building Block Integrations — Phase 2

Context

The GovStack strategy positions GENIE.AI as the AI Building Block. Phase 2 implements the actual integrations with GovStack BBs, building on the LangGraph + MCP foundation from Sprint 24.

Each BB integration follows the same pattern:

  1. Define LangGraph workflow nodes for the BB's capabilities
  2. Create an MCP server that wraps the BB's REST API
  3. Implement the workflow that orchestrates citizen-facing processes
  4. Add frontend UI for workflow interaction and status

Scope

Phase 2A: Security + Identity BB Integration

  • MCP Server: Auth, token validation, user profile, permission checks
  • Workflow: Identity verification flow (verify citizen → check eligibility → proceed)
  • Frontend: Login status display, permission-gated actions
  • GovStack Spec Reference: Sections 3.2, 3.3

Phase 2B: Registration BB Integration

  • MCP Server: Start application, check status, submit documents, track progress
  • Workflow: Business license registration (multi-step: requirements → forms → review → approval)
  • Workflow: Birth certificate application (document collection → family verification → certificate generation)
  • Frontend: Application form wizard, status tracking, document upload
  • GovStack Spec Reference: Section 3.4

Phase 2C: Payments BB Integration

  • MCP Server: Calculate fees, initiate payment, check payment status, get receipt
  • Workflow: Tax payment processing (calculation → routing → receipt)
  • Workflow: License fee collection (determination → processing → confirmation)
  • Frontend: Payment summary, payment method selection, receipt display
  • GovStack Spec Reference: Section 3.5

Phase 2D: Messaging BB Integration

  • MCP Server: Send notification, check delivery status, manage templates
  • Workflow: Application status updates, appointment reminders, emergency alerts
  • Frontend: Notification preferences, message history
  • GovStack Spec Reference: Section 3.6

Phase 2E: Scheduler BB Integration

  • MCP Server: Check availability, book appointment, cancel, modify
  • Workflow: Healthcare appointment booking, DMV scheduling
  • Frontend: Calendar view, time slot selection, booking confirmation
  • GovStack Spec Reference: Section 3.7

Phase 2F: Advanced Features

  • BPMN Visualization: Export workflows to BPMN, render with bpmn-js (#282)
  • Hybrid Workflows: Mix static (JSON-defined) and dynamic (LLM-generated) workflow steps (#278, #277)
  • Cross-BB Workflows: Multi-department processes spanning 3+ BBs (#276)
  • MCP Security/Audit: Authentication, authorization, audit logging for all MCP servers (#280)
  • RAG Integration: Connect workflow context to existing RAG for informed decisions (#281)

Acceptance Criteria

  • MCP servers deployed for Security, Identity, Registration, Payments, Messaging, Scheduler BBs
  • At least 2 end-to-end citizen workflows working (one registration + one payment)
  • BPMN visualization shows workflow progress in real-time
  • Hybrid workflows can mix static and dynamic steps
  • All MCP calls authenticated and audited
  • Frontend supports workflow wizard UI with status tracking

GovStack Sandbox Deployment

  • Deploy and test on GovStack Sandbox environment (#285)
  • Comprehensive testing including RAG-enhanced conversations (#286)

Related Issues

  • Consolidates Sprint 15 Phase 2-3: #276-#286
  • Depends on: Sprint 24 Agentic Phase 1 (LangGraph + MCP foundation)
  • Depends on: GovStack Sandbox availability

Labels

1.Parent_Issue, ENHANCEMENT