Skip to content

docs: ADR 0015 — remain on CouchDB; fix query/index performance in place#1778

Open
ivanslabbert wants to merge 1 commit into
mainfrom
1700-adr-remain-on-couchdb
Open

docs: ADR 0015 — remain on CouchDB; fix query/index performance in place#1778
ivanslabbert wants to merge 1 commit into
mainfrom
1700-adr-remain-on-couchdb

Conversation

@ivanslabbert

Copy link
Copy Markdown
Contributor

Records the outcome of the DocumentDB migration evaluation in #1700.

Decision

Remain on CouchDB. Do not re-platform to the open-source DocumentDB / FerretDB stack. Address the server-side indexing/query-performance concerns within CouchDB (index-design audit + extending ADR 0011 response caching).

Why

  • The migration is not a driver swap but a scaling-architecture redesign: our model rests on two CouchDB primitives (the _changes feed and multi-master replication) that the open-source DocumentDB stack does not provide.
  • The ADR also records the previously-implicit scaling strategy — low-cost, cloud-agnostic, homogeneous cheap peers via multi-master replication — as the binding constraint DocumentDB can't meet. Future proposals introducing a central write primary or a managed data service in the critical path are now measured against it.
  • FTS is already solved offline via our own trigram engine (ADR 0009), so CouchDB Nouveau is explicitly not adopted.

Scope

Single new file: docs/adr/0015-remain-on-couchdb.md. No code changes.

Closes #1700

🤖 Generated with Claude Code

…n place

Records the outcome of the DocumentDB migration evaluation (#1700): remain on
CouchDB and address server-side indexing/query performance in place (index-design
audit + extending ADR 0011 response caching) rather than re-platform. Also captures
the previously-implicit low-cost, cloud-agnostic scaling strategy (homogeneous
cheap peers via multi-master replication) as the binding constraint DocumentDB's
open-source stack cannot meet. FTS is already solved offline via our trigram engine
(ADR 0009), so Nouveau is explicitly not adopted.

Closes #1700

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Evaluate migrating off CouchDB to DocumentDB (PostgreSQL + MongoDB Query Language)

2 participants