# easybusiness-cop/eldorado architecture

> Architecture diagram of the GitHub repository easybusiness-cop/eldorado, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/easybusiness-cop/eldorado
- Repository: https://github.com/easybusiness-cop/eldorado

## Overview

Rufflo is a React/Express application for AI-assisted company workflows, agent interfaces, orchestration, and integrations; the README cautions that displayed agents and model responses do not prove execution. The principal path is a user request through the command-center UI and API into orchestration, which may plan work, dispatch corporate tasks, and use configured model, research, or execution services. Additional branches cover workforce capabilities, repository knowledge, workflows, and proposals. Some backend wiring is unsampled, so the graph omits uncertain connections and treats documented-but-unverified links as dashed.

Main entry points: [`server/ai/providers/index.ts`](https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/providers/index.ts) (Model Providers), [`server/core/autonomy/corporate-cascade.engine.ts`](https://github.com/easybusiness-cop/eldorado/blob/main/server/core/autonomy/corporate-cascade.engine.ts) (Corporate Cascade), [`server/ai/company/knowledge/discovery.engine.ts`](https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/company/knowledge/discovery.engine.ts) (Discovery Engine), [`server/gateway/api-gateway.ts`](https://github.com/easybusiness-cop/eldorado/blob/main/server/gateway/api-gateway.ts) (API Gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Command Center"]
  node_app["React Application<br/>[App.tsx]"]
  node_command["Command Center<br/>[CommandCenter.tsx]"]
  node_corporation_ui["Corporation View"]
end

subgraph group_api["API Surface"]
  node_api_gateway["API Gateway<br/>[api-gateway.ts]"]
  node_orchestrator_routes["Orchestrator Routes"]
  node_engineering_routes["Engineering Routes"]
end

subgraph group_coordination["Orchestration"]
  node_master_orchestrator["Master Orchestrator"]
  node_cascade["Corporate Cascade"]
  node_workflow_engine["Workflow Engine<br/>[engine.ts]"]
end

subgraph group_workforce["Workforce"]
  node_workforce_engine["Workforce Dispatch"]
  node_workforce_manager["Workforce Manager"]
  node_capability_engine["Capability Profiles"]
end

subgraph group_intelligence["Knowledge and Learning"]
  node_discovery["Discovery Engine"]
  node_research_manager["Research Manager"]
  node_repo_ingestion["Repository Ingestion"]
  node_repo_learning["Repository Learning"]
  node_failure_memory[("Failure Memory<br/>[failure-memory.ts]")]
end

subgraph group_runtime["Execution and Controls"]
  node_model_router["Model Providers<br/>[index.ts]"]
  node_browser["Browser Service<br/>[browser.service.ts]"]
  node_execution_kernel["Execution Kernel"]
  node_evaluation["Task Evaluation"]
  node_proposals["Improvement Proposals"]
  node_risk["Risk Engine<br/>[risk-engine.ts]"]
end

node_user(("User"))

node_user -.->|"uses"| node_app
node_app -->|"renders"| node_command
node_command -.->|"requests"| node_api_gateway
node_corporation_ui -.->|"requests"| node_api_gateway
node_api_gateway -.->|"routes"| node_orchestrator_routes
node_orchestrator_routes -.->|"invokes"| node_master_orchestrator
node_orchestrator_routes -.->|"uses"| node_model_router
node_engineering_routes -->|"manages"| node_proposals
node_engineering_routes -.->|"uses"| node_repo_learning
node_master_orchestrator -.->|"dispatches"| node_cascade
node_cascade -->|"generates plans"| node_model_router
node_cascade -->|"uses workforce"| node_workforce_manager
node_cascade -->|"queries intelligence"| node_discovery
node_workforce_engine -->|"requests decomposition"| node_model_router
node_workforce_engine -.->|"uses competencies"| node_capability_engine
node_workforce_manager -.->|"uses profiles"| node_capability_engine
node_research_manager -->|"uses workforce"| node_workforce_manager
node_research_manager -->|"requests discovery"| node_discovery
node_discovery -->|"uses browsing"| node_browser
node_discovery -.->|"queries model"| node_model_router
node_repo_ingestion -.->|"supplies knowledge"| node_repo_learning
node_repo_learning -->|"uses model"| node_model_router
node_workflow_engine -.->|"uses workflows"| node_model_router
node_workflow_engine -->|"uses tools"| node_api_gateway
node_execution_kernel -.->|"supports verification"| node_evaluation
node_master_orchestrator -.->|"learns from failures"| node_failure_memory
node_proposals -->|"generates proposals"| node_model_router

click node_app "https://github.com/easybusiness-cop/eldorado/blob/main/src/App.tsx"
click node_command "https://github.com/easybusiness-cop/eldorado/blob/main/src/components/CommandCenter.tsx"
click node_corporation_ui "https://github.com/easybusiness-cop/eldorado/blob/main/src/components/corporation/VirtualCorporationView.tsx"
click node_api_gateway "https://github.com/easybusiness-cop/eldorado/blob/main/server/gateway/api-gateway.ts"
click node_orchestrator_routes "https://github.com/easybusiness-cop/eldorado/blob/main/server/routes/orchestrator.routes.ts"
click node_engineering_routes "https://github.com/easybusiness-cop/eldorado/blob/main/server/routes/engineering-advanced.routes.ts"
click node_master_orchestrator "https://github.com/easybusiness-cop/eldorado/blob/main/server/core/orchestration/master-orchestrator.ts"
click node_cascade "https://github.com/easybusiness-cop/eldorado/blob/main/server/core/autonomy/corporate-cascade.engine.ts"
click node_workflow_engine "https://github.com/easybusiness-cop/eldorado/blob/main/server/workflows/engine.ts"
click node_workforce_engine "https://github.com/easybusiness-cop/eldorado/blob/main/server/corporation/workforce.engine.ts"
click node_workforce_manager "https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/company/workforce/workforce.manager.ts"
click node_capability_engine "https://github.com/easybusiness-cop/eldorado/blob/main/server/core/capabilities/capability.engine.ts"
click node_discovery "https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/company/knowledge/discovery.engine.ts"
click node_research_manager "https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/company/knowledge/research.manager.ts"
click node_repo_ingestion "https://github.com/easybusiness-cop/eldorado/blob/main/server/knowledge/ingestion/ingestion-pipeline.ts"
click node_repo_learning "https://github.com/easybusiness-cop/eldorado/blob/main/server/knowledge/repositories/repo-learning-engine.ts"
click node_failure_memory "https://github.com/easybusiness-cop/eldorado/blob/main/server/core/learning/failure-memory.ts"
click node_model_router "https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/providers/index.ts"
click node_browser "https://github.com/easybusiness-cop/eldorado/blob/main/server/tools/browser/browser.service.ts"
click node_execution_kernel "https://github.com/easybusiness-cop/eldorado/blob/main/server/core/execution/execution.kernel.ts"
click node_evaluation "https://github.com/easybusiness-cop/eldorado/blob/main/server/core/evaluation/evaluation.engine.ts"
click node_proposals "https://github.com/easybusiness-cop/eldorado/blob/main/server/agents/capabilities/master-self-improvement/master-proposal.service.ts"
click node_risk "https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/runtime/risk-engine.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_command,node_corporation_ui,node_user toneBlue
class node_api_gateway,node_orchestrator_routes,node_engineering_routes toneAmber
class node_master_orchestrator,node_cascade,node_workflow_engine toneMint
class node_workforce_engine,node_workforce_manager,node_capability_engine toneRose
class node_discovery,node_research_manager,node_repo_ingestion,node_repo_learning,node_failure_memory toneIndigo
class node_model_router,node_browser,node_execution_kernel,node_evaluation,node_proposals,node_risk toneTeal
```

## Components

### Command Center

- [React Application](https://github.com/easybusiness-cop/eldorado/blob/main/src/App.tsx): `src/App.tsx`
- [Command Center](https://github.com/easybusiness-cop/eldorado/blob/main/src/components/CommandCenter.tsx): `src/components/CommandCenter.tsx`
- [Corporation View](https://github.com/easybusiness-cop/eldorado/blob/main/src/components/corporation/VirtualCorporationView.tsx): `src/components/corporation/VirtualCorporationView.tsx`

### API Surface

- [API Gateway](https://github.com/easybusiness-cop/eldorado/blob/main/server/gateway/api-gateway.ts): `server/gateway/api-gateway.ts`
- [Orchestrator Routes](https://github.com/easybusiness-cop/eldorado/blob/main/server/routes/orchestrator.routes.ts): `server/routes/orchestrator.routes.ts`
- [Engineering Routes](https://github.com/easybusiness-cop/eldorado/blob/main/server/routes/engineering-advanced.routes.ts): `server/routes/engineering-advanced.routes.ts`

### Orchestration

- [Master Orchestrator](https://github.com/easybusiness-cop/eldorado/blob/main/server/core/orchestration/master-orchestrator.ts): `server/core/orchestration/master-orchestrator.ts`
- [Corporate Cascade](https://github.com/easybusiness-cop/eldorado/blob/main/server/core/autonomy/corporate-cascade.engine.ts): `server/core/autonomy/corporate-cascade.engine.ts`
- [Workflow Engine](https://github.com/easybusiness-cop/eldorado/blob/main/server/workflows/engine.ts): `server/workflows/engine.ts`

### Workforce

- [Workforce Dispatch](https://github.com/easybusiness-cop/eldorado/blob/main/server/corporation/workforce.engine.ts): `server/corporation/workforce.engine.ts`
- [Workforce Manager](https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/company/workforce/workforce.manager.ts): `server/ai/company/workforce/workforce.manager.ts`
- [Capability Profiles](https://github.com/easybusiness-cop/eldorado/blob/main/server/core/capabilities/capability.engine.ts): `server/core/capabilities/capability.engine.ts`

### Knowledge and Learning

- [Discovery Engine](https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/company/knowledge/discovery.engine.ts): `server/ai/company/knowledge/discovery.engine.ts`
- [Research Manager](https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/company/knowledge/research.manager.ts): `server/ai/company/knowledge/research.manager.ts`
- [Repository Ingestion](https://github.com/easybusiness-cop/eldorado/blob/main/server/knowledge/ingestion/ingestion-pipeline.ts): `server/knowledge/ingestion/ingestion-pipeline.ts`
- [Repository Learning](https://github.com/easybusiness-cop/eldorado/blob/main/server/knowledge/repositories/repo-learning-engine.ts): `server/knowledge/repositories/repo-learning-engine.ts`
- [Failure Memory](https://github.com/easybusiness-cop/eldorado/blob/main/server/core/learning/failure-memory.ts): `server/core/learning/failure-memory.ts`

### Execution and Controls

- [Model Providers](https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/providers/index.ts): `server/ai/providers/index.ts`
- [Browser Service](https://github.com/easybusiness-cop/eldorado/blob/main/server/tools/browser/browser.service.ts): `server/tools/browser/browser.service.ts`
- [Execution Kernel](https://github.com/easybusiness-cop/eldorado/blob/main/server/core/execution/execution.kernel.ts): `server/core/execution/execution.kernel.ts`
- [Task Evaluation](https://github.com/easybusiness-cop/eldorado/blob/main/server/core/evaluation/evaluation.engine.ts): `server/core/evaluation/evaluation.engine.ts`
- [Improvement Proposals](https://github.com/easybusiness-cop/eldorado/blob/main/server/agents/capabilities/master-self-improvement/master-proposal.service.ts): `server/agents/capabilities/master-self-improvement/master-proposal.service.ts`
- [Risk Engine](https://github.com/easybusiness-cop/eldorado/blob/main/server/ai/runtime/risk-engine.ts): `server/ai/runtime/risk-engine.ts`

### Other components

- **User**

## Connections

- User → React Application: uses (evidence: `README.md`)
- React Application → Command Center: renders (evidence: `src/App.tsx`)
- Command Center → API Gateway: requests (evidence: `README.md`)
- Corporation View → API Gateway: requests (evidence: `README.md`)
- API Gateway → Orchestrator Routes: routes
- Orchestrator Routes → Master Orchestrator: invokes (evidence: `server/routes/orchestrator.routes.ts`)
- Orchestrator Routes → Model Providers: uses (evidence: `server/routes/orchestrator.routes.ts`)
- Engineering Routes → Improvement Proposals: manages (evidence: `server/routes/engineering-advanced.routes.ts`)
- Engineering Routes → Repository Learning: uses (evidence: `server/routes/engineering-advanced.routes.ts`)
- Master Orchestrator → Corporate Cascade: dispatches
- Corporate Cascade → Model Providers: generates plans (evidence: `server/core/autonomy/corporate-cascade.engine.ts`)
- Corporate Cascade → Workforce Manager: uses workforce (evidence: `server/core/autonomy/corporate-cascade.engine.ts`)
- Corporate Cascade → Discovery Engine: queries intelligence (evidence: `server/core/autonomy/corporate-cascade.engine.ts`)
- Workforce Dispatch → Model Providers: requests decomposition (evidence: `server/corporation/workforce.engine.ts`)
- Workforce Dispatch → Capability Profiles: uses competencies (evidence: `server/corporation/workforce.engine.ts`)
- Workforce Manager → Capability Profiles: uses profiles
- Research Manager → Workforce Manager: uses workforce (evidence: `server/ai/company/knowledge/research.manager.ts`)
- Research Manager → Discovery Engine: requests discovery (evidence: `server/ai/company/knowledge/research.manager.ts`)
- Discovery Engine → Browser Service: uses browsing (evidence: `server/ai/company/knowledge/discovery.engine.ts`)
- Discovery Engine → Model Providers: queries model
- Repository Ingestion → Repository Learning: supplies knowledge
- Repository Learning → Model Providers: uses model (evidence: `server/knowledge/repositories/repo-learning-engine.ts`)
- Workflow Engine → Model Providers: uses workflows
- Workflow Engine → API Gateway: uses tools (evidence: `server/workflows/engine.ts`)
- Execution Kernel → Task Evaluation: supports verification
- Master Orchestrator → Failure Memory: learns from failures
- Improvement Proposals → Model Providers: generates proposals (evidence: `server/agents/capabilities/master-self-improvement/master-proposal.service.ts`)