application public active Verified 2026-04-07

TopoloCRM

CRM workflows, records, and SDR inbox/control-plane services exposed through the platform auth layer.

Documentation Map

What It Is

CRM workflows, records, and SDR inbox/control-plane services exposed through the platform auth layer.

Canonical documentation for TopoloCRM lives in `PlatformApplications/TopoloDocs`.

Use this repository for implementation only. Local product and operational docs have been retired in favor of the docs application.

Architecture

Owners: crm

Source repos: PlatformApplications/TopoloCRM

Dependencies: topolo-auth, topolo-one

Repo shape

  • PlatformApplications/TopoloCRM/README.md
  • PlatformApplications/TopoloCRM/all-contacts.csv
  • PlatformApplications/TopoloCRM/app/
  • PlatformApplications/TopoloCRM/backend.log
  • PlatformApplications/TopoloCRM/docs/
  • PlatformApplications/TopoloCRM/frontend.log
  • PlatformApplications/TopoloCRM/infra/
  • PlatformApplications/TopoloCRM/package-lock.json
  • PlatformApplications/TopoloCRM/package.json
  • PlatformApplications/TopoloCRM/packages/
  • PlatformApplications/TopoloCRM/pnpm-lock.yaml
  • PlatformApplications/TopoloCRM/postman-collection.json
  • PlatformApplications/TopoloCRM/scripts/
  • PlatformApplications/TopoloCRM/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://crm.topolo.app
topolo-crm-frontend

Config: PlatformApplications/TopoloCRM/app/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

edge-crm

Config: PlatformApplications/TopoloCRM/packages/backend/wrangler.toml

Main: index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: OpenAPI-backed

Source: PlatformApplications/TopoloCRM/packages/backend/openapi.yaml

Source exists in repo: yes

App API page: /reference/apps/topolo-crm

Generated OpenAPI page: /reference/generated/topolo-crm

Operations: 23

Security schemes: none declared

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

srv_iCwM4jGXcwlj

API key scopes

contacts.read

View CRM contacts

Resource pattern: none

contacts.write

Manage CRM contacts

Resource pattern: none

companies.read

View CRM companies

Resource pattern: none

companies.write

Manage CRM companies

Resource pattern: none

deals.read

View CRM deals

Resource pattern: none

deals.write

Manage CRM deals

Resource pattern: none

notes.read

View CRM notes

Resource pattern: none

notes.write

Manage CRM notes

Resource pattern: none

attachments.read

View CRM attachments

Resource pattern: none

attachments.write

Manage CRM attachments

Resource pattern: none

pipeline.read

View pipeline configuration

Resource pattern: none

pipeline.write

Manage pipeline configuration

Resource pattern: none

tasks.write

Manage CRM tasks

Resource pattern: none

properties.write

Manage property records

Resource pattern: none

listings.write

Manage property listings

Resource pattern: none

showings.write

Manage property showings

Resource pattern: none

offers.write

Manage property offers

Resource pattern: none

transactions.write

Manage CRM transactions

Resource pattern: none

documents.write

Manage CRM documents

Resource pattern: none

commissions.write

Manage CRM commissions

Resource pattern: none

Service permissions

contacts:read, contacts:write, deals:read, deals:write, activities:read, activities:write, reports:read

Data Ownership

d1

Binding: CRM_DB

Target: 00000000-0000-0000-0000-000000000000

Environment: default

Source: PlatformApplications/TopoloCRM/packages/backend/wrangler.toml

d1

Binding: CRM_DB

Target: cf93b0b6-8a56-4516-a0c7-4e2d8dee4157

Environment: stg

Source: PlatformApplications/TopoloCRM/packages/backend/wrangler.toml

r2

Binding: crm_attachments

Target: edge-crm-attachments-staging

Environment: stg

Source: PlatformApplications/TopoloCRM/packages/backend/wrangler.toml

d1

Binding: CRM_DB

Target: 77e9aeb0-fb0d-48a7-adb1-e0ce6700ab89

Environment: prod

Source: PlatformApplications/TopoloCRM/packages/backend/wrangler.toml

kv

Binding: CRM_KV

Target: 2bf87302ccb04e43bda3c946a1d7f15b

Environment: prod

Source: PlatformApplications/TopoloCRM/packages/backend/wrangler.toml

r2

Binding: crm_attachments

Target: edge-crm-attachments-production

Environment: prod

Source: PlatformApplications/TopoloCRM/packages/backend/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

API_KEY_HASH_ITERATIONS API_KEY_PREFIX ENVIRONMENT NODE_ENV SALT_ROUNDS SKIP_AUTH account_id

All wrangler bindings

  • CRM_DB (d1) -> 00000000-0000-0000-0000-000000000000
  • CRM_DB (d1) -> cf93b0b6-8a56-4516-a0c7-4e2d8dee4157 [stg]
  • crm_attachments (r2) -> edge-crm-attachments-staging [stg]
  • CRM_DB (d1) -> 77e9aeb0-fb0d-48a7-adb1-e0ce6700ab89 [prod]
  • CRM_KV (kv) -> 2bf87302ccb04e43bda3c946a1d7f15b [prod]
  • crm_attachments (r2) -> edge-crm-attachments-production [prod]

Deployments

Deployment environments: dev, stg, prod

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

Wrangler surfaces

  • PlatformApplications/TopoloCRM/app/wrangler.toml -> topolo-crm-frontend
  • PlatformApplications/TopoloCRM/packages/backend/wrangler.toml -> edge-crm (assets ./public)

Build and deploy commands

  • build — PlatformApplications/TopoloCRM/app/package.json :: vite build
  • preview — PlatformApplications/TopoloCRM/app/package.json :: vite preview
  • deploy:stg — PlatformApplications/TopoloCRM/app/package.json :: VITE_API_URL=https://edge-crm-stg.topolo.workers.dev/api VITE_APP_NAME=NodoCRM VITE_APP_VERSION=1.0.0 npm run build && npx wrangler pages deploy dist --project-name=topolo-crm-frontend-staging
  • deploy:prod — PlatformApplications/TopoloCRM/app/package.json :: VITE_API_URL=https://crm-api.topolo.app/api VITE_APP_NAME=NodoCRM VITE_APP_VERSION=1.0.0 npm run build && npx wrangler pages deploy dist --project-name=topolo-crm-frontend
  • build — PlatformApplications/TopoloCRM/package.json :: npm run build --workspace=packages/backend
  • build:app — PlatformApplications/TopoloCRM/package.json :: npm run build --workspace=app
  • build:all — PlatformApplications/TopoloCRM/package.json :: npm run build && npm run build:app
  • deploy:stg — PlatformApplications/TopoloCRM/package.json :: npm run deploy:stg --workspace=packages/backend
  • deploy:prod — PlatformApplications/TopoloCRM/package.json :: npm run deploy:prod --workspace=packages/backend
  • deploy:app:stg — PlatformApplications/TopoloCRM/package.json :: npm run deploy:stg --workspace=app
  • deploy:app:prod — PlatformApplications/TopoloCRM/package.json :: npm run deploy:prod --workspace=app
  • deploy:all:stg — PlatformApplications/TopoloCRM/package.json :: npm run deploy:stg && npm run deploy:app:stg
  • build — PlatformApplications/TopoloCRM/packages/backend/package.json :: tsc --noEmit && echo 'Build validation successful'
  • build:deploy — PlatformApplications/TopoloCRM/packages/backend/package.json :: wrangler deploy --dry-run
  • deploy:dry-run — PlatformApplications/TopoloCRM/packages/backend/package.json :: wrangler deploy --dry-run --outdir .wrangler/build
  • deploy:stg — PlatformApplications/TopoloCRM/packages/backend/package.json :: wrangler deploy --env stg

Failure Modes

No default failure-mode heuristics are currently flagged for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloCRM/app/wrangler.toml
  • PlatformApplications/TopoloCRM/packages/backend/wrangler.toml
  • PlatformApplications/TopoloCRM/packages/backend/openapi.yaml
  • PlatformApplications/TopoloCRM/README.md
  • PlatformApplications/TopoloCRM/app/package.json
  • PlatformApplications/TopoloCRM/package.json
  • PlatformApplications/TopoloCRM/packages/backend/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-07

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.