otb_billing/docs/db_reset_rebuild_reference.md

OTB Billing Database Reset / Rebuild Reference

This is the current clean rebuild process for the otb_billing database.

Important notes:

• Base schema is loaded from sql/schema_v0.0.2.sql
• Some tables are auto-created by the app at runtime
• Aging report does NOT require its own table

Runtime-created tables:

• app_settings
• subscriptions
• email_log

---

Step 1 — Optional SQL backup

cd /home/def/otb_billing || exit 1

mysqldump -u otb_billing -p'!2Eas678' otb_billing > test-backup-before-reset.sql

---

Step 2 — Drop and recreate the database

cd /home/def/otb_billing || exit 1

sudo mysql <<'SQL' DROP DATABASE IF EXISTS otb_billing;

CREATE DATABASE otb_billing CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER IF NOT EXISTS 'otb_billing'@'localhost' IDENTIFIED BY '!2Eas678';

ALTER USER 'otb_billing'@'localhost' IDENTIFIED BY '!2Eas678';

GRANT ALL PRIVILEGES ON otb_billing.* TO 'otb_billing'@'localhost';

FLUSH PRIVILEGES; SQL

---

Step 3 — Reload base schema

cd /home/def/otb_billing || exit 1

mysql -u otb_billing -p'!2Eas678' otb_billing < sql/schema_v0.0.2.sql

---

Step 4 — Start the app

cd /home/def/otb_billing || exit 1

./run_dev.sh

---

Step 5 — Trigger runtime-created tables

Open these pages once:

/settings /subscriptions

To create email_log send one test email.

---

Step 6 — Verify rebuild worked

cd /home/def/otb_billing || exit 1

mysql -u otb_billing -p'!2Eas678' -D otb_billing -e " SHOW TABLES;

SELECT COUNT() AS clients FROM clients; SELECT COUNT() AS invoices FROM invoices; SELECT COUNT() AS payments FROM payments; SELECT COUNT() AS services FROM services; SELECT COUNT(*) AS credit_ledger FROM credit_ledger; "

---

Expected key tables

clients services invoices payments credit_ledger app_settings subscriptions email_log