From 2334726f2d0d7351580128f4d90f0e423037ba83 Mon Sep 17 00:00:00 2001 From: Othmane Ataallah Date: Thu, 23 Jul 2026 09:59:45 +0200 Subject: [PATCH] Update Sync Notes --- Sync-Notes.md | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 73 insertions(+), 1 deletion(-) diff --git a/Sync-Notes.md b/Sync-Notes.md index 5d08b7b..d5c12eb 100644 --- a/Sync-Notes.md +++ b/Sync-Notes.md @@ -1 +1,73 @@ -Welcome to the Wiki. \ No newline at end of file +# Sync Notes + +*Newest entry on top. One entry per weekly sync and per integration checkpoint. +Decisions made here also land in [Decisions](Decisions) within the hour.* + +--- + +## 2026-07-26 — Kickoff (entry pre-filled: this is the ratification agenda) + +**Present:** PM, API dev (REPLACE name), Web dev (REPLACE), Mobile dev (REPLACE) + +**Demos:** PM ran all three starters live — login → profile on API+web+mobile. ✅/REPLACE + +### Ratification checklist (tick + note amendments; flip rows in [Decisions](Decisions) after) + +**Foundations** +- [ ] Milestones M1–M6 + ~2-week rhythm + checkpoint ritual — dates set: REPLACE +- [ ] Mock-first workflow (Prism; auth always real API) +- [ ] Spec-gap review vs Figma assigned (owner: PM + each dev for their screens): push notifications absent · no "my reservations" list endpoint · dashboards are point-in-time (no trends) · attachments have no previews · agenda is day/week (no month grid) · meeting recurrence is create-only + +**Architecture (per-repo ARCHITECTURE.md)** +- [ ] API: layers + package-by-feature confirmed · mapper style = static factories (`XxxDto.from`) · pagination record owner + shape (early M2) · MapStruct trigger agreed ("only if mapping pain is real") +- [ ] Web: features/ threshold (2nd file) · UI kit via M1 spike issue · vitest trigger ("first real logic util") · ESLint+Prettier chore added to M1 +- [ ] Mobile: plain Navigator now, go_router when deep links become real (likely M2 reset-link) · widget-test bar = auth flows + one per major screen + +**Git & process** +- [ ] Trunk-based + squash-merge confirmed (squash set as ONLY merge style in each repo's settings) +- [ ] Daily rebase habit confirmed (vs merge-from-main — pick ONE, no mixing) +- [ ] Tag cadence: PM tags after each checkpoint (`v0..0`) +- [ ] Review SLA 24h confirmed · what devs do while waiting (next Ready issue) +- [ ] Cross-review experiment from M3 (one small cross-repo review per dev per milestone) +- [ ] Mid-project issue IDs continue each repo's sequence (next free `API-xx` / `WEB-xx` / `MOB-xx`) +- [ ] Error-code + `X-Client-Type` decisions ratified → spec v1.0.1 authoring assigned to: REPLACE + +**Engineering agreements** +- [ ] Style: `.editorconfig` law · Spotless parked to M6 · `flutter analyze` clean pre-PR +- [ ] Testing bars per repo accepted (integration tests default on API; fromJson tests on mobile) +- [ ] Secrets rules read aloud (incl. the "leak → tell PM immediately, no blame" clause) +- [ ] ADR walkthrough done — everyone named one example that needs an ADR and one that doesn't + +**Amendments & disagreements (record them — they're the point):** +- REPLACE + +**Actions:** +- [ ] PM: flip ratified rows in [Decisions](Decisions) to `accepted` + set milestone dates in Gitea +- [ ] Each dev: complete repo `-01` onboarding issue by Tuesday +- [ ] PM: fill remaining Figma links in Ready issues +- [ ] REPLACE + +--- + +## Template — weekly sync (copy for each new entry) + +```markdown +## YYYY-MM-DD — Weekly sync (Week NN) +**Present:** +**Demos (5 min each):** API: … · Web: … · Mobile: … +**Board walk:** M progress /; carry-overs: … +**Blockers:** … +**Decisions:** … (→ also to Decisions page) +**Next week / moved to Ready:** … +``` + +## Template — integration checkpoint (end of each milestone) + +```markdown +## YYYY-MM-DD — M integration checkpoint +**Joint demo flow:** (e.g. M3: create task on web → assign → see on mobile → verify API data) +**Mock → real switches done:** … +**Bugs filed:** #.., #.., … (label kind/bug + area/*; priority set at triage) +**Retro (3 questions):** helped: … · dragged: … · change: … +**Milestone closed?** yes/no; rolled over: … **Tag:** v0..0 +``` \ No newline at end of file