XY-819: [ELF prod P0] Add single-user production runbook with backup and restore

.gitignore

@@ -10,6 +10,10 @@
 *.log
 .env*
 .turbo
+/backups/
+/elf.toml
+/elf.*.toml
+!/elf.example.toml
 model
 tmp
 

README.md

@@ -189,6 +189,7 @@ Latest external research refresh: June 8, 2026.
 
 - Start here: `docs/index.md`
 - Operational guide index: `docs/guide/index.md`
+- Single-user production runbook: `docs/guide/single_user_production.md`
 - Benchmarking guides and reports: `docs/guide/benchmarking/index.md`
 - Research index: `docs/guide/research/index.md`
 - Specifications: `docs/spec/index.md`

docker-compose.yml

@@ -1,16 +1,16 @@
-name: elf-local-dev
+name: ${ELF_COMPOSE_PROJECT:-elf-local-dev}
 
 services:
   postgres:
     image: pgvector/pgvector:pg18
     environment:
-      POSTGRES_DB: elf_local
-      POSTGRES_USER: elf_dev
-      POSTGRES_PASSWORD: elf_dev_password
+      POSTGRES_DB: ${ELF_POSTGRES_DB:-elf_local}
+      POSTGRES_USER: ${ELF_POSTGRES_USER:-elf_dev}
+      POSTGRES_PASSWORD: ${ELF_POSTGRES_PASSWORD:-elf_dev_password}
     ports:
-      - "127.0.0.1:51888:5432"
+      - "${ELF_POSTGRES_BIND:-127.0.0.1}:${ELF_POSTGRES_PORT:-51888}:5432"
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U elf_dev -d elf_local"]
+      test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""]
       interval: 10s
       timeout: 5s
       retries: 10
@@ -20,11 +20,13 @@ services:
   qdrant:
     image: qdrant/qdrant:v1.16.3
     ports:
-      - "127.0.0.1:51889:6333"
-      - "127.0.0.1:51890:6334"
+      - "${ELF_QDRANT_BIND:-127.0.0.1}:${ELF_QDRANT_REST_PORT:-51889}:6333"
+      - "${ELF_QDRANT_BIND:-127.0.0.1}:${ELF_QDRANT_GRPC_PORT:-51890}:6334"
     volumes:
       - elf-qdrant-data:/qdrant/storage
 
 volumes:
   elf-postgres-data:
+    name: ${ELF_POSTGRES_VOLUME:-elf-postgres-data}
   elf-qdrant-data:
+    name: ${ELF_QDRANT_VOLUME:-elf-qdrant-data}

docs/guide/getting_started.md

@@ -169,5 +169,6 @@ Notes:
 
 - Evaluation: `docs/guide/evaluation.md`
 - Integration testing: `docs/guide/integration-testing.md`
+- Single-user production: `docs/guide/single_user_production.md`
 - Test taxonomy: `docs/guide/testing.md`
 - Agent setup: `docs/guide/agent-setup.md`

docs/guide/index.md

@@ -62,6 +62,8 @@ Then structure the body for execution:
 
 ## Guide subfolders
 
+- `docs/guide/single_user_production.md` for the single-user production runbook,
+  backup/restore path, migration checks, and Qdrant rebuild proof.
 - `docs/guide/benchmarking/` for live benchmark runbooks, report publication steps,
   and checked-in benchmark evidence.
 - `docs/guide/competitive_parity_testing.md` for running the Docker-only adoption