New Administrator Guide

Day-to-day operations reference for Business Detonator staff. System internals are in the in-app System Reference tab (admin login required).

1 — BD System Overview

Business Detonator is a 4-layer automated marketing SaaS:

Layer	What It Does	Where It Lives
BD Hub	Web platform — client login, dashboard, content review, admin panel	businessdetonator.com
n8n	Automation engine — runs content generation, scrapers, schedulers. Calls Claude AI. Posts results to BD Hub via API.	Hetzner server (internal)
HostMDS	File & image storage — all client images, static pages, forms	files.businessdetonator.com
GHL	Publishing destination — blog, social posts, email delivery	GoHighLevel (per-client sub-account)

The flow: Client profile → n8n generates content using Claude AI → BD Hub content queue → client approves → publishes to GHL.

2 — Client Lifecycle

Stage	Status in DB	What's Active	What Triggers Change
Trial	`trial`	14 days OR 12 UCCM runs. Auto-suspends when limit hit.	Form submission → auto-provision
Active	`active`	Full access per plan. Weekly content, Hot Topics (Builder+), Competitor Monitor (Builder+).	Stripe payment confirmed
Suspended	`suspended`	Login blocked. All automation paused.	Trial expired, payment failed, or admin action

Trial limits: 14 calendar days OR 12 UCCM runs — whichever hits first. The trial-gate API checks before every run. When expired, the account auto-logs out on next page load.

3 — Admin Panel Tour

/admin.php — System Overview

Overview tab — Active users, trial pipeline, MRR, watchdog alerts. Check this daily.
Users tab — Searchable list of all clients. Click to see plan, status, last login.
Usage tab — Tool usage stats last 30 days. Spot inactive clients.
Tools tab — Subscription counts per tool.

/admin-hub.php — Active Client Management

Lists active clients with health score, pending queue count, and last UCCM run date.
Peek as User — View any client's dashboard as them (read-only) to troubleshoot.
Suspend — Immediately locks account.

/command.php — Command Center

Live MRR, trial pipeline, recent signups, n8n health. Quick financial/operational pulse.

4 — Onboarding a New Client

When a client submits the onboarding form, the system auto-provisions them. Here's what to verify:

Form submitted — Client fills onboarding form. Submission stored at files.businessdetonator.com/view-submissions.php.

n8n fires — Onboard workflow receives form data and calls /api/provision-client.php.

Auto-provisioning — Creates user record (status=trial), seeds 9 default prompts, creates client config, starts trial window, sends admin notification.

Admin notification — Check /admin.php Overview tab watchdog within 60 seconds of submission.

Verify — Confirm user record exists, trial initialized, prompts seeded (9 rows). Peek as User to confirm their dashboard loads.

Send welcome — Email temp password + login URL. Follow up to ensure they complete their profile (check health score).

Google Sheet required: Client needs a Google Sheet ID configured for UCCM to run. Check bd_client_configs.google_sheet_id in admin. If blank, content generation will fail silently.

5 — Content Management Tasks

Approve content on behalf of a client

Admin panel → admin-hub.php → Peek as User → /content-review.php → approve, edit, or reject. All actions are scoped to that client.

Edit a client's AI prompts

Admin panel → Prompts tab → search by client → edit any of the 9 content type prompts. Changes take effect on the next UCCM run. Prompts are never visible to clients.

Trigger a manual UCCM run

POST to /api/trigger-uccm.php with token and client_slug. Bypasses the Sunday schedule for immediate content generation.

Check why content isn't appearing

Is trial expired? Check trial_usage or trial-gate API response.
Is Google Sheet ID set? Check bd_client_configs.
Did UCCM run? Check n8n execution history.
Did content land in queue? Check content_queue for that user.

6 — Common Issues & Fixes

Symptom	Likely Cause	Fix
Client not seeing content	Trial expired, or UCCM hasn't run yet	Check trial_usage + n8n execution log. Trigger manual run if needed.
Content sounds generic	Profile incomplete or default prompts not customized	Check health score. Edit client prompts in admin Prompts tab.
n8n health shows red in admin	n8n process crashed	SSH to Hetzner → check Docker containers → restart.
Client can't log in	Account suspended or wrong password	Check bd_users.status in DB. Reset password via admin.
Duplicate content appearing	Dedup check not running	Check /api/dedup-check.php. Verify content_topics_used entries for that user.
Stripe events not updating	Webhook secret mismatch	Check STRIPE_WEBHOOK_SECRET in config.php. Test via Stripe dashboard.

7 — Quick Reference

Page	URL	Who Uses It
Admin Overview	/admin.php	Daily check — stats, watchdog alerts
Client Hub	/admin-hub.php	Manage active clients, peek as user
Command Center	/command.php	MRR, pipeline, system health
System Guide	/admin/guide.php (in-app)	Full system internals, API ref, DB schema
Submission Viewer	files.businessdetonator.com/view-submissions.php	All form submissions (pw: BDmaster2026!)
Onboarding Form	files.businessdetonator.com/onboard/new-client.html	Generic client onboarding

Need system internals? Log into businessdetonator.com/admin/guide.php for the full System Reference tab — infrastructure map, n8n workflow IDs, API reference, DB schema, and deployment checklist.

Admin Guide