From 249d4c2ee96fbc4f5a9b1558e4f3dc3d7fe911a6 Mon Sep 17 00:00:00 2001 From: Firefrost Automation Date: Tue, 10 Feb 2026 07:53:07 -0600 Subject: [PATCH] Add Code-Server deployment plan for accessibility enhancement MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Battle Plan Created: - Comprehensive deployment guide (code-server-deployment-plan.md) - Browser-based VS Code for documentation editing - Eliminates 90% of terminal work for docs Project Scope Updated: - Code-Server as Phase 0.5 extension - Addresses hand limitations directly - Enables Meg to edit without SSH knowledge TASKS.md Updated: - Complete deployment checklist - Pre-deployment, installation, security steps - Post-deployment configuration and testing Strategic Value: - Works on Chromebook + Samsung S24 Ultra - Visual Git workflow (no commands) - Reduces hand strain significantly - Mobile-friendly documentation workflow Ready to deploy: code.firefrostgaming.com 🔥❄️ --- docs/FIREFROST-PROJECT-SCOPE-V2.md | 114 ++++++++++++++ docs/TASKS.md | 59 ++++++++ docs/code-server-deployment-plan.md | 223 ++++++++++++++++++++++++++++ 3 files changed, 396 insertions(+) create mode 100644 docs/code-server-deployment-plan.md diff --git a/docs/FIREFROST-PROJECT-SCOPE-V2.md b/docs/FIREFROST-PROJECT-SCOPE-V2.md index 2054fe3..680ac53 100644 --- a/docs/FIREFROST-PROJECT-SCOPE-V2.md +++ b/docs/FIREFROST-PROJECT-SCOPE-V2.md @@ -633,3 +633,117 @@ When in doubt about priorities, architecture decisions, or project scope, refer *Built for marathon sessions. Designed for accessibility. Optimized for growth.* + +--- + +## 🖥️ CODE-SERVER DEPLOYMENT (ACCESSIBILITY ENHANCEMENT) + +**Added:** February 10, 2026 +**Priority:** HIGH - Addresses hand limitations directly + +### The Problem + +**Current workflow requires:** +- SSH terminal access +- Command-line file editing +- Manual Git commands +- Difficult on mobile devices +- Challenging with hand nerve damage + +**Michael spends significant time:** +- Copy/pasting command blocks +- Managing SSH sessions +- Navigating terminal editors +- Executing Git workflows + +### The Solution: Code-Server + +**What:** Browser-based Visual Studio Code +**Where:** code.firefrostgaming.com (Command Center VPS) +**Impact:** Eliminates 90% of terminal work for documentation + +**Key Features:** +- Full VS Code experience in browser +- Visual file explorer (point and click) +- Git GUI (no commands needed) +- Markdown preview +- Works on any device (Chromebook, phone, tablet) +- Enables Meg to edit docs without SSH knowledge + +### Implementation Plan + +**Service Details:** +- URL: code.firefrostgaming.com +- Location: Command Center (63.143.34.217) +- Port: 8080 (internal, Nginx proxy) +- Auth: Password (Authentik SSO in Phase 2) +- SSL: Let's Encrypt + +**Deployment Time:** 1-2 hours + +**Workflow After Deployment:** +1. Open code.firefrostgaming.com in browser +2. Enter password +3. Navigate files visually +4. Edit with full GUI +5. Commit via Source Control tab +6. Push with one click + +**No SSH needed for documentation work!** + +### Benefits + +**For Michael (The Wizard):** +- ✅ Reduces hand strain significantly +- ✅ Works on Chromebook + S24 Ultra +- ✅ Visual Git workflow +- ✅ No micro-block commands for file edits +- ✅ Can work from any device + +**For Meg (The Emissary):** +- ✅ Can edit docs without SSH +- ✅ User-friendly interface +- ✅ Visual file management +- ✅ No command-line knowledge needed + +**For The Project:** +- ✅ Faster documentation updates +- ✅ Lower barrier for contributions +- ✅ Mobile-friendly workflow +- ✅ Future: Team members can contribute + +### Phase Integration + +**Phase 0.5 Extension:** +- Code-Server deployment (this week) +- Basic password authentication +- Essential VS Code extensions + +**Phase 2 Enhancement:** +- Authentik SSO integration +- Fire + Frost custom theme +- Shared editing capabilities + +**Phase 3 Advanced:** +- Live collaboration +- Mobile PWA +- Custom workspace configurations + +### Success Metrics + +- ✅ HTTPS access working +- ✅ File editing smooth on desktop +- ✅ File editing smooth on mobile +- ✅ Git operations via GUI work +- ✅ Michael's terminal time reduced 90% +- ✅ Meg successfully edits docs + +### Documentation + +**Deployment Plan:** docs/code-server-deployment-plan.md +**Post-Deployment:** docs/code-server-deployment.md (created after) + +--- + +**This is a MAJOR accessibility win for The Wizard!** 🧙‍♂️✨ + diff --git a/docs/TASKS.md b/docs/TASKS.md index 1f2b0f1..e580cf8 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -262,3 +262,62 @@ Set up two-way Git synchronization between Wiki.js and Gitea for markdown-based --- + +--- + +## 🖥️ CODE-SERVER DEPLOYMENT (NEW - Feb 10, 2026) + +**Priority:** HIGH - Accessibility Enhancement +**Impact:** 90% reduction in terminal work for documentation +**Estimated Time:** 1-2 hours + +### Pre-Deployment + +- [ ] Create DNS A record: code.firefrostgaming.com → 63.143.34.217 +- [ ] Verify port 8080 available +- [ ] Check disk space (need ~500MB) +- [ ] Backup Git repo state + +### Installation & Configuration + +- [ ] Install Code-Server via official script +- [ ] Configure config.yaml (bind 127.0.0.1:8080) +- [ ] Set strong password +- [ ] Create systemd service +- [ ] Enable auto-start on boot + +### Network & Security + +- [ ] Create Nginx reverse proxy config +- [ ] Enable WebSocket support +- [ ] Obtain SSL certificate (certbot) +- [ ] Configure UFW firewall rules +- [ ] Test HTTPS access + +### Post-Deployment + +- [ ] Install VS Code extensions (Markdown, Git Graph, GitLens) +- [ ] Configure workspace settings +- [ ] Test file editing +- [ ] Test Git operations +- [ ] Test from Chromebook +- [ ] Test from Samsung S24 Ultra +- [ ] Add to Uptime Kuma monitoring +- [ ] Train Meg on usage + +### Documentation + +- [ ] Create deployment guide (code-server-deployment.md) +- [ ] Update session-handoff.md +- [ ] Commit all changes to Git + +--- + +**Why This Matters:** +- Browser-based editing = no SSH needed +- Works on mobile devices +- Reduces hand strain significantly +- Enables Meg to contribute without terminal knowledge + +**Fire + Frost = Where Passion Meets Precision** 🔥❄️ + diff --git a/docs/code-server-deployment-plan.md b/docs/code-server-deployment-plan.md new file mode 100644 index 0000000..5dc1ad1 --- /dev/null +++ b/docs/code-server-deployment-plan.md @@ -0,0 +1,223 @@ +# Code-Server Deployment Plan + +**Service:** Visual Studio Code (Web-based IDE) +**URL:** code.firefrostgaming.com +**Location:** Command Center VPS (63.143.34.217) +**Purpose:** Browser-based file editing for documentation (no SSH required) +**Priority:** HIGH - Accessibility enhancement for hand limitations + +--- + +## Strategic Value + +**Problem Solved:** +- Eliminates need for SSH terminal for doc editing +- GUI-based file management +- Works on Chromebook + Samsung Galaxy S24 Ultra +- Enables Meg to edit docs without SSH knowledge +- Visual Git workflow (no command line) + +**The Wizard + The Emissary can both edit docs from any device!** + +--- + +## Technical Specifications + +**Software:** Code-Server (VS Code in browser) +**Version:** Latest stable +**Port:** 8080 (internal) +**External Access:** HTTPS via Nginx reverse proxy +**Authentication:** Password (upgrade to Authentik SSO in Phase 2) +**SSL:** Let's Encrypt certificate +**Firewall:** UFW rules for port 8080 (localhost only) + +--- + +## Architecture +``` +User Browser + ↓ HTTPS +Nginx (code.firefrostgaming.com) + ↓ Reverse Proxy (localhost:8080) +Code-Server + ↓ File Access +/root/firefrost-work/firefrost-operations-manual/ + ↓ Git Operations +Gitea (git.firefrostgaming.com) +``` + +--- + +## Pre-Deployment Checklist + +- [ ] DNS A record: code.firefrostgaming.com → 63.143.34.217 +- [ ] Port 8080 available (check with `ss -tlnp | grep 8080`) +- [ ] Disk space check (Code-Server ~500MB) +- [ ] Backup current Git repo state + +--- + +## Deployment Steps + +### Step 1: Install Code-Server +```bash +curl -fsSL https://code-server.dev/install.sh | sh +``` + +### Step 2: Configure Code-Server +- Config file: `~/.config/code-server/config.yaml` +- Set bind address: 127.0.0.1:8080 +- Set password: [STRONG_PASSWORD] +- Disable telemetry + +### Step 3: Create Systemd Service +- Enable auto-start on boot +- Set working directory: `/root/firefrost-work/firefrost-operations-manual` +- Configure restart policy + +### Step 4: Nginx Reverse Proxy +- Create site config: `/etc/nginx/sites-available/code.firefrostgaming.com` +- Proxy pass to localhost:8080 +- WebSocket support (critical for Code-Server) + +### Step 5: SSL Certificate +```bash +certbot --nginx -d code.firefrostgaming.com +``` + +### Step 6: UFW Firewall +- Allow HTTP/HTTPS on ens3 +- Block direct access to port 8080 + +### Step 7: Verification +- Test HTTPS access +- Test file editing +- Test Git operations +- Test from mobile devices + +--- + +## Post-Deployment Configuration + +**VS Code Extensions to Install:** +1. Markdown All in One (preview + shortcuts) +2. Git Graph (visual Git history) +3. GitLens (advanced Git features) +4. Prettier (code formatting) +5. Material Icon Theme (better file icons) + +**Workspace Settings:** +- Open folder: `/root/firefrost-work/firefrost-operations-manual` +- Git: Enable auto-fetch +- Files: Auto-save enabled +- Terminal: Default shell bash + +--- + +## Security Considerations + +**Access Control:** +- Password authentication (for now) +- HTTPS only (no HTTP access) +- Future: Integrate with Authentik SSO + +**File Permissions:** +- Code-Server runs as root (needs Git access) +- Read/write to firefrost-operations-manual repo + +**Network:** +- Bound to localhost only +- Nginx reverse proxy handles external access +- UFW blocks direct port access + +--- + +## Usage Workflow (Post-Deployment) + +**For Michael:** +1. Open code.firefrostgaming.com on Chromebook/phone +2. Enter password +3. Navigate files in sidebar +4. Edit markdown files +5. Use Source Control tab for Git +6. Commit + Push with GUI buttons + +**For Meg:** +1. Same workflow as Michael +2. No SSH knowledge required +3. Visual file management +4. Can edit branding docs easily + +--- + +## Troubleshooting Guide + +**Issue: Can't connect to code.firefrostgaming.com** +- Check DNS propagation +- Verify Nginx config: `nginx -t` +- Check Code-Server status: `systemctl status code-server@root` + +**Issue: WebSocket connection failed** +- Verify Nginx proxy_http_version 1.1 +- Check Upgrade and Connection headers + +**Issue: Git operations fail** +- Verify Git credentials configured +- Check file permissions + +--- + +## Rollback Plan + +**If deployment fails:** +1. Stop Code-Server: `systemctl stop code-server@root` +2. Remove Nginx config +3. Remove DNS record +4. Continue using SSH workflow + +**No data loss risk - all Git repo files untouched** + +--- + +## Success Metrics + +- ✅ HTTPS accessible from browser +- ✅ File editing works smoothly +- ✅ Git commit/push from UI works +- ✅ Accessible from Chromebook +- ✅ Accessible from Samsung S24 Ultra +- ✅ Meg can edit docs without SSH + +--- + +## Timeline + +**Estimated Deployment Time:** 1-2 hours + +**Phase Breakdown:** +- DNS + Prerequisites: 10 minutes +- Code-Server install: 15 minutes +- Configuration: 20 minutes +- Nginx setup: 15 minutes +- SSL certificate: 5 minutes +- Testing: 20 minutes +- Documentation: 15 minutes + +**Total:** ~100 minutes + +--- + +## Future Enhancements (Phase 2+) + +- [ ] Authentik SSO integration +- [ ] Custom VS Code theme (Fire + Frost colors) +- [ ] Shared editing (Live Share extension) +- [ ] Mobile app (code-server has PWA support) +- [ ] Backup/snapshot system + +--- + +**Status:** READY FOR DEPLOYMENT +**Next Step:** Create DNS record, then begin installation + +**Fire + Frost = Where Passion Meets Precision** 🔥❄️