Dealflow Developer OS

Internal engineering docs

Visual-first architecture explorer for Dealflow.

Use this app to understand product domains, schema ownership, API/domain boundaries, workflows, high-risk edits, and where to look before changing code. It is built for onboarding, debugging, and AI-assisted development.

Domains

11

Documented tables

18

Workflow maps

5

System Overview

Apps, API, domain packages, auth, DB, workers, and integrations.

Product Domains

Identity, portfolios, config, deals, properties, documents, CRM, work, maps, sharing.

Database Explorer

Domain-grouped ER map with tenant and read/write boundaries.

Workflow Explorer

Auth, deal creation, OM extraction, CRM, maps, and geospatial request flows.

AI Guardrails

Rules for DB writes, access control, archive/delete, and performance-sensitive areas.

Search

Search domains, tables, files, workflows, APIs, and gotchas.

New developer path

  1. 1. Read TODO.md and AGENTS.md.
  2. 2. Open System Overview to understand runtime boundaries.
  3. 3. Open Domains before editing product flows.
  4. 4. Open Database before changing schema or queries.
  5. 5. Open Workflows before adding side effects.
  6. 6. Open Guardrails before using AI to modify high-risk code.

Most important files

apps/api/src/app.ts
apps/api/src/middleware/auth.ts
apps/web/src/components/app-shell.tsx
apps/web/src/lib/api-client.ts
packages/db/src/schema/*
packages/domain/*
apps/api/src/document-worker.ts
apps/api/src/routes/explore.routes.ts