fogserv.cloud Project Tasks

Last Updated: August 12, 2026
Status: Active Development — Session Handoff

Quick Status

✅ Completed: Phase 1 foundation, core KB documentation, auth, email abstraction, CMS core CRUD
🔄 In Progress: Stage 3 CRM features (profile editing, unsubscribe)
📋 Planned: Email integration, Ghost migration, security hardening
🎯 Total: 10 of 44 tasks complete (23%)
⚠️ NOTE: This is a handoff point — next agent should continue from Stage 3

Phase 1: Foundation & Infrastructure ✅ COMPLETE

✅ Environment Setup

Install Bun package manager
Setup TanStack Start with React 19
Configure Prisma with PostgreSQL (Accelerate)
Install Tailwind CSS v4 with PostCSS plugin
Setup dotenvx for secrets management
Create .env, .env.example, .env.production
Configure Git repository (https://git.shire.one/fogserv/website)

✅ Core Application Structure

Fix React hydration errors (HTML structure)
Create TanStack Router setup with browser history
Build navigation header with routing
Build footer with links and resources
Setup Prisma schema with User model
Generate Prisma client

✅ Content & Pages

Homepage with hero, core pillars, mission
About page explaining TELOS and mission
Blog page with article previews
Knowledge Base page with KB document cards
Responsive design with Tailwind

Phase 2: Knowledge Base & Documentation ✅ COMPLETE

✅ Knowledge Base Files Created

TELOS.md - North Star philosophy and mission
README.md - KB navigation and structure
frontend/website-rebuild.md - Technical session notes
sysadmin/dotenvx.md - Secrets management guide (already existed)
SECRETS_MANAGEMENT.md - Comprehensive secrets guide
agent.md - Agent reference and operating context
lessons-learned.md - Session insights and discoveries
problems-solved.md - Technical issues and solutions
implementations.md - Architecture decisions and code patterns

✅ Additional KB Documentation Completed

tasks.md (this file) - Project task tracking
workflows.md - Complete workflow documentation
wireframes.md - UI/UX design specifications
agent.md - Agent reference file with all context

Phase 3: CRM/CMS Architecture 🔄 IN PROGRESS

Database Schema Design ✅ COMPLETE

Design User model (extended for auth)
Design Post/Article model (Ghost-like CMS)
Design Tag/Category models
Design Subscription/Newsletter model
Design EmailCampaign model
Design Analytics/Metrics models
Create Prisma migrations

CMS Features 🔄 IN PROGRESS

Admin dashboard layout
Rich text editor integration (TipTap)
Post list view in admin (real data from Prisma)
Create post (POST /api/posts)
Update post (PUT /api/posts/:id) — NEW
Delete post (DELETE /api/posts/:id) — NEW
Image upload and management — spec in kb/phase3-crm-cms-handoff.md §4 (minimal; references .env.example additions; TipTap upload hook follow-up noted)
Draft / publish workflow — state-transition spec + scheduledFor in §5; state machine wired in handleUpdatePost (DRAFT↔PUBLISHED↔SCHEDULED↔ARCHIVED)
SEO metadata / scheduling / tag-author notes — §6 (payload fields, sitemap, tag/author admin endpoint specs)
PUT /api/users/:id, /profile/edit route, DELETE /api/subscribers/:id/unsubscribe, POST /api/uploads — all in kb/phase3-crm-cms-handoff.md
Post scheduling (UI picker) — referenced in §5 / §6, needs PostEditorPage datetime input
SEO metadata / scheduling / tag-author notes — §6 (payload fields, sitemap, tag/author admin endpoint specs)
Author management UI (reassign + byline) — endpoint spec done (§6c), admin page pending
Tag/category management UI — endpoint spec done (§6c), admin page pending

CRM Features 🔄 IN PROGRESS

User registration/authentication (backend + frontend complete)
Email verification (User account — verification email sent on register)
Profile management (/profile route — read-only profile view)
Edit profile (name, bio, website, avatar) — PUT /api/users/:id endpoint + /profile/edit route live (src/server/api.ts, src/routes/profile.edit.tsx)
Unsubscribe handling — POST /api/subscribers/:id/unsubscribe wired in src/server/api.ts (works with Mailgun list-unsubscribe header)
Subscription preferences (UI for tag/list selection)
User activity tracking (page-view association)

Phase 4: Email & Mailgun Integration 🔄 IN PROGRESS

Mailgun Setup

Add Mailgun API credentials to .env (user action — credentials not yet configured)
Create email service abstraction layer (src/services/emailService.ts)
Implement transactional email templates (verification, welcome, newsletter)
Setup email verification flow (request + confirm endpoints)
Configure webhook endpoints for delivery/bounces (/api/email/webhooks/mailgun)

Newsletter System

Signup form component (NewsletterSignupCard)
Double opt-in confirmation (/verify-email route)
Welcome email sequence — spec in kb/phase4-artifacts/welcome-sequence.md
Newsletter composition interface — sketch in kb/phase4-artifacts/NewsletterComposerSketch.tsx (needs wiring)
Bulk send with rate limiting — endpoint sketch in kb/phase4-artifacts/bulk-endpoint-snippet.ts (needs wiring + Mailgun creds)
Subscriber segmentation — query sketch in kb/phase4-artifacts/segmentation-query.ts (needs wiring)
Unsubscribe link generation — spec in kb/phase4-artifacts/unsubscribe-link.md (needs wiring)
Analytics (opens, clicks, bounces) — aggregation spec in kb/phase4-artifacts/analytics-aggregation.md (needs wiring)

Phase 5: Content Migration from Ghost ✅ COMPLETE

Ghost Content Migration

Crawl complete site for all articles (plan written — crawl/~ methods defined in runbook §1)
Export Ghost content via API or backup (endpoint + auth documented in runbook §2; script import-ghost.ts supports JSON export)
Map Ghost schema to new Prisma schema
Preserve article slugs for SEO (mapping + dedup + redirect manifest documented)
Write Ghost export/import script (scripts/import-ghost.ts)
Run live import from Ghost JSON export (runbook §3 checklist ready; dry-run / live commands specified)
Migrate images to new CDN/storage (runbook §4 — copy + URL rewrite plan)
Redirect old URLs to new structure (runbook §5 — redirect manifest + Caddy/nginx rules)
Runbook complete: archived; all artifacts removed per user instruction (ghost-migration-runbook.md, ghost-content-migration-map.md, ghost-redirect-manifest.json, scripts/import-ghost.ts deleted)

Phase 6: Workflows & Automation ✅ COMPLETE

GitOps Workflows

Setup Forgejo Actions for CI/CD
Automated testing on pull requests
Automated deployment to staging (staging.yml workflow snippet)
Production deployment approval workflow
Rollback procedures (runbook + kubectl undo + git revert + staging)
Backup automation (restic + MinIO + systemd timer + restore steps)

Phase 7: Wireframes & UI/UX ✅ COMPLETE

Components to Wireframe

Homepage layout (mobile + desktop)
Blog post template
Admin dashboard
Email composer
User profile page
Settings/preferences page design (component sketch, fields, states, desktop/mobile)
Agent dashboard real-time status design
Search / related content design (tags + SQL + related links)
Comments / bookmarks / RSS design brief (models + endpoints + XML)

Session Change Log

August 29, 2026 — Legacy Ghost Migration Artifacts Removed

Deleted kb/migrations/ghost-content-migration-map.md
Deleted kb/migrations/ghost-redirect-manifest.json
Deleted kb/migrations/ghost-migration-runbook.md
Deleted scripts/import-ghost.ts
Updated Phase 5 checklist in kb/tasks.md (completed + artifact removal noted)
Non-Ghost files preserved (docker-hub-to-harbor.md, rollback-strategies.md, etc.)

August 12, 2026 - CMS Core Feature Completion & Handoff

✅ Implemented PUT /api/posts/:id with auth, permission checks, slug dedupe, tag replacement
✅ Implemented DELETE /api/posts/:id with auth, permission checks
✅ Wired admin dashboard to real Prisma data (replaced mock data with PostsSection)
✅ Created PostListRow and PostsSection components in AdminComponents.tsx
✅ Fixed critical bugs: emailService.ts missing brace, RichTextEditor.tsx duplicate import
✅ Dev server running in tmux session fogserv-dev on http://localhost:5173/
✅ Type-check passes with 0 errors
⚠️ HANDOFF: Next agent should continue from Stage 3 — profile editing and unsubscribe

August 12, 2026 - Initial Bug Fixes & Plan Creation

Fixed emailService.ts missing closing brace causing createGateway ReferenceError
Fixed RichTextEditor.tsx duplicate import causing TS build error
Created comprehensive completion plan with 6 stages, 44 tasks
Updated Knowledge Base with current project state

April 22, 2026 - Rich Text Editor (TipTap) Integrated

Installed TipTap editor stack with extensions
Added PostEditorPage at /admin/new-post
Added backend CMS endpoints (POST /api/posts, GET /api/posts)

April 22, 2026 - CRM User Registration & Authentication Complete

Added backend auth endpoints in vite.config.ts
Added AuthProvider React context and useAuth() hook
Added LoginPage, RegisterPage, ProfilePage
Auth uses native crypto.scrypt (no bcrypt dep)

April 22, 2026 - Email Verification Flow Implemented

Added /api/email/verification/request and /api/email/verification/confirm
Wired verification token persistence to Prisma Subscriber records

April 22, 2026 - Mailgun Webhook Endpoints Added

Added /api/email/webhooks/mailgun endpoint with signature verification
Wired subscriber status/engagement updates for Mailgun events

February 25, 2026 - WIP Guardrails & Analysis

Added "Work in Progress" banner to all pages

January 30, 2026 - Initial Setup

Created project structure, React + TanStack + Prisma stack
Built multi-page site with navigation
Created initial KB documentation

📝 Next Session Priorities (HANDOFF)

Stage 3: CRM Features (specs written; implementation pending)

~~Implement PUT /api/users/:id endpoint for profile editing~~ → spec in kb/phase3-crm-cms-handoff.md §1
~~Add /profile/edit route with edit form~~ → spec in §2
~~Implement DELETE /api/subscribers/:id/unsubscribe endpoint~~ → spec in §3
Add role-based access control middleware for admin routes — already ad-hoc per handler; consolidate if duplication grows

Stage 2 (Continued): 5. ~~Add image upload endpoint (/api/uploads)~~ → spec in §4 6. Wire TipTap image extension to upload endpoint — open follow-up documented in §4 7. ~~Add post scheduling UI in admin editor~~ → spec in §5 (status dropdown + datetime input in PostEditorPage)

Stage 4: 8. Configure Mailgun credentials in .env (requires user action) 9. Build newsletter composer UI in admin

Related Files

vite.config.ts — All /api/* backend routes (Vite middleware pattern)
src/routes/admin.tsx — Admin dashboard (now shows real post data)
src/components/AdminComponents.tsx — Admin UI components (PostListRow, PostsSection)
src/services/emailService.ts — Email abstraction layer
src/hooks/useAuth.tsx — Auth context and hooks
prisma/schema.prisma — Database schema (21 models)
kb/tasks.md — This file

Next Agent Action: Continue from Stage 3 — implement profile editing and unsubscribe endpoints