# felipemarcianodev/rastro-ai architecture

> Architecture diagram of the GitHub repository felipemarcianodev/rastro-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/felipemarcianodev/rastro-ai
- Repository: https://github.com/felipemarcianodev/rastro-ai

## Overview

Rastro AI is a local codebase-analysis and change-planning product. A user registers a repository, requests a survey, and explores extracted feature flows and related architecture; they can also inspect database schemas and queries, ask optional AI for suggestions, edit a flow, and validate a proposed change. The map preserves those distinct capabilities. Some subsystems are documented but unsampled, so their internal links are omitted or marked unverified rather than inferred from names.

Main entry points: [`backend/src/Rastro.Api/Controllers/SurveysController.cs`](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Controllers/SurveysController.cs) (Survey endpoints), [`backend/src/Rastro.Api/Program.cs`](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Program.cs) (HTTP API), [`frontend/src/app/core/rastro-api.service.ts`](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/core/rastro-api.service.ts) (API client), [`frontend/src/app/pages/database/database.page.ts`](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/pages/database/database.page.ts) (Database views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Angular UI<br/>[app.ts]"]
  node_api_client["API client"]
  node_survey_ui["Survey views<br/>[survey.page.ts]"]
  node_db_ui["Database views<br/>[database.page.ts]"]
end

subgraph group_analysis["Code analysis"]
  node_extractor["Flow extractor<br/>[FlowExtractor.cs]"]
  node_ts_extractor["Angular extractor<br/>[walker.mjs]"]
  node_architecture["Architecture export"]
end

subgraph group_domain["Flow and change"]
  node_survey_routes["Survey endpoints"]
  node_survey_workers["Survey workers<br/>[SurveyWorker.cs]"]
  node_flow_core["Flow graph<br/>[FlowGraph.cs]"]
  node_survey_model["Survey model<br/>[Survey.cs]"]
  node_proposal["Change proposals<br/>[ProposalService.cs]"]
  node_validation["Change validation"]
  node_store[("Rastro database<br/>[RastroDbContext.cs]")]
end

subgraph group_database["Database insight"]
  node_schema["Schema extraction"]
  node_query_analysis["SQL analysis"]
  node_query_service["Query services"]
  node_query_ui_logic["Query presentation<br/>[query-analysis.ts]"]
  node_db_schema_ui["Schema presentation<br/>[db-schema.ts]"]
end

subgraph group_integrations["AI and interfaces"]
  node_api["HTTP API<br/>[Program.cs]"]
  node_ai["AI advisors<br/>[QueryAdvisor.cs]"]
  node_mcp["MCP tools<br/>[RastroTools.cs]"]
  node_cli["CLI<br/>[Program.cs]"]
end

node_user(("Engineer"))

node_user -->|"uses"| node_web
node_web -->|"requests data"| node_api_client
node_api_client -->|"calls HTTP"| node_api
node_survey_ui -.->|"requests surveys"| node_api_client
node_db_ui -.->|"requests database data"| node_api_client
node_api -.->|"routes requests"| node_survey_routes
node_survey_routes -->|"reads and writes"| node_store
node_survey_routes -->|"queues surveys"| node_survey_workers
node_survey_workers -.->|"analyzes code"| node_extractor
node_extractor -.->|"builds graph"| node_flow_core
node_survey_routes -->|"serves flow graph"| node_flow_core
node_flow_core -.->|"forms survey data"| node_survey_model
node_survey_routes -->|"creates change prompt"| node_proposal
node_proposal -.->|"validates changed code"| node_validation
node_survey_routes -.->|"exports C4"| node_architecture
node_web -.->|"starts screen trace"| node_ts_extractor
node_api -.->|"serves code schema"| node_schema
node_api -.->|"serves query analysis"| node_query_service
node_query_service -->|"analyzes SQL"| node_query_analysis
node_db_ui -.->|"formats findings"| node_query_ui_logic
node_db_ui -.->|"renders schema"| node_db_schema_ui
node_api -->|"offers optional advice"| node_ai
node_mcp -.->|"uses query services"| node_query_service
node_cli -->|"runs extraction"| node_extractor
node_survey_routes -->|"requests AI features"| node_ai

click node_web "https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/app.ts"
click node_api_client "https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/core/rastro-api.service.ts"
click node_survey_ui "https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/pages/survey/survey.page.ts"
click node_db_ui "https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/pages/database/database.page.ts"
click node_api "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Program.cs"
click node_survey_routes "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Controllers/SurveysController.cs"
click node_survey_workers "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Analysis/SurveyWorker.cs"
click node_extractor "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Extractor/FlowExtractor.cs"
click node_ts_extractor "https://github.com/felipemarcianodev/rastro-ai/blob/main/extractor-ts/lib/walker.mjs"
click node_flow_core "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Core/Graph/FlowGraph.cs"
click node_survey_model "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Core/Surveys/Survey.cs"
click node_proposal "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/Proposals/ProposalService.cs"
click node_validation "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/Validation/ChangeValidationService.cs"
click node_store "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/RastroDbContext.cs"
click node_schema "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Extractor/Database/DbSchemaExtractor.cs"
click node_query_analysis "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Extractor/Database/TSqlQueryAnalyzer.cs"
click node_query_service "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/Database/QueryAnalysisService.cs"
click node_query_ui_logic "https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/core/database/query-analysis.ts"
click node_ai "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Ai/Suggestions/QueryAdvisor.cs"
click node_mcp "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Mcp/RastroTools.cs"
click node_cli "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Cli/Program.cs"
click node_architecture "https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Core/Architecture/C4WorkspaceBuilder.cs"
click node_db_schema_ui "https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/core/database/db-schema.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_web,node_api_client,node_survey_ui,node_db_ui toneBlue
class node_extractor,node_ts_extractor,node_architecture toneAmber
class node_survey_routes,node_survey_workers,node_flow_core,node_survey_model,node_proposal,node_validation,node_store toneMint
class node_schema,node_query_analysis,node_query_service,node_query_ui_logic,node_db_schema_ui toneRose
class node_api,node_ai,node_mcp,node_cli,node_user toneIndigo
```

## Components

### User experience

- [Angular UI](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/app.ts): `frontend/src/app/app.ts`
- [API client](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/core/rastro-api.service.ts): `frontend/src/app/core/rastro-api.service.ts`
- [Survey views](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/pages/survey/survey.page.ts): `frontend/src/app/pages/survey/survey.page.ts`
- [Database views](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/pages/database/database.page.ts): `frontend/src/app/pages/database/database.page.ts`

### Code analysis

- [Flow extractor](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Extractor/FlowExtractor.cs): `backend/src/Rastro.Extractor/FlowExtractor.cs`
- [Angular extractor](https://github.com/felipemarcianodev/rastro-ai/blob/main/extractor-ts/lib/walker.mjs): `extractor-ts/lib/walker.mjs`
- [Architecture export](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Core/Architecture/C4WorkspaceBuilder.cs): `backend/src/Rastro.Core/Architecture/C4WorkspaceBuilder.cs`

### Flow and change

- [Survey endpoints](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Controllers/SurveysController.cs): `backend/src/Rastro.Api/Controllers/SurveysController.cs`
- [Survey workers](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Analysis/SurveyWorker.cs): `backend/src/Rastro.Api/Analysis/SurveyWorker.cs`
- [Flow graph](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Core/Graph/FlowGraph.cs): `backend/src/Rastro.Core/Graph/FlowGraph.cs`
- [Survey model](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Core/Surveys/Survey.cs): `backend/src/Rastro.Core/Surveys/Survey.cs`
- [Change proposals](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/Proposals/ProposalService.cs): `backend/src/Rastro.Infrastructure/Proposals/ProposalService.cs`
- [Change validation](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/Validation/ChangeValidationService.cs): `backend/src/Rastro.Infrastructure/Validation/ChangeValidationService.cs`
- [Rastro database](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/RastroDbContext.cs): `backend/src/Rastro.Infrastructure/RastroDbContext.cs`

### Database insight

- [Schema extraction](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Extractor/Database/DbSchemaExtractor.cs): `backend/src/Rastro.Extractor/Database/DbSchemaExtractor.cs`
- [SQL analysis](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Extractor/Database/TSqlQueryAnalyzer.cs): `backend/src/Rastro.Extractor/Database/TSqlQueryAnalyzer.cs`
- [Query services](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Infrastructure/Database/QueryAnalysisService.cs): `backend/src/Rastro.Infrastructure/Database/QueryAnalysisService.cs`
- [Query presentation](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/core/database/query-analysis.ts): `frontend/src/app/core/database/query-analysis.ts`
- [Schema presentation](https://github.com/felipemarcianodev/rastro-ai/blob/main/frontend/src/app/core/database/db-schema.ts): `frontend/src/app/core/database/db-schema.ts`

### AI and interfaces

- [HTTP API](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Api/Program.cs): `backend/src/Rastro.Api/Program.cs`
- [AI advisors](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Ai/Suggestions/QueryAdvisor.cs): `backend/src/Rastro.Ai/Suggestions/QueryAdvisor.cs`
- [MCP tools](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Mcp/RastroTools.cs): `backend/src/Rastro.Mcp/RastroTools.cs`
- [CLI](https://github.com/felipemarcianodev/rastro-ai/blob/main/backend/src/Rastro.Cli/Program.cs): `backend/src/Rastro.Cli/Program.cs`

### Other components

- **Engineer**

## Connections

- Engineer → Angular UI: uses (evidence: `README.md`)
- Angular UI → API client: requests data (evidence: `frontend/src/app/app.ts`)
- API client → HTTP API: calls HTTP (evidence: `frontend/src/app/core/rastro-api.service.ts`)
- Survey views → API client: requests surveys
- Database views → API client: requests database data
- HTTP API → Survey endpoints: routes requests
- Survey endpoints → Rastro database: reads and writes (evidence: `backend/src/Rastro.Api/Controllers/SurveysController.cs`)
- Survey endpoints → Survey workers: queues surveys (evidence: `backend/src/Rastro.Api/Controllers/SurveysController.cs`)
- Survey workers → Flow extractor: analyzes code
- Flow extractor → Flow graph: builds graph
- Survey endpoints → Flow graph: serves flow graph (evidence: `backend/src/Rastro.Api/Controllers/SurveysController.cs`)
- Flow graph → Survey model: forms survey data
- Survey endpoints → Change proposals: creates change prompt (evidence: `backend/src/Rastro.Api/Controllers/SurveysController.cs`)
- Change proposals → Change validation: validates changed code
- Survey endpoints → Architecture export: exports C4 (evidence: `backend/src/Rastro.Api/Controllers/SurveysController.cs`)
- Angular UI → Angular extractor: starts screen trace
- HTTP API → Schema extraction: serves code schema
- HTTP API → Query services: serves query analysis
- Query services → SQL analysis: analyzes SQL (evidence: `backend/src/Rastro.Infrastructure/Database/QueryAnalysisService.cs`)
- Database views → Query presentation: formats findings
- Database views → Schema presentation: renders schema
- HTTP API → AI advisors: offers optional advice
- MCP tools → Query services: uses query services
- CLI → Flow extractor: runs extraction (evidence: `backend/src/Rastro.Cli/Program.cs`)
- Survey endpoints → AI advisors: requests AI features
