0rca Dashboard // Technical Documentation

1. Module Overview

Name: 0rca Dashboard (Web Command Center) Role: The central interface for the 0rca "Operating System for AI Agents." It serves as the primary touchpoint for developers and users to manage agents, participate in DAO governance, and interact with the decentralized trust layer. Live URL: (Pending Deployment)

This module acts as the "Cockpit" for the 0rca ecosystem, providing visibility into the Swarm, the Orchestrator, and the On-Chain Registry.

2. Directory Structure

Root Configuration

• mcp-python/: Dedicated Python-based Model Context Protocol (MCP) server for AI context infusion.
• prisma/: Database schema defining the relational structure (Agents, Users, DAO Proposals).
• public/: Static assets and public-facing resources.
• *.algo.ts: Algorand TypeScript files defining Smart Contract interactions (DAO, Proposal).

Source Code (src/)

• app/: Next.js 14 App Router structure.
  • dao/: Governance interface for the 0rca DAO (Proposals, Voting).
  • dashboard/: Main user view for Agent status and metrics.
  • assistant/: Interface for the AI Assistant (Orchestrator proxy).
  • creator/: Tools for minting and deploying new AI Agents.
  • api/: Next.js Serverless API endpoints.
• components/: React UI components.
  • ui/: Reusable primitives (based on Radix UI).
  • StandaloneAIAssistant.tsx: Core chat interface for interacting with the Orchestrator.
• server/: Custom Express.js backend for heavy-lifting, workers, and background jobs.
• mcp/: TypeScript-based MCP server implementation.
• lib/: Shared utilities, Prisma clients, and Supabase helpers.

3. Technology Stack

4. Key Features

• Agent Command Center: Visualize and manage the lifecycle of AI Agents deployed via git push.
• 0rca DAO Governance: Interact directly with the Algorand Blockchain (App ID 749655317) to vote on protocol upgrades. Uses DAO.algo.ts for contract binding.
• MCP Gateway: Dual-stack MCP implementation (Node.js and Python) allowing the Orchestrator to read dashboard context and user intent.
• Hybrid Backend architecture: specialized Express server (src/server) for long-running worker threads (e.g., Rewards distribution) alongside Next.js serverless functions.
• AI-Native Interface: Embedded StandaloneAIAssistant component that provides a conversational interface to the OS.

5. Development Workflow

Prerequisites

• Node.js & npm/yarn
• Python 3.10+ (for MCP Python server)
• Docker (optional, for localized DB)

Setup Commands

# 1. Install Dependencies
npm install

# 2. Initialize Database & Client
npm run postinstall # Runs prisma generate

# 3. Start Development Environment (Choose Mode)
npm run dev             # Next.js Frontend
npm run api:dev         # Backend Express Server
npm run dev:mcp         # TypeScript MCP Server
npm run start:mcp-python # Python MCP Server

Build for Production

npm run build           # Standard Next.js build
npm run api:build       # Compile Express backend

6. Integration Context

The 0rca Dashboard is the visual layer of the 0rca Protocol.

• Upstream: It connects to the Orchestrator (LLM) via the MCP layer, providing it with real-time data about user holdings, agent status, and governance proposals.
• Downstream: It reads from and writes to:
  • Supabase: For high-speed off-chain data (User profiles, chat history).
  • Algorand: For the immutable Trust Layer (Agent ownership registry, Payments, DAO votes).
• Lateral: It triggers deployment pipelines (Kaniko/Docker) indirectly by interacting with the creator module endpoints.