How datarecce/recce works
Recce is a dbt change-review application: data teams launch a local server, inspect model and column lineage, run comparisons or queries across environments, and record findings in a review checklist. The UI presents lineage, query, and check workflows; its API layer connects those workflows to the Python server and comparison tasks. Recce Cloud adds collaboration and checklist synchronization. The README documents capabilities beyond the sampled source, so those are represented at subsystem level; unsampled backend wiring is left general rather than inferred.
Main entry points: page.tsx Recce web app · index.ts UI API clients · QueryPageOss.tsx Query workflow · CheckPageContentOss.tsx Checks and checklist
Components 16
Review UI
- Recce web app
js/app/page.tsx - Lineage and impact
js/packages/ui/src/components/lineage/LineagePageOss.tsx - Query workflow
js/packages/ui/src/components/query/QueryPageOss.tsx - Checks and checklist
js/packages/ui/src/components/check/CheckPageContentOss.tsx - Diff result views
js/packages/ui/src/components/result/createResultView.tsx - UI API clients
js/packages/ui/src/api/index.ts
Local Recce
- HTTP server
recce/server.py - Query tasks
recce/tasks/query.py
Impact Checks
- Lineage selection
js/packages/ui/src/api/select.ts - Query and diff API
js/packages/ui/src/api/adhocQuery.ts - Check APIs
js/packages/ui/src/api/checks.ts
Cloud Collaboration
- Cloud API client
recce_cloud/recce_cloud/api/client.py - Cloud diagnostics
recce_cloud/recce_cloud/services/diagnostic_service.py
Other components
- Data reviewer
- dbt warehouse
- Recce Cloud
Connections 18
- Data reviewer → Recce web app: uses
- Recce web app → Lineage and impact: opens lineage
- Recce web app → Query workflow: opens query
- Recce web app → Checks and checklist: reviews checks
- Lineage and impact → Lineage selection: requests selection
- Query workflow → Query and diff API: submits queries
- Checks and checklist → Check APIs: manages checks
- Lineage selection → UI API clients: uses client
- Query and diff API → UI API clients: uses client
- Check APIs → UI API clients: uses client
- UI API clients → HTTP server: HTTP requests
- HTTP server → Query tasks: dispatches tasks
- Query tasks → dbt warehouse: executes SQL
- Query workflow → Diff result views: shows results
- Checks and checklist → Diff result views: shows diffs
- HTTP server → Cloud API client: syncs state
- Cloud API client → Recce Cloud: calls API
- Cloud diagnostics → Cloud API client: checks setup