COMPASS — MASTER FILE (v2025-08-12)
A single place to anchor all active work. Project-specific Compasses will be spawned from here.
0) How we use this Compass
State Block for each work session
- Context: 1–3 lines (what we’re touching today)
- Source of Truth: repo/folder links/paths
- Today’s Goal: bullets
- Open Decisions: bullets
When a choice is final, say “Lock this decision.”
Defaults (global)
- Mode control: QUICK, STEPWISE(n), PATCH-ONLY, FULL-FILE
- Scope control: SINGLE-ISSUE vs MULTI-LAYER
- Research control: Verify with web vs No-search
- Code delivery: FULL-FILE, target paths first, no new filenames without rationale, old lines commented, include build/env notes
- Troubleshooting: explicit, step-by-step (incl. prep/cleanup)
- Timezone: America/St_Johns
Pointer: See Global Memory — Foundation (v2025-08-12) for evergreen rules we keep in ChatGPT Memory.
1) WP Ultimate Booking System (WPUBS)
Snapshot
Custom WordPress booking plugin with Daily / Hourly / Minute calendars, AJAX booking + blockout, shortcode-driven widgets, and evolving Admin UI (Booking Site(s) dashboards, calendar viewers, movement tools).
Locked Decisions
- Shortcodes (canonical): [wpubs_booking_widget], [wpubs_booking_grid], [wpubs_owner_login].
- Widget is shortcode-only; do not auto-insert into single item pages.
- Admin filename clarity: where collisions are possible under includes/admin/pages/, append -admin.php.
- Versioning: incremental decimals; upgrade-in-place workflow with upgrade routine.
- Calendars: support Daily, Hourly, and Minute (10/15/30/45) modes; front-end calendar loads per Settings; back-end viewers per calendar type.
- Blockout logic: Daily/Hourly/Minute tables; enforce booking caps (single room vs multi-room vs group sessions) per design.
- Booking Site(s) architecture: main menu Booking Site(s); each site gets a dashboard, site-specific calendars, item linkage, per-site shortcodes (e.g., [wpubs_calendar_view site_id=”…”]), and “Add Another Booking Site” when multi-site is enabled.
- Shortcodes list shown in Settings (separate section).
Known Data/Schema Notes
- wpubs_bookings_hourly.booking_hour = INT (fixed).
- wpubs_bookings_minute.booking_time = INT(4) (ready).
- booking_item_id present in both hourly & minute tables.
Build / Run / Install
- WordPress plugin path (typical): /wp-content/plugins/wpubs/
- Upgrade by uploading new zip and using plugin’s upgrade routine (no manual reinstall).
Source of Truth (fill)
- Repo/Drive path:
- Staging site URL:
- Production site URL:
Current Risks / Issues
- Ensure Hourly/Minute admin viewers display booking data + delete controls (was pending earlier; verify current).
- Keep test/demo code out of production builds.
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass created; locked decisions consolidated.
2) Safety App (Flutter)
Snapshot
Cross-platform (Android/iOS/Web for HQ). Local mini-database with later HQ sync; signature capture; light app footprint with clean, industrial UI.
Locked Decisions
- Preferred stack: Flutter; rich UI acceptable; keep bundle size reasonable.
- Web (Chrome) is optional runtime; mobile is primary.
- Database: local store now; sync layer later; DB operator chosen for modularity and upgradability.
- UI: grid-based home (4×4 or similar) with clear navigation; signature capability included.
Build / Dev Flow
bash
CopyEdit
flutter clean
flutter pub get
flutter pub run build_runner build –delete-conflicting-outputs
flutter run -d <device> # e.g., chrome / android / ios
Source of Truth (fill)
- Repo/Drive path:
- Package IDs (Android/iOS):
- Minimum OS targets:
Current Risks / Issues
- Chrome build failures tied to SQL plugin behavior — audit db.dart & related deps; align with selected operator.
- Ensure we never rename files without explicit rationale; list target paths first before edits.
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
3) Sorte CRM Scraper → EspoCRM
Snapshot
Lead scraper prioritizing Google Business Profiles, with fallbacks (YellowPages, 411.ca, social). Outputs CSVs for EspoCRM import; packaged as an installable app with single-line build scripts.
Locked Decisions
- Primary data: GBP; automatic deep search if website/email missing.
- Output filenames timestamped; ensure safe data/ path handling.
- Packaging: provide single-line build scripts (dev → exe).
- EspoCRM import rules: phone = +1 ########## (space after +1); multiple emails in separate columns (not comma-separated).
Source of Truth (fill)
- Repo/Drive path:
- Inno Setup / packaging script path:
- .env variables required:
Today’s Tasks
- (fill)
Open Questions
- De-dupe logic on future scrapes (exact match vs fuzzy?)
Changelog
- 2025-08-12: Master Compass entry seeded.
4) FJG WordPress Theme
Snapshot
Custom, modular theme. Multiple header (5–6) and footer (3) layouts via Customizer. Enforce global logo sizing; minimal default chrome (no inner-page headers/breadcrumbs); generic title/subtitle parts. Strict HTML/CSS hygiene.
Locked Decisions
- Customizer toggles for headers/footers; transparent header option; optional tagline bar above header.
- Global logo sizing = 75% of header height (or proportional within header).
- No automatic booking widget placement (handled by WPUBS shortcode on page).
- Build everything as clean, modular components; no placeholders.
Missing / To-create Files (not exhaustive)
- comments.php, search.php, template-home.php
- templates/layouts/layout-*.php (left/right/both sidebars)
- templates/parts/generic-title.php, templates/parts/generic-subtitle.php
- languages/fjg-wp-theme.pot
- assets/js/custom-script.js
- screenshot.png (placeholder ok)
Source of Truth (fill)
- Repo/Drive path:
- Theme slug:
- Supported PHP/WP versions:
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
5) Trust Business Group — Business Plan & NL Market Analyses
Snapshot
Market-by-market analyses for NL and Canada; supplier mapping (e.g., Spicers, RB Digital); highlight safety/CORE documentation opportunities.
Locked Decisions
- Deliver analyses one industry at a time, copy-paste-ready for the plan.
- Use a consistent template: market size, key players, supply chain, opportunities, risks, action plan.
Source of Truth (fill)
- Drive path:
- Document template path:
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
6) Daily News Analysis (Biz + Politics, incl. M&A)
Snapshot
Daily morning review (~20 business + ~20 politics/world). Extract patterns, quantify impact for SMBs, compare with historical analogues. Align guidance with FJG strategy & Profit Cultivation.
Locked Decisions
- Include M&A section.
- Cite sources when recency matters; summarize into actionable guidance for SMB owners.
Source of Truth (fill)
- Drive path for daily logs:
- Preferred news sources list:
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
7) EspoCRM Outreach & Deliverability
Snapshot
End-to-end outreach via EspoCRM: imports, templated emails, jobs/cron, domain auth (SPF/DKIM/DMARC) tuned for deliverability.
Locked Decisions
- Maintain valid SPF/DKIM/DMARC; re-check after DNS/provider changes.
- Use template placeholders: {today}, {now}, {currentYear}, {optOutUrl}, {optOutLink}.
- Survey email (6 Qs) with expanded website questions preferred in HTML.
Source of Truth (fill)
- EspoCRM instance URL:
- SMTP settings doc:
- Template library path:
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
8) Client Sites (Duralite / Catamaran Park / AJ Liquidation)
Snapshot
- Duralite Diamond Drills: SEO visibility push; include concrete metrics in case study.
- Catamaran Park: migrate ESHB → WPUBS; booking/calendar parity; site moved to root.
- AJ Liquidation: website + concept for internal comm/scheduling/safety app.
Locked Decisions
- Document before/after KPIs for each client (traffic, leads, rankings, load times).
- Keep implementation notes + stack in client folders.
Source of Truth (fill)
- Client folders/paths:
- Access credentials (store securely; not in Compass):
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
9) Profit Cultivation System & Sermons
Snapshot
Business and leadership frameworks grounded in scripture. Develop teaching materials and daily video series on cultivating profit.
Locked Decisions
- Four Pillars of Action: Identity, Conviction, Intention, Expectation.
- Frameworks used across content: Hook→Problem→Principle→Plan→Promise, Teach→Testify→Transform.
- Compile 13 years of sermons; produce structured, scannable outlines.
Source of Truth (fill)
- Drive folder with sermons:
- Content calendar path:
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
10) Biblical Research Program (OT/NT Economics & Cultivation)
Snapshot
Deep study linking biblical economic models to modern practice.
Locked Decisions
- Research order: Genesis → Torah → First Three Kings → Good Kings of Judah → NT expansions.
- Include Strong’s references and Benner’s Ancient Hebrew Lexicon insights.
- Track models: multi-streams, real estate, crafts, transport, etc.
Source of Truth (fill)
- Research notes path:
- Citation library (commentaries, lexicons):
Today’s Tasks
- (fill)
Open Questions
- (fill)
Changelog
- 2025-08-12: Master Compass entry seeded.
11) Operating Rhythm (applies to all)
- Prefer one project per thread when possible.
- Use State Blocks to start sessions.
- Keep DECISIONS.md, FILEMAP.md, CHANGELOG.md, TASKS-TODAY.md, OPEN-QUESTIONS.md, BUILD-NOTES.md inside each project’s Compass folder.
- For speed, ask: “Mode: QUICK | Scope: SINGLE-ISSUE | Patch-only.”
- For full rebuilds, ask: “Mode: FULL-FILE | Respect manifest.”
