diff --git a/openspec/changes/2025-11-17-forum-mvp/proposal.md b/openspec/changes/2025-11-17-forum-mvp/proposal.md new file mode 100644 index 0000000..8ec5fde --- /dev/null +++ b/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=` + diff --git a/openspec/changes/2025-11-17-web-stack-decision/proposal.md b/openspec/changes/2025-11-17-web-stack-decision/proposal.md new file mode 100644 index 0000000..bc01518 --- /dev/null +++ b/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=` + diff --git a/openspec/specs/feature-forum.md b/openspec/specs/feature-forum.md index af0c8d8..0210aaa 100644 --- a/openspec/specs/feature-forum.md +++ b/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.