diff --git a/Home.md b/Home.md index 5d08b7b..2270795 100644 --- a/Home.md +++ b/Home.md @@ -1 +1,68 @@ -Welcome to the Wiki. \ No newline at end of file +# 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) \ No newline at end of file