azcomputerguru/claudetools
1
0
Fork 0
Code Issues 58 Pull Requests Actions Packages Projects Releases Wiki Activity

sync: auto-sync from GURU-5070 at 2026-07-23 15:13:59

Browse Source 
Author: Mike Swanson
Machine: GURU-5070
Timestamp: 2026-07-23 15:13:59
This commit is contained in:
Mike Swanson
2026-07-23 15:14:47 -07:00
parent fa61dcab1c
commit f5a3031a44
1 changed files with 73 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

73
projects/acg-website/session-logs/2026-07/2026-07-23-mike-acg-website-v2-buildout.md Normal file
View File

@@ -0,0 +1,73 @@
## User
- **User:** Mike Swanson (mike)
- **Machine:** GURU-5070
- **Role:** admin
## Session Summary
Full build-out of the azcomputerguru.com redesign (v2), spanning 2026-07-22 to 2026-07-23, staged on ww9.azcomputerguru.com. The session started with polish on the existing ww9 homepage and grew into a complete, cohesive multi-page premium site plus a brand-matched forum. Design work ran on Fable; content-heavy work (service detail pages, the educational sub-index) ran on Opus at Mike's direction; AGY (Gemini) stayed in the loop for critiques; Grok was mostly dead but its image-gen came alive once and produced usable art.
The homepage was refined (exit-offer overlap, hero line-height, "2001" stat, accent discipline, radio-bar de-stacking), then AGY's harsh critique was traced to a capture artifact (un-triggered scroll reveals + full-page screenshots rendering position:fixed elements at the top). A premium editorial-brutalist reimagining ("v2") was then built: giant Anton hero with an animated city rotator (Tucson to Phoenix to Scottsdale to Flagstaff to EVERYWHERE, odometer roll, ~3.3s), a dark manifesto inversion band, "THE INDEX" services ledger, poster-scale "NOTHING HIDDEN" pricing, a Dispatch board, and a mono-metadata signature motif. Grok generated two art-directed images (monsoon-Tucson hero, patch-panel field shot) replacing the stock photos.
The site was geo-broadened beyond Tucson per Mike (crawlable service-area strip + LocalBusiness areaServed JSON-LD; copy widened Arizona-wide while keeping the radio-show/since-2001/local-authority signals). v2 was promoted from the /v2/ preview path to the ww9 root (nav rewritten root-relative, no-cache .htaccess added, v1 backed up server-side). The five subpages (services, pricing, about, contact, calculator) were redesigned to the v2 system with one shared header/footer/nav; the calculator remained functional; a polish pass fixed the contact FAQ layout, the pricing "everything else" tables, and a real mobile overflow bug.
Competitive research (top 5 national + top 5 Arizona MSPs) confirmed the direction: every competitor hides pricing, uses navy/blue palettes, generic geometric type, and stock imagery; the two biggest local names (Nextrio, Total Networks) are now out-of-state roll-ups. ACG's differentiators: published pricing, warm/editorial palette, distinctive Anton type, real photography, concierge/local positioning, and the radio-show authority.
Later work: the Flarum forum (community.azcomputerguru.com) was re-themed to the ACG brand via Flarum custom_less; the real ACG logo was found in the WordPress site and the power-button "G" mark was vectorized as the header icon + favicon (Anton wordmark kept); eight per-service detail sub-pages were built (Opus) and every index card made clickable; each detail page's "what's included" list became an educational expand accordion rewritten for non-technical readers with a soft consultation nudge; and the radio call-in number was corrected site-wide (520-790-2020 to 520-790-2040).
## Key Decisions
- **Fable for design, Opus for content.** Mike directed "use Fable for this" (the redesign) and later "use Opus for this" (service detail pages, then the educational sub-index) since those are content/tone-heavy. Honored both by routing to model-specific subagents rather than doing it inline.
- **v2 promoted to the ww9 ROOT, additively.** Copied v2 into the root (overwriting index.html; adding css/v2.css, js/v2.js, assets) while KEEPING v1 css/styles.css + js/app.js so the still-v1 subpages kept working during the transition. Rewrote v2's `../page.html` nav to root-relative.
- **no-cache .htaccess for staging.** ww9 assets were served with a 1-year `max-age`; added `Cache-Control: no-cache` for html/css/js so iterations always show (was causing "I don't see the change").
- **Animated hero as a brand device, not an SEO device.** The city rotator broadens the brand message; real multi-city SEO needs crawlable city text (done: service-area strip + areaServed schema) and eventually dedicated location pages (backlogged).
- **Forum theming via Flarum core custom_less**, not a theme extension (none installed). Applied by writing settings.custom_less via a bound-param PDO script + `php flarum cache:clear`; backed up the settings table first. Kept the post reading area calm/legible while brutalizing the chrome.
- **Logo: G-mark + Anton wordmark** (Mike's choice). Reproduced the power-button "G" by measuring geometry off the hi-res logo (not autotrace), recolored to the v2 palette (orange #E24A12 + ink) vs the logo's original orange #F58921 + navy #244878.
- **Educational sub-index copy.** Per Mike, rewrote all 41 "what's included" descriptions for non-technical business owners (define the term, why it matters) with a soft "that's what a free consultation is for" nudge on ~1 item/page.
## Problems Encountered
- **AGY's "empty sections" critique was a capture artifact.** Full-page screenshots didn't trigger the scroll-reveal animations, so below-fold `.reveal` content sat at opacity:0. Fixed by scroll-triggering reveals before capture. Documented in project memory.
- **Persistent ff-profile cache served stale css/js (hit twice).** The `?cb=` query on the page URL does NOT bust linked assets. Fixed by capturing/verifying with a FRESH `FF_PROFILE` temp dir. This is the canonical verification method now.
- **"I don't see the change" (Mike, private window).** Root cause: 1-year asset cache + the ww9 root vs /v2/ path distinction. Fixed with the no-cache .htaccess; confirmed the origin (Apache, no CDN) served the new content.
- **Community-forum submodule push failed auth.** Submodule remote is the public `git.azcomputerguru.com` (no cached credential); pushed to the internal Gitea `172.16.3.20:3000` using the main repo's embedded token instead.
- **SSH nested-quoting broke** on a Flarum discovery command (backticks + PHP escaping inside `ssh '...'`). Fixed by piping a script to remote bash: `ssh ix 'bash -s' < script.sh`.
- **Radio call-in number was wrong** (520-790-2020) across all 14 pages. Corrected to 520-790-2040 (deferred the 8 detail pages until the Opus agent finished to avoid a file collision, then swept them).
## Configuration Changes
Created (all under `projects/acg-website/v2/`): `about.html`, `services.html`, `pricing.html`, `contact.html`, `calculator.html`, `js/calculator.js`, the 8 detail pages (`managed-it.html`, `backup-recovery.html`, `projects-block-time.html`, `cybersecurity.html`, `vcio-compliance.html`, `microsoft-365.html`, `business-phones.html`, `web-hosting.html`), `assets/acg-g-mark.svg`, `assets/brand/acg-wordmark-{fullcolor,dark,white,header}.png`, `.htaccess`, `IMAGE-SPEC.md`.
Modified: `v2/index.html`, `v2/css/v2.css`, `v2/js/v2.js` (theme/reveal/rotator/accordion), `projects/acg-website/TODO.md` (created running todo).
Forum (submodule `projects/community-forum`): `acg-forum-theme.less`, `acg-forum-header.html`, `backups/flarum-settings-backup-2026-07-23.sql`, `PROJECT_STATE.md`.
Memory: updated `.claude/memory/project_acg_website_redesign.md` throughout.
Server (IX): ww9 root now serves v2 (14 HTML + assets + no-cache .htaccess); v1 pages backed up as `{page}-v1-backup.html`. Flarum settings custom_less/custom_header/theme_primary_color(#E24A12)/theme_secondary_color(#16120F)/theme_dark_mode(0) updated + `php flarum cache:clear`.
## Credentials & Secrets
- No new credentials created or discovered this session.
- Used existing vault entry `services/flarum-community.sops.yaml` (Flarum DB; host localhost on IX; db `azcompu_flarum`). Root mysql socket access on IX also works without creds.
- The community-forum submodule push used the main repo's Gitea push token embedded in `.git/config` (per-machine, gitignored) against the internal Gitea `172.16.3.20:3000` — token value not reproduced here.
## Infrastructure & Servers
- **IX** — cPanel/CloudLinux/Apache. SSH alias `ix` (User root, key `~/.ssh/id_ed25519`). Internal 172.16.3.10, public 72.194.62.5. Account `azcomputerguru`.
- **ww9.azcomputerguru.com** — staging, now serving v2. Docroot `/home/azcomputerguru/public_html/ww9`. Grey-clouded (DNS-only): resolves straight to 72.194.62.5, Server: Apache, no CDN. Let's Encrypt cert. `.htaccess` sets no-cache on html/css/js.
- **azcomputerguru.com** — live WordPress (theme `arizonacomputerguru` + RevSlider/Forminator), docroot `/home/azcomputerguru/public_html`. Real logo assets in `wp-content/uploads/2025/08|10/` + `themes/arizonacomputerguru/img/`.
- **community.azcomputerguru.com** — Flarum v1.8.14, PHP 8.1.34. Root `/home/azcomputerguru/public_html/community`, docroot `.../public`. DB `azcompu_flarum` (localhost). Orange-clouded (Cloudflare); a real Firefox passes the CF JS challenge (headless works). Theming via core custom_less; extensions = the flarum/* bundle + `v17development/flarum-seo`.
- **Gitea** — internal `172.16.3.20:3000`, public `git.azcomputerguru.com`. Main repo authenticates via embedded token to the internal IP; community-forum submodule remote is the public host.
## Commands & Outputs
- Deploy to ww9: `scp` to `ix:/tmp` then `ssh ix 'cp ... /home/azcomputerguru/public_html/ww9/...; chown azcomputerguru:games ...'`. Filter SSH post-quantum warning lines.
- Fresh-profile browser verify (dodges the asset cache): `export FF_PORT=934x; export FF_PROFILE="<scratch>/ff-<n>"; python .claude/scripts/ff.py launch --headless; ff.py nav <url>; ff.py eval ...; full-page shot via `curl -s -X POST http://127.0.0.1:934x/shot --data-binary '{"path":"...","full":true}'`.
- Flarum apply: bound-param PDO script writing `settings.custom_less` + `php flarum cache:clear` (regenerates `public/assets/forum-*.css`). Rollback: `mysql azcompu_flarum < /tmp/flarum-settings-backup.sql; php flarum cache:clear`.
- Submodule push (auth workaround): `git push "http://azcomputerguru:<token>@172.16.3.20:3000/azcomputerguru/acg-community-forum.git" main`.
- Number sweep: `sed -i 's/520-790-2020/520-790-2040/g; s/5207902020/5207902040/g' <pages>`.
## Pending / Incomplete Tasks
Running list is in `projects/acg-website/TODO.md`. Go-live backlog for azcomputerguru.com:
- Real AI image finals for remaining slots (`v2/IMAGE-SPEC.md`) — blocked on Grok image-gen.
- Wire the contact form to a real mailbox (currently a demo stub).
- Dedicated location/SEO pages (e.g. /phoenix, /mesa) for real multi-city ranking.
- Cross-browser/device QA, Lighthouse/perf, a11y audit; analytics + schema verify; remove the "demo build" disclaimer footer; production DNS/hosting cutover (ww9 to azcomputerguru.com) with versioned filenames + long cache.
Small follow-ups (offered, not actioned): add vCIO & Compliance + Projects & Block Time cards to the homepage index; bespoke per-service imagery (detail figures currently reuse 5 stock images); restore per-item `<h3>` headings on the sub-index accordion (currently button labels) for screen-reader heading outline; optional exact-original logo colors (orange+navy); forum profile/settings interior pages not bespoke-polished; per-tag/avatar colors on the forum kept as wayfinding.
## Reference Information
- Live: https://ww9.azcomputerguru.com/ (v2 site), /services.html /pricing.html /about.html /contact.html /calculator.html + 8 detail pages (managed-it, backup-recovery, projects-block-time, cybersecurity, vcio-compliance, microsoft-365, business-phones, web-hosting). Forum: https://community.azcomputerguru.com/.
- Commits (main repo): `1bf4b248` (v2 homepage to ww9 root), `2e52b29c` (multipage subpages), `ecef1085` (TODO), `0e13aedb` (forum gitlink), `34ce1dce` (G-mark logo), `d43db770` (service detail pages), `3473d37f` (educational sub-index + number fix). Forum submodule: `68c6ab2`.
- Source: `projects/acg-website/v2/` (site), `projects/community-forum/` (Flarum theme, submodule). Todo: `projects/acg-website/TODO.md`. Memory: `.claude/memory/project_acg_website_redesign.md`.
- Numbers: business line 520.304.8300; radio call-in 520-790-2040 (KVOI 1030AM, The Computer Guru Show, Sat 9AM). Address: 7437 E. 22nd St, Tucson, AZ 85710.
- Competitor set: national — Electric, Ntiva, NexusTek, Corsica, Integris; Arizona — LeeShanok, Silverado, Integrated Axis, Nextrio (now IT Solutions Inc), Total Networks (now LayerCake).