Update Home

Home.md

@@ -1 +1,68 @@
-Welcome to the Wiki.
+# TrizAgenda — Team Hub
+
+**TrizAgenda** is the scheduling & task-management platform for TrizGroupe (TrizTech + HydroTriz):
+tasks, meetings, unified agendas, notifications, bookable resources, supervision — multi-establishment,
+with scope enforced by the API from the login token.
+
+> New here? Read the [working agreements](https://REPLACE-GITEA/trizagenda/trizagenda-team/src/branch/main/docs/team-onboarding-and-working-agreements.md), then your repo's `ARCHITECTURE.md`, then do your repo's `-01` issue. Stuck 30 minutes → say it in the channel.
+
+## The team
+
+| Who | Owns | First stop for |
+|---|---|---|
+| PM | Backlog, priorities, reviews (<24h), decisions | Unclear issues, spec questions, anything blocking |
+| API dev | `trizagenda-api` | Endpoint behavior, error codes, DB questions |
+| Web dev | `trizagenda-web` | Browser app |
+| Mobile dev | `trizagenda-mobile` | Flutter app |
+
+## Repositories
+
+| Repo | Stack | Start here |
+|---|---|---|
+| [trizagenda-api](https://REPLACE-GITEA/trizagenda/trizagenda-api) | Spring Boot 3 · Java 21 · PostgreSQL · Flyway | `README.md` → `ARCHITECTURE.md` |
+| [trizagenda-web](https://REPLACE-GITEA/trizagenda/trizagenda-web) | React 18 · Vite · TypeScript | `README.md` → `ARCHITECTURE.md` |
+| [trizagenda-mobile](https://REPLACE-GITEA/trizagenda/trizagenda-mobile) | Flutter · Material 3 | `README.md` → `ARCHITECTURE.md` |
+| [trizagenda-team](https://REPLACE-GITEA/trizagenda/trizagenda-team) | Shared agreement docs (this wiki lives here) | `docs/` |
+
+Boards: each repo → Projects → the milestone board (shows the **active milestone only**).
+Cross-repo view: top-bar **Issues** filtered to the organization.
+
+## The two sources of truth
+
+- **`openapi.yaml` v1.0.0** — the API contract (lives in `trizagenda-api`; web & mobile carry copies for the Prism mock — re-copy on version bump). 127 operations; nobody invents endpoints.
+  - Pending **v1.0.1** additions (ratified at kickoff, to be written into the spec): `X-Client-Type: mobile` login header · `X-Refresh-Token` response header on refresh · (candidate) recurrence update/cancel endpoints.
+- **Figma prototype** — [REPLACE-FIGMA-LINK]. Every UI issue links its frame.
+
+## Reference shelf
+
+| Question | Document |
+|---|---|
+| Where does code go, what is each layer for? | `ARCHITECTURE.md` in your repo |
+| Branches, commits, merges, conflicts? | [git-strategy.md](https://REPLACE-GITEA/trizagenda/trizagenda-team/src/branch/main/docs/git-strategy.md) |
+| Issue/PR format, review checklists? | [issue-and-pr-conventions.md](https://REPLACE-GITEA/trizagenda/trizagenda-team/src/branch/main/docs/issue-and-pr-conventions.md) (+ `.gitea` templates pre-fill it) |
+| Style, tests, secrets, dependencies, ADRs? | [engineering-agreements.md](https://REPLACE-GITEA/trizagenda/trizagenda-team/src/branch/main/docs/engineering-agreements.md) |
+| What did we decide and when? | [Decisions](Decisions) (this wiki) |
+
+## Rhythm
+
+- **Daily** — 3-line async check-in in the team channel before 10:00 (yesterday / today / blockers)
+- **Weekly** — 45-min sync: demos → board walk → blockers & decisions → next week ([Sync-Notes](Sync-Notes))
+- **Milestone end** — integration checkpoint: joint demo, mock→real API switch, bugs filed on the spot
+
+## Milestones
+
+| # | Name | Dates | Tag |
+|---|---|---|---|
+| M1 | Foundations & Auth | REPLACE – REPLACE | `v0.1.0` |
+| M2 | Organisation & Users | | `v0.2.0` |
+| M3 | Tasks | | `v0.3.0` |
+| M4 | Meetings, Agenda & Notifications | | `v0.4.0` |
+| M5 | Resources, Reservations & Holidays | | `v0.5.0` |
+| M6 | Supervision, Dashboard & Hardening | | `v1.0.0` |
+
+## Dev essentials
+
+- Local API: `http://localhost:8080/api/v1` · Prism mock: `http://localhost:4010` (auth **always** real API)
+- Dev login (seeded, dev profile only): `admin@triztech.dz` / `Admin123!`
+- Android emulator reaches your machine via `10.0.2.2`, not `localhost` — see [FAQ](FAQ)
+- Staging: `https://trizagenda-staging.triztech.pro/api/v1` (deploys land with CI/CD)