internal active Last verified 2026-03-29

TopoloCRM Handbook

Internal handbook for CRM runtime, API key access, and worker-backed domain records.

Owners
crm-platform
Source Repos
Applications/TopoloCRM
Systems
Topolo Auth, TopoloCRM
Tags
crm, pipeline, developer-keys

What It Is

TopoloCRM is the customer and pipeline management system for contacts, companies, deals, tasks, attachments, and property-oriented workflows.

Architecture

CRM combines a domain-specific UI with a backend worker that owns storage bindings, attachments, and API key developer access.

Runtime Surfaces

CRM runtime surfaces and worker routes are documented in the generated system handbook.

API Reference

Use /reference/apps/topolo-crm and the OpenAPI-backed reference for the current route map, operations, and request examples.

Auth and Permissions

CRM developer-key access and admin gating rely on Auth-validated org and service permissions.

Data Ownership

CRM owns CRM records, attachments, and pipeline configuration while using Auth for identity and permission validation.

Deployments

CRM deploys as a worker/backend surface with D1/KV/R2 bindings for production state.

Failure Modes

  • stale or incorrect auth role context
  • missing admin permission for API key management
  • worker binding drift between environments

Debugging

  • inspect the backend worker wrangler config
  • verify the current service ID and API key permission model
  • confirm UI and backend routes point at the same runtime host

Change Log / Verification

  • Verified against the current CRM backend and API key access model on 2026-03-29