HG Ops

Database Structure

Master Tables (permanent — never per-site)

citations_globalcitations_aucitations_perthcitations_reviewcitations_niche_{x}citations_paidcitation_platformsprompt_templatesfield_map_templatestask_templates

Per-Site Tables (keyed by site_id)

sitesserviceslocationscitationstopical_mapblog_postscontent_briefsleadspipeline_jobsactivity_logsite_field_mapscheduled_taskskeywords

Agent Memory Tables

agent_sessionsagent_tasksagent_knowledge

Server Automation (JS)

C:\laragon\api\

daemon/lifecycle-engine.jsGating engine — checks site lifecycle stage every 30min, triggers next steps when gates are met

daemon/scheduler-engine.jsBlog drip scheduler — fires blog posts on schedule from topical_map

routes/site-init.jsNew site setup — seeds site_field_map from DB when a site is initialised

routes/pipeline.jsPipeline trigger — spawns PowerShell scripts via poll-worker.ps1

routes/citations.jsCitation tracking — handles Jeff submissions, updates status in citations table

routes/leads.jsLead handling — receives inbound leads, writes to leads table

routes/trigger.jsManual pipeline triggers — POST /pipeline/trigger

routes/scheduler.jsBlog schedule management — seed and manage scheduled_tasks

routes/niche.jsNiche research — log and retrieve research ideas

routes/sites.jsSite data API — serves site data to dashboard

Pipeline ScriptsC:\laragon\scripts\ — run via poll-worker.ps1 -SiteId {id} -Job {phase}

Build 01-03-purge Creates WordPress site, installs AI1WM, imports master template, strips placeholder content

Structure 04 Reads payload, maps pages and services, writes page-map.json and services-post-map.json

Content 05-13 AI generates all page content via Claude API (parallel, max 3). Writes to content_briefs table

Images 14-18 Sources images from Pexels, scores with Claude, uploads to Cloudinary CDN

Upload 17-22 Writes generated content from DB to WordPress via WP-CLI and ACF fields

Finalise 23-29 Logo (Ideogram), brand colours, schema markup, SEO meta, sitemap. Script 28 STANDALONE only

Publish 30-31 Simply Static generates HTML, deploys to Cloudflare Pages, fires IndexNow

Post-build 32-38 Email setup (standalone), blog posts, redirects, blog schedule, drip execution, URL indexer

New Site Setup Sequence

1

Niche idea entered Dashboard or phone → creates niche_research record in DB

2

Niche research System assesses competitors, traffic, viability → traffic light: 🟢 build / 🟡 review / 🔴 store and skip

3

Setup Business name generated, ABN lookup, domain purchase → all data written to sites table immediately

4

Site init POST /pipeline/init/:siteId → seeds site_field_map, copies citation masters, copies topical map template

5

Payload generated site-init.js generates structure-payload.json FROM DB data (bridge until scripts go DB-direct)

6

Pipeline triggered poll-worker.ps1 runs phases: build → structure → content → images → upload → finalise → publish

7

Post-build Email setup (script 32, standalone), citation brief sent, blog schedule seeded

8

Lifecycle engine Monitors site every 30min, advances stages as citations + blogs accumulate

Citation Structure

Master tables are permanent. Per-site citations table is compiled from masters at setup, keyed by site_id.

citations_globalGlobal directories — work in any country

citations_auAustralian-specific directories

citations_perthPerth-specific directories (add city variants for new locations e.g. citations_bunbury)

citations_reviewReview platforms — Google, Facebook, etc

citations_niche_{x}Niche-specific — one per niche e.g. citations_niche_boatdetailing

citations_paidPaid/excluded platforms — kept as reference, not included in briefs

citation_platformsConsolidated master — kept temporarily to reconcile other tables, will be dropped after

Key Server Paths

API serverC:\laragon\api\hgops-api-server.jsPort 3571, Windows service: hgopsapiserver.exe

AgentC:\laragon\agent\hgops-agent.jsAutonomous agent, agentic loop, RAG memory

Pipeline scriptsC:\laragon\scripts\Scripts 01-38 + named utilities

WordPress sitesC:\laragon\www\{siteId}\One folder per site

Site stateC:\laragon\www\{siteId}\_state\Payload, services-post-map, email creds

Agent memoryC:\laragon\agent\memory\context.md, summary.md, notes.log

SecretsC:\laragon\secrets\All API keys — never hardcode

Strategy docsC:\laragon\strategy\Business docs, citation master sheet