tiennm99/try-gstack
1
0
Fork 0
mirror of https://github.com/tiennm99/try-gstack.git synced 2026-05-26 01:59:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
d8c7ed0e2cf7c92121a0411f55f0a1ee75f55b4b
try-gstack/TODOS.md
T
tiennm99 d8c7ed0e2c v0.0.1.0 chore: scaffold Hình Học Sống (Astro + GitHub Pages) (#1) 
* chore: add gstack skill routing rules to CLAUDE.md

Append a "## Skill routing" section so future Claude Code sessions in this repo route
each task through the matching gstack skill (e.g., /investigate for bugs, /ship for PRs,
/office-hours for product brainstorming).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: scaffold Astro 5 + TypeScript strict with base /try-gstack/

Initialize the project per the autoplan-locked decisions:
- Astro 5 SSG, output static, base path /try-gstack/ for GitHub Pages subdirectory hosting
- TypeScript strict (Astro's strict tsconfig + path alias ~/* -> src/*)
- @astrojs/sitemap for SEO meta
- bun as the package manager (lockfile committed)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat: Vietnamese landing page with Be Vietnam Pro + i18n stub

Implement the locked design decisions D2 (typography) and D3 (palette) plus the i18n
discipline from autoplan eng review:
- Be Vietnam Pro single family (woff2, weights 400/500/700, vietnamese subset) self-hosted
  via @fontsource so KaTeX/CDN-blocking ISPs cannot break the page
- font-feature-settings: "kern", "locl" for proper VN diacritic positioning
- 17px body / 1.6 line-height / max-w-prose 56ch (denser than English)
- 3-color SGK-aligned palette in tailwind config: pair1 #D7263D, pair2 #1B998B, pair3 #F46036
- BaseLayout with lang="vi", canonical URL, OpenGraph (vi_VN), X-Frame-Options DENY
- src/i18n/vi.ts holds every user-facing string; t() helper resolves the active locale.
  Adding English later means adding en.ts; no string churn through templates.
- Landing page lists three grade cards with "Sắp ra mắt" status (modules ship later)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* test: bootstrap Vitest with pure geom-engine vec module

Establish the math-engine boundary and test discipline from autoplan eng decision E2:
- src/geom-engine/ is pure (no DOM imports allowed); first module is vec.ts
- Vec2 helpers: vec, add, sub, scale, dot, len, dist, normalize, approxEqualLen
- EPSILON_LEN=0.5 viewBox units justified vs ~4px human drag precision
- scale() normalizes IEEE-754 -0 back to +0 so consumers don't see signed-zero ghosts
- Vitest config gates the module at 95% line/function/statement, 90% branch
- 16 unit tests covering commutativity, mutation safety, orthogonality, normalization,
  and EPSILON tolerance behavior

Property tests via fast-check come with the first canvas module; this commit establishes
the test scaffold so adding them later is one dependency away.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* ci: GitHub Actions test workflow + Pages deploy via deploy-pages@v4

Wire the autoplan-locked CI/CD pipeline (decision E3) for GitHub Pages hosting:
- ci.yml: typecheck + tests + build on every PR and push to main
- deploy.yml: build + actions/deploy-pages@v4 on push to main, concurrency-grouped
  so a force-push retry doesn't abort an in-flight rollback
- Build env pins SITE_URL=https://tiennm99.github.io and SITE_BASE=/try-gstack so
  astro.config.mjs produces correct canonical/OG URLs against the subdirectory host
- bun 1.3.13 pinned for both workflows

Lighthouse-CI + size-limit gates deferred until the first canvas module ships
(no JS bundle to budget yet — current pages are zero-JS).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: VERSION 0.0.1.0 + CHANGELOG + RUNBOOK + README rewrite

Initial 4-digit gstack version (matches package.json), changelog entry for the scaffold,
operations runbook covering rollback and the deferred .vn domain trigger (500 sessions/30d
OR 1 organic teacher share OR 5+ modules shipped). README rewritten as the project README
for Hình Học Sống with the locked architectural decisions visible to teammates.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: TODOS.md tracking deferred autoplan items

Capture the deferred work surfaced by the /office-hours + /autoplan reviews so the
backlog is visible to teammates and bisectable from the source-of-truth design doc.
Organized by component (Phase 0 distribution, TheoremCanvas, Module 3/1/2, testing
infrastructure, retention, domain) then priority P0–P4. Per the gstack TODOS.md
format conventions.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 23:43:37 +07:00

6.5 KiB
Raw Blame History

TODOS

Tracked work, organized by component then priority (P0 highest → P4 lowest). See ~/.gstack/projects/tiennm99-try-gstack/tiennm99-main-design-20260429-160610.md for the full plan.

Distribution & Validation (Phase 0, pre-build)

  • Phase 0 SERP audit Priority: P0 What: 2-hour Google.com.vn / YouTube VN / TikTok VN audit on góc nội tiếp, tam giác bằng nhau, tam giác đồng dạng. Document positions 1–10 + dominant content type. Why: Determines whether text page can win SERP or whether we pivot to video-first. Output: competitive-landscape.md companion file.

  • Phase 0 TikTok / Shorts validation Priority: P0 What: 5 short videos (10–30s) of mock drag interactions (Figma + Lottie + screen-record). Post to test the visual-wow thesis BEFORE writing module code. Why: If videos flop, the entire visualizer wedge is dead before a weekend is invested.

  • Vetted Facebook group entry Priority: P1 What: Join "Hỏi đáp Toán THCS", "Toán học vui", "Giáo viên Toán". Post one helpful, non-self-promotional answer in each. Earn standing. Why: Distribution plan depends on these groups; founder must have presence before the launch post.

TheoremCanvas primitive (weekend 1, before any module)

  • Build TheoremCanvas as single HTML file first Priority: P1 What: <TheoremCanvas mode="..." initial={...} client:visible /> API. SVG canvas + Pointer Events drag + setPointerCapture per vertex. AbortController teardown. Per autoplan eng decision E1. Where: prototype as standalone prototype.html, then port into src/components/TheoremCanvas.astro once API feels right.

  • Vertex drag affordance + 48px hit-target Priority: P1 What: 14px filled circle, 2px white stroke, 4px drop shadow, 48px transparent square hit-target, tabindex=0, focused = 3px #D7263D ring. Per Design Decision D1.

  • Keyboard navigation for vertices Priority: P1 What: Tab cycles vertices; arrows ±4px; shift+arrow ±16px; Enter snaps to nearest interesting position. Per Design F6.1.

Module 3 — Lớp 9 Góc nội tiếp (weekend 2, hero module)

  • Drag M around circle, project to circle constraint Priority: P1 What: M = center + r·normalize(pointer − center) every pointermove. No free movement. Per Eng failure mode #4.

  • Theorem panel + 3 worked SGK-style examples Priority: P1

  • First-load coaching state (per Design F2.2) Priority: P2 What: Animated ghost-finger gesture for 1.5s, "Kéo điểm M để khám phá" caption, dismissible, persisted in localStorage.

  • ARIA-live announcements on dragend Priority: P2 What: "Góc AMB bằng 47 độ" announced via aria-live="polite". Per Design F6.4.

Module 1 — Lớp 7 Tam giác bằng nhau (weekend 3)

  • SSS / SAS / ASA / AAS / cạnh huyền-góc nhọn / cạnh huyền-cạnh góc vuông detectors Priority: P1 What: Pure geometry functions in src/geom-engine/congruence.ts. Use EPSILON_LEN = 0.5. Color-pair highlighting + green "Hai tam giác bằng nhau" badge. Note: Rigid-motion overlay animation EXPLICITLY DROPPED per autoplan (was scope creep).

  • SGK tick-mark encoding Priority: P1 What: 1/2/3 ticks for matching sides, 1/2/3 arcs for matching angles. Always paired with the 3-color palette (#D7263D / #1B998B / #F46036). Per Design Decision D3 — single largest a11y + pedagogical unlock.

Module 2 — Lớp 8 Tam giác đồng dạng (weekend 4)

  • Similarity ratio + AA/SAS/SSS-similar detectors Priority: P1 What: src/geom-engine/similarity.ts. Live ratio display via numeric text-node updates only (KaTeX template rendered at build, never re-parsed during drag).

  • Scale slider clamped to [0.5, 2.0] Priority: P1 What: min=0.5, max=2, step=0.05. Cannot reach 0. Per Eng failure mode #3.

Testing & CI infrastructure (with first canvas module)

  • fast-check property tests Priority: P1 What: ∀ M on arc, |∠AMB − ∠AM₀B| < 0.5° (inscribed-angle invariance). ∀ pointer, dist(projectToCircle(p, c), c.center) = c.r ± ε.

  • Playwright e2e + multi-touch tests Priority: P1 What: Per-module happy-path + keyboard-path + multi-touch-path. Use device: 'Pixel 5' for touch profiles. Per autoplan test plan.

  • size-limit bundle gate Priority: P2 What: 200KB gz JS / 50KB gz CSS / 80KB woff2 fonts. CI fail-fast.

  • Lighthouse-CI gate Priority: P2 What: Mobile preset, ≥90 Perf + A11y. Run against bun preview.

  • axe-playwright a11y tests Priority: P2 What: Zero axe-violations on every module page.

  • Visual regression for tick-marks + Vietnamese diacritics Priority: P2 What: Argos / Playwright snapshot baselines.

Retention & Distribution (post-MVP)

  • Zalo / Telegram subscribe CTA on every module Priority: P2 What: "Nhận theorem mới mỗi tuần" — turns hub into sequence. Per CEO finding (theme 4).

  • Lớp-9 course-spine "next theorem" footer card Priority: P2 What: Each lớp-9 module links forward to next theorem. Per Design F3.5.

  • OpenGraph image generation per module Priority: P2 What: Pre-rendered SVG-to-PNG of canvas hero state. Critical for FB / Zalo shares.

  • Schema.org LearningResource meta Priority: P3 What: Per-module structured data for Google rich results.

Domain & infra (post-validation trigger)

  • Buy .vn / .com.vn domain Priority: P1 What: TRIGGER: 500 sessions/30d OR 1 organic teacher share OR ≥5 modules shipped (per RUNBOOK). VN registration takes 7–14 days.

  • Cloudflare Web Analytics Priority: P2 What: JS-injected, no cookies, no consent banner. Activate after first 50 daily sessions.

  • PUBLIC_VERSION env wiring Priority: P3 What: Currently index.astro reads import.meta.env.PUBLIC_VERSION ?? '0.0.1.0' — env never set. Wire it from CI build (read VERSION file) so footer doesn't rot on bump.

Out of scope (deferred indefinitely or to v2)

  • English / bilingual support
  • Embed-as-iframe API (CSP frame-ancestors work)
  • Comments via Giscus
  • Account / auth / email capture
  • Browser extension overlay (out of static scope)
  • Anki-style spaced-repetition deck (different product shape)
  • Print → digital QR bridge (distribution experiment, not engineering)
  • Teacher-tool / B2B2C demo mode (build after Module 3 ships)

Completed

Reference in New Issue View Git Blame Copy Permalink