From aa273dd50839ddac32de9964865ea07751bff57e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lukas=20M=C3=BCllner?= <derkauzigekoala@gmail.com>
Date: Fri, 6 Mar 2026 07:04:49 +0100
Subject: [PATCH] docs: replace TPB reference with DB_README and add database
 guide scaffold

---
 DB_README.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 README.md    |  2 +-
 2 files changed, 45 insertions(+), 1 deletion(-)
 create mode 100644 DB_README.md

diff --git a/DB_README.md b/DB_README.md
new file mode 100644
index 0000000..1e6b546
--- /dev/null
+++ b/DB_README.md
@@ -0,0 +1,44 @@
+# Database & Backend Notes
+
+This document is the central place for database-related setup, schema notes, and backend conventions for car64.
+
+## Stack
+
+- Supabase Postgres
+- Supabase Auth
+- Supabase Storage
+- Supabase RPC functions
+
+## Environments
+
+Document your environment endpoints and key handling policy here.
+
+## Schema Overview
+
+Document important tables and relations here, for example:
+
+- `collections`
+- `collection_members`
+- `hotwheels`
+- `global_cars`
+- `car_votes`
+- `car_reports`
+
+## RLS Policies
+
+Document Row Level Security rules and expected access behavior.
+
+## RPC Functions
+
+List all RPC functions and their purpose.
+
+## Migration Workflow
+
+Describe how migrations are authored, reviewed, and applied.
+
+## Operational Checklist
+
+- Verify schema changes in staging first
+- Confirm RLS policy impact
+- Validate app compatibility with query/RPC changes
+- Keep rollback strategy documented
diff --git a/README.md b/README.md
index 09e40a1..17f19c2 100644
--- a/README.md
+++ b/README.md
@@ -192,5 +192,5 @@ See `LICENSE` for details.
 
 - Contributor guidelines: `CONTRIBUTING.md`
 - Security policy: `SECURITY.md`
-- Product/backend notes: `TPB.md`
+- Database and backend notes: `DB_README.md`