From 3c531f86c4a6cd85cc6f01a25c67f3b2f3dec853 Mon Sep 17 00:00:00 2001
From: pyr0ball <pyroballpcs@gmail.com>
Date: Tue, 14 Apr 2026 08:36:58 -0700
Subject: [PATCH] docs(env): add COMMUNITY_DB_URL to .env.example with guidance

---
 .env.example | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.env.example b/.env.example
index b37450a..e1c674d 100644
--- a/.env.example
+++ b/.env.example
@@ -82,6 +82,13 @@ SNIPE_DB=data/snipe.db
 # Defaults to CF_ORCH_URL if unset.
 # CF_ORCH_COORDINATOR_URL=http://10.1.10.71:7700
 
+# ── Community DB (optional) ──────────────────────────────────────────────────
+# When set, seller trust signals (confirmed scammers added to blocklist) are
+# published to the shared community PostgreSQL for cross-user signal aggregation.
+# Managed instances: set automatically by cf-orch. Self-hosted: leave unset.
+# Requires cf-community-postgres container (cf-orch compose stack).
+# COMMUNITY_DB_URL=postgresql://cf_community:<password>@localhost:5432/cf_community
+
 # ── In-app feedback (beta) ────────────────────────────────────────────────────
 # When set, a feedback FAB appears in the UI and routes submissions to Forgejo.
 # Leave unset to silently hide the button (demo/offline deployments).