Merge pull request #4 from fullsizemalt/claude/forum-mvp-2025-11-17

Proposal: Community Forum MVP

openspec/changes/2025-11-17-forum-mvp/proposal.md

@@ -0,0 +1,45 @@
+# Proposal: Community Forum MVP
+
+Status: draft
+Authors: Community + Platform Teams
+Owners: Community Lead, Architecture Lead
+Created: 2025-11-17
+Scope: spec
+Related: openspec/specs/feature-forum.md
+
+Summary
+- Deliver the initial forum: categories, threads, posts, reactions, moderation, and notifications with full cross‑platform parity.
+
+Motivation
+- The forum is the core community space; MVP unlocks structured peer support with strong safety and privacy.
+
+Requirements
+- Accessibility: screen reader parity, keyboard nav, large text, reduced motion.
+- Privacy & Safety: pseudonyms, reporting/flagging, moderation queues, content policies.
+- Realtime: live updates for new posts; presence/typing optional.
+- Notifications: push (mobile) and email (web); user controls.
+
+Architecture & API
+- Endpoints: categories, threads, posts, reactions; moderation actions.
+- Realtime channel for thread updates; idempotent writes; pagination.
+
+Data Model
+- ForumCategory, ForumThread, ForumPost with ownership, timestamps, soft‑delete.
+
+Migration
+- Map any existing forum‑like Wix content where applicable.
+
+Test Plan
+- Unit/integration for API; E2E for critical flows; a11y checks.
+
+Rollout
+- Feature flag; pilot group; monitoring; rollback plan.
+
+Acceptance Criteria
+- Cross‑platform parity verified; a11y and compliance checks pass; moderation workflows validated.
+
+Slash Commands
+- `/review areas=mobile,web,backend,accessibility,security,compliance`
+- `/apply spec=openspec/specs/feature-forum.md`
+- `/archive link=<PR>`
+

openspec/changes/2025-11-17-web-stack-decision/proposal.md

@@ -0,0 +1,46 @@
+# Proposal: Web Stack Decision
+
+Status: draft
+Authors: Platform Team
+Owners: Architecture Lead, Web Lead
+Created: 2025-11-17
+Scope: spec
+Related: openspec/specs/architecture.md
+
+Summary
+- Decide between Next.js (React/SSR) vs Flutter Web to deliver accessible, SEO‑friendly, performant web with parity to mobile.
+
+Motivation
+- Ensure the web stack supports public SEO content (resources/blog), members‑only features, and strong a11y/compliance.
+
+Goals / Non‑Goals
+- Goals: select stack, document SSR/SEO approach, a11y/testing strategy, and performance budgets.
+- Non‑Goals: design system details (future proposal).
+
+Evaluation Criteria
+- Accessibility: semantic HTML, keyboard/focus, screen readers, reduced motion, large text.
+- SEO & SSR: canonical URLs, Open Graph, sitemaps, incremental static regen.
+- Performance: Core Web Vitals targets (LCP < 2.5s, INP < 200ms, CLS < 0.1).
+- Ecosystem: routing, data fetching, auth integration, CMS/blog interop.
+
+Options
+- Next.js (App Router, React 18, RSC + server actions)
+- Flutter Web (single codebase, a11y improvements; evaluate SEO constraints)
+
+Risks & Mitigations
+- SEO constraints with Flutter Web → fallback to Next.js for public surfaces if chosen.
+
+Rollout Plan
+- Implement public resource list and blog index prototype; measure CWV and a11y checks.
+
+Test Plan
+- Lighthouse/CWV, axe, keyboard nav tests; SEO meta validation.
+
+Acceptance Criteria
+- Decision recorded with rationale; prototype metrics captured; a11y/SEO sign‑off.
+
+Slash Commands
+- `/review areas=web,accessibility,security`
+- `/apply spec=openspec/specs/architecture.md`
+- `/archive link=<PR>`
+

openspec/specs/feature-forum.md

@@ -1,6 +1,6 @@
 # Feature: Community Forum
 
-Status: draft
+Status: approved
 Owners: Community
 
 Summary
@@ -20,3 +20,7 @@ Migration
 Acceptance Criteria
 - Cross‑platform UI parity and assistive tech checks; moderation workflows verified
 
+
+
+Data Model
+- ForumCategory, ForumThread, ForumPost with ownership, timestamps, soft-delete.