Skip to main content

KB-008: Visual Reference Guide

Target Audience: All team members (quick visual reference)

Purpose: Quick visual reference for Symphony Core's Extendly Small Business Snapshot architecture, workflows, and processes. Use this when you need a quick diagram or flowchart without reading lengthy documentation.

Estimated Reading Time: 20 minutes (or just jump to the diagram you need!)


Table of Contents​

  1. System Architecture Diagrams
  2. Customer Journey Flows
  3. Module Integration Maps
  4. Naming Convention Visual Guides
  5. Troubleshooting Flowcharts
  6. Quick Reference Cards

1. System Architecture Diagrams​

1.1 Overall System Stack​

┌─────────────────────────────────────────────┐
│ Symphony Core Service Delivery Layer │ ← Our expertise, training, support
├─────────────────────────────────────────────┤
│ Extendly Small Business Snapshot (Base) │ ← Pre-built automation (11 modules)
├─────────────────────────────────────────────┤
│ GoHighLevel CRM Platform (White-labeled) │ ← Underlying platform
└─────────────────────────────────────────────┘

Reference: See KB-005:Section 2 for detailed architecture


1.2 Two-Stage Customization Model​

Key:

  • White (thick border): Imported third-party snapshots
  • Blue: Symphony Core customization layer (A-prefix features)
  • Tan/Yellow: Universal Base (foundation for all industries)
  • Green: Industry Base (SC + Industry features)
  • Teal: Live client accounts
  • Light Green: Demo accounts

Core Principle: Yellow + Blue = Green

  • Blue = SC customizations (agency-wide)
  • Yellow = Industry-specific features
  • Green = Combined (ready for deployment)

Reference: See KB-006:Section 3 for detailed two-stage model


1.3 Module Hierarchy​

Extendly Small Business Snapshot
│
├── TIER 1: Foundation (Core System)
│ └── B-000. Foundations
│ ├── Business info, branding
│ ├── Social media links
│ ├── Custom values system
│ └── ExtendlyOS configuration
│
├── TIER 2: Essential Automation (The Big 5)
│ ├── B-004. Database Reactivation (52-week nurture)
│ ├── B-007. Calendar Automations (The Hub)
│ ├── B-009. Review Automations (reputation building)
│ ├── B-011. Lead Form Automations (lead capture)
│ └── B-016. Referral Automations (growth engine)
│
├── TIER 3: Supporting Features
│ ├── B-003. List Cleanup (database hygiene)
│ ├── B-005. Payment Automations (revenue processing)
│ └── B-006. Request A Callback (immediate response)
│
└── TIER 4: Specialized Tools
├── B-015. Subscription Preferences (compliance)
└── B-017. Link Tree (social media hub)

Reference: See KB-002 for complete module descriptions


2. Customer Journey Flows​

2.1 Complete Customer Lifecycle​

Key Stages:

  1. Capture → B-011 Lead Form Automations (instant response)
  2. Book → B-007 Calendar Automations (The Hub)
  3. Convert → Pipeline progression, proposal
  4. Grow → B-009 Reviews + B-016 Referrals + B-004 Long-term Nurture

Reference: See KB-001:Section 2 for 4-stage journey details


2.2 Custom Values Flow​

Fill Once, Use Everywhere:

  • 1 form (30 minutes) → 98 custom values → 870+ locations updated
  • Example: business_name appears in emails, SMS, pages, workflows, forms

Reference: See KB-003:Section 1 for custom values system details


2.3 Review Generation Flow​

Why This Works:

  1. Positive feedback → Public review platforms (amplify good)
  2. Negative feedback → Internal resolution first (fix before public)
  3. Compliance: Customers can always leave honest reviews (not blocked)

Reference: See KB-002:2.2 for B-009 Review Automations details


3. Module Integration Maps​

3.1 The Big 5 Core Modules​

┌───────────────────────────────────────────────────────────────┐
│ THE BIG 5 MODULES │
│ (Essential Automation) │
└───────────────────────────────────────────────────────────────┘

B-004: Database Reactivation (Forever Follow-Up)
├─ 52-week SMS nurture campaign
├─ Annual email sequence
├─ Re-engagement triggers
└─ Custom values: dr_initial_message, dr_offer_url

B-007: Calendar Automations (The Hub)
├─ Booking & confirmations
├─ 10-min & 2-min reminders
├─ Meeting Status Update Form (THE HUB)
└─ Custom values: user profiles, calendar URLs

B-009: Review Automations (Reputation Engine)
├─ Post-service satisfaction surveys
├─ Intelligent routing (positive → public)
├─ Negative feedback resolution
└─ Custom values: gmb_review_link, yelp_link

B-011: Lead Form Automations (Lead Capture)
├─ Multi-source lead capture
├─ Instant response (< 5 sec)
├─ Source attribution
└─ Custom values: instant_response_message

B-016: Referral Automations (Growth Engine)
├─ Automated referral requests
├─ Link-based tracking
├─ Reward distribution
└─ Custom values: referral_offer_description

Integration Points:

  • B-011 captures lead → B-007 books appointment → B-009 requests review → B-016 requests referral → B-004 nurtures long-term

Reference: See KB-002:Section 2 for detailed module descriptions


3.2 Critical Dependency Map​

Required Setup (Must Be Done First):
│
├─ 1. Domain Connection
│ ├─ Settings → Domains → Add Domain
│ ├─ Configure DNS (A record, CNAME)
│ ├─ Wait for SSL (24-48 hours)
│ └─ Impact: ALL pages, funnels, forms
│
├─ 2. Email Dedicated Domain
│ ├─ Settings → Email Services → Dedicated Domain
│ ├─ Configure DNS (SPF, DKIM, DMARC)
│ ├─ Warm up domain (gradual sending)
│ └─ Impact: ALL email deliverability
│
├─ 3. Phone Number
│ ├─ Settings → Phone Numbers → Purchase
│ ├─ Must be SMS-capable
│ └─ Impact: ALL SMS automation
│
├─ 4. Calendar Connection
│ ├─ Settings → Calendar → Connect Google/Outlook
│ ├─ Set availability hours
│ └─ Impact: B-007 Calendar Automations
│
├─ 5. Custom Values (98 total)
│ ├─ Complete ExtendlyOS form (30-45 min)
│ ├─ OR manually populate critical values
│ └─ Impact: ALL templates, pages, workflows
│
└─ 6. GMB Integration (Optional but Important)
├─ Settings → Integrations → Connect Google
├─ Get GMB review link
└─ Impact: B-009 Review Automations

Reference: See KB-004 for complete onboarding checklist


4. Naming Convention Visual Guides​

4.1 Spaces vs. Hyphens Quick Guide​

┌─────────────────────────────────────────────────────────────┐
│ SPACES vs. HYPHENS RULE │
├─────────────────────────────────────────────────────────────┤
│ │
│ SNAPSHOTS: NO SPACES, USE HYPHENS │
│ ├─ z.sc.Real-Estate-Base-2025-10-06-v1 │
│ ├─ z.sc.Prof-Services-Base-2025-10-16-v1 │
│ └─ z.sc.Small-Biz-Base-2025-10-15-v1 │
│ │
│ SUB-ACCOUNTS: SPACES ALLOWED │
│ ├─ z.sc Base Real Estate │
│ ├─ z.sc Base Prof Services │
│ └─ z.sc Seed │
│ │
│ WORKFLOWS: SPACES IN DESCRIPTION ONLY │
│ ├─ A-WF-1.0. Initial Client Branding Setup │
│ ├─ B-007-WF-1.1. Appointment Confirmations │
│ └─ C-WF-1.0. Custom Service Routing │
│ │
│ FOLDERS: SPACES IN NAME ONLY │
│ ├─ A-001. Symphony Core Branding │
│ ├─ B-007. Calendar Automations │
│ └─ C-001. Custom HVAC Workflows │
│ │
└─────────────────────────────────────────────────────────────┘

Reference: See KB-006:Section 1 and 2 for naming standards


4.2 A/B/C Prefix Decision Tree​

Need to create new workflow or folder?
│
├─ Q1: Does this apply to ALL Symphony Core clients?
│ │
│ ├─ YES → Use A-prefix
│ │ └─ Add to z.sc Seed account
│ │
│ └─ NO → Continue to Q2
│
├─ Q2: Is this from imported Extendly snapshot?
│ │
│ ├─ YES → Already has B-prefix
│ │ └─ Don't create new B-items
│ │ └─ If need to modify, create C-prefix alternative
│ │
│ └─ NO → Continue to Q3
│
├─ Q3: Is this industry-specific (multiple clients in vertical)?
│ │
│ ├─ YES → Use C-prefix in industry base account
│ │ └─ Will deploy to all clients in that industry
│ │
│ └─ NO → Continue to Q4
│
└─ Q4: Is this for one specific client only?
│
├─ YES → Use C-prefix in client account
│ └─ Client-specific numbering
│
└─ NO → Reconsider
└─ Probably should be A- or B-

Reference: See KB-006:Section 5 for workflow naming conventions


4.3 Version Management at a Glance​

VERSION IMPACT MATRIX
─────────────────────────────────────────────────────────────

Change Type │ Affected Layer │ Version Change
─────────────────────────┼────────────────────┼─────────────────
SC feature added │ Universal Base │ v1 → v2
(A-prefix workflow) │ ALL industries │ All increment to v2
│ │
Industry feature added │ Single industry │ RE: v1 → v2
(RE-specific) │ Real Estate only │ Others stay v1
│ │
Bug fix │ Where bug exists │ v2 (broken) → v3 (fixed)
│ │ Skip broken version number
│ │
Rollback needed │ Any layer │ Load previous archive
│ │ Document as rollback
│ │
New Extendly release │ Universal Base │ Option A: Restart at v1
│ Rebuild entire stack│ Option B: Continue sequence
─────────────────────────────────────────────────────────────

Reference: See KB-006:Section 4 for version management


5. Troubleshooting Flowcharts​

5.1 Master Diagnostic Flow​

Issue Reported
│
├─ Gather Information
│ ├─ What's not working? (specific symptom)
│ ├─ When did it start? (timing)
│ ├─ What changed? (recent updates)
│ ├─ Who's affected? (scope)
│ └─ Can you reproduce? (consistency)
│
├─ 5-Minute Quick Checks
│ ├─ 60 sec: Check obvious (published? connected?)
│ ├─ 2 min: Review recent changes
│ └─ 2 min: Test with fresh contact
│
├─ Issue Type Identification
│ ├─ Workflow not triggering → See KB-007:2.2
│ ├─ Email/SMS not sending → See KB-007:2.3
│ ├─ Calendar issues → See KB-007:2.4
│ ├─ Custom values → See KB-007:2.5
│ ├─ Pages not loading → See KB-007:2.6
│ └─ Other → General diagnostics
│
├─ Follow Decision Tree
│ └─ Systematic troubleshooting (not random guessing)
│
├─ Resolution
│ ├─ Fixed? → Document solution
│ └─ Not fixed? → Escalate (see KB-007:4)
│
└─ Prevention
└─ Update documentation, add to checklist

Reference: See KB-007 for complete troubleshooting guide with detailed decision trees


5.2 When to Escalate​

┌─────────────────────────────────────────────────────────────┐
│ ESCALATION DECISION │
├─────────────────────────────────────────────────────────────┤
│ │
│ ESCALATE IMMEDIATELY: │
│ 🔴 System-wide outage (all clients affected) │
│ 🔴 Data loss or corruption │
│ 🔴 Security breach suspected │
│ 🔴 Critical workflow completely broken │
│ │
│ ESCALATE AFTER TROUBLESHOOTING: │
│ 🟡 30+ minutes without resolution │
│ 🟡 Multiple clients affected │
│ 🟡 Root cause unclear after decision trees │
│ 🟡 Requires GHL platform fix │
│ │
│ DO NOT ESCALATE: │
│ 🟢 Configuration error (fix it) │
│ 🟢 User training issue (educate) │
│ 🟢 Custom value not filled (fill it) │
│ 🟢 Expected behavior (explain) │
│ │
└─────────────────────────────────────────────────────────────┘

Reference: See KB-007:Section 4 for escalation guide


6. Quick Reference Cards​

6.1 Critical Custom Values (Top 15)​

RankCustom ValueWhy CriticalModule
1business_nameUsed 500+ locationsB-000
2domainRequired for all pagesB-000
3business_phoneSMS sender, contactB-000
4business_emailEmail sender, reply-toB-000
5logo_urlVisual brandingB-000
6gmb_review_link80% of review requestsB-009
7primary_brand_colorVisual consistencyB-000
8schedule_a_call_page_urlMain calendar CTAB-007
9client_meeting_status_update_urlTHE HUBB-007
10dr_initial_outreach_messageB-004 first contactB-004
11referral_offer_descriptionReferral programB-016
12lead_connector_phoneSMS automationB-000
13hours_of_operationTemplates, auto-responsesB-000
14user_1_nameTeam calendarsB-007
15dr_offer_landing_urlB-004 destinationB-004

Reference: See KB-003:5.1 for complete custom values reference


6.2 Snapshot Naming Cheatsheet​

┌─────────────────────────────────────────────────────────────┐
│ SNAPSHOT NAMING TEMPLATES │
├─────────────────────────────────────────────────────────────┤
│ │
│ Universal Base: │
│ Format: z.sc.Base-[YYYY-MM-DD]-v[#] │
│ Example: z.sc.Base-2025-10-10-v1 │
│ │
│ Industry Base: │
│ Format: z.sc.[Industry]-Base-[YYYY-MM-DD]-v[#] │
│ Example: z.sc.Real-Estate-Base-2025-10-06-v1 │
│ │
│ Archive: │
│ Format: Archive-[Original-Name]-[YYYY-MM-DD] │
│ Example: Archive-z.sc.Base-2025-10-10-v1-2025-10-25 │
│ │
│ Imported (Cannot Change): │
│ Example: Universal Small Business By Extendly | 07/29/2025│
│ │
└─────────────────────────────────────────────────────────────┘

Reference: See KB-006:10 for all naming templates


6.3 Module Capability Matrix​

ModuleAutomation LevelConfiguration TimeKey FeatureCritical Value
B-000Foundation30-45 minExtendlyOS formbusiness_name
B-004⚡ Automated (52 weeks)15 minForever follow-updr_initial_message
B-007⚡ Automated20 minTHE HUBmeeting_status_url
B-009⚡ Automated10 minReview routinggmb_review_link
B-011⚡ Instant (< 5 sec)10 minLead captureinstant_response
B-016⚡ Automated10 minReferral trackingreferral_offer_desc
B-003🔄 Background5 minList cleanupAuto-managed
B-005🔄 Automated15 minPayment processingOptional
B-006⚡ Instant10 minCallback systemvoicemail_url
B-015👤 User-driven5 minPreferencesunsubscribe_url
B-017🌐 Static15 minLink treelinktree_bg_url

Legend:

  • ⚡ Instant: Triggers within seconds
  • ⚡ Automated: Runs without human action
  • 🔄 Background: Periodic automated tasks
  • 👤 User-driven: Requires user interaction
  • 🌐 Static: Page/template (not automation)

Reference: See KB-002 for complete module descriptions


6.4 Onboarding Task Priority​

┌─────────────────────────────────────────────────────────────┐
│ CLIENT ONBOARDING PRIORITY ORDER │
├─────────────────────────────────────────────────────────────┤
│ │
│ 🔴 CRITICAL (System Won't Work Without): │
│ 1. Load snapshot │
│ 2. Connect domain (+ wait for SSL) │
│ 3. Connect email domain (+ DNS) │
│ 4. Purchase phone number │
│ 5. Connect calendar │
│ 6. Fill ExtendlyOS form (98 custom values) │
│ │
│ 🟡 IMPORTANT (Major Features Require): │
│ 7. Integrate GMB (for review automation) │
│ 8. Configure payment gateway (if needed) │
│ 9. Test all workflows │
│ 10. Verify custom values populated │
│ │
│ 🟢 RECOMMENDED (Enhanced Functionality): │
│ 11. Add social media integrations │
│ 12. Configure advanced features │
│ 13. Customize templates │
│ 14. Train client on system │
│ │
└─────────────────────────────────────────────────────────────┘

Reference: See KB-004 for complete onboarding checklist (13 mandatory + 3 important + 2 optional tasks)


7. Common Gotchas and Pro Tips​

7.1 The Top 10 Mistakes to Avoid​

1. ❌ Not waiting for SSL (pages won't load)
✅ Wait 24-48 hours after domain connection

2. ❌ Missing country code on phone numbers
✅ Always use +1-XXX-XXX-XXXX for US

3. ❌ Using local file paths for images
✅ Upload to media library, use URL

4. ❌ Not publishing workflows (they stay in draft)
✅ Always click "Publish" after creating

5. ❌ Testing workflows with same contact repeatedly
✅ Use fresh contacts (GHL blocks re-entry)

6. ❌ Forgetting to integrate GMB before review automation
✅ Settings → Integrations → Connect Google first

7. ❌ Using @gmail.com for business email
✅ Use dedicated branded domain

8. ❌ Not warming up new email domain
✅ Start with 10-20 emails/day, increase gradually

9. ❌ Leaving custom values blank
✅ Complete ExtendlyOS form (30-45 min, one time)

10. ❌ Deploying snapshot updates without testing
✅ Always test in z.sc Test environment first

7.2 Pro Tips from the Field​

💡 Use Linked Sub-Accounts to track snapshot deployments
→ Know exactly which clients have which version

💡 Archive old snapshots before creating new versions
→ Easy rollback if something breaks

💡 Test with your own phone/email first
→ Catch issues before clients do

💡 Document custom workflows in client notes
→ Know what's standard vs. customized

💡 Set up error notifications for critical workflows
→ Get alerted when automations fail

💡 Keep a version tracking spreadsheet
→ Track which industries on which Universal Base version

💡 Use z.sc Test accounts liberally
→ Free sandbox to experiment safely

💡 Take screenshots of working configurations
→ Visual reference when troubleshooting

💡 Create client-specific C-prefix registry
→ Track customizations per client

💡 Schedule weekly health checks
→ Catch issues before clients report them

Complete System Documentation:


Document Information​

  • Version: 1.0 (Draft)
  • Created: October 29, 2025
  • Status: Draft - Ready for Review
  • Estimated Word Count: ~3,500 words
  • Estimated Page Count: ~15 pages
  • Next Review: After team feedback
  • Location: 06-team-training/platform-training/kb-008-visual-reference-guide.md

Author: Symphony Core Knowledge Management Team Contributors: Claude Code


End of KB-008: Visual Reference Guide