# Changelog

Every feature-doc version, across all surfaces, newest first. One line per
version. Details live in the feature doc's *Changelog* section.

**Type:** `MAJOR` (breaking — app must change) · `MINOR` (additive) · `PATCH`
(no contract change) · `DOCS` (documentation/project only).

| Date | Surface | Feature doc | Version | Type | Summary |
|------|---------|-------------|---------|------|---------|
| 2026-11-16 | trainer | [hall-bookings](trainer/hall-bookings.md) | 0.3.0 | MINOR | Hall availability hides slots held by accepted / booked requests (D8). |
| 2026-11-16 | provider | [bookings](provider/bookings.md) | 1.0.1 | DOCS | States the hidden-slots rule. |
| 2026-11-16 | client | [enrollment](client/enrollment.md) | 1.0.0 | MAJOR | Order summary, enrollment, payment callback and reconcile, free courses, packages, expiry; the gateway-integration guide. |
| 2026-11-16 | client | [my-courses](client/my-courses.md) | 1.0.0 | Initial | My courses, enrolled course, external link delivery and the entry ticket. |
| 2026-11-16 | client | [courses](client/courses.md) | 1.0.1 | DOCS | Cross-references to enrollment and My courses. |
| 2026-11-16 | trainer | [subscriptions](trainer/subscriptions.md) | 1.1.0 | MINOR | `payment.redirect_url` on a pending plan; the shared callback settles it. |
| 2026-11-16 | admin | [courses](admin/courses.md) | 1.0.2 | PATCH | Cancelling a course voids the entry tickets. |
| 2026-11-16 | provider | [events](provider/events.md) | 1.1.0 | MINOR | Standalone events: `title`, `description`, `external_link`; no course link for now. |
| 2026-11-16 | admin | [events](admin/events.md) | 1.1.0 | MINOR | `title`; the linked-course key and filter are removed. |
| 2026-11-16 | admin | [auth](admin/auth.md) | 1.0.0 | MAJOR | Login `id` is the uuid and `permissions[]` is filled with the account's permission keys. |
| 2026-11-16 | admin | [access](admin/access.md) | 0.4.0 | MINOR | Sensitive admin decisions are written to the activity log (trainers, courses, accounts, commissions, packages, events). |
| 2026-11-16 | trainer | [course-create](trainer/course-create.md) | 1.0.0 | MINOR | Learning points and the course discount on create / edit; the doc is now ready. |
| 2026-11-16 | center | [courses](center/courses.md) | 1.1.1 | PATCH | Learning points and discount in the form and the response. |
| 2026-11-16 | provider | [account](provider/account.md) | 1.1.3 | PATCH | Login `id` is the uuid; the admin creates and suspends providers. |
| 2026-11-16 | trainer | [subscriptions](trainer/subscriptions.md) | 1.0.1 | DOCS | Known limitation updated: admin plan CRUD and subscription list exist. |
| 2026-11-16 | admin | [hall-providers](admin/hall-providers.md) | 1.0.1 | DOCS | Status line points to hall-bookings.md for settlement. |
| 2026-11-16 | admin | [courses](admin/courses.md) | 1.0.1 | PATCH | A course inside a package can be cancelled; package seats get no automatic refund line. |
| 2026-11-16 | admin | [packages](admin/packages.md) | 1.1.0 | MINOR | Cancellation policy for packages: cancelled course inside a package, `has_unavailable_course`. |
| 2026-11-16 | trainer | [packages](trainer/packages.md) | 1.1.0 | MINOR | Cancellation policy for packages: cancelled course inside a package, `has_unavailable_course`. |
| 2026-11-16 | center | [packages](center/packages.md) | 1.1.0 | MINOR | Cancellation policy for packages: cancelled course inside a package, `has_unavailable_course`. |
| 2026-11-16 | center | [auth](center/auth.md) | 1.1.0 | MINOR | One login for the center and its affiliated trainers, with role and permissions. |
| 2026-11-16 | center | [trainers](center/trainers.md) | 1.1.0 | MINOR | The center types the trainer's first password; resend-login takes a password. |
| 2026-11-16 | center | [courses](center/courses.md) | 1.1.0 | MINOR | Affiliated trainers use the same endpoints for their own courses. |
| 2026-11-16 | center | [dashboard](center/dashboard.md) | 1.1.0 | MINOR | Trainer view of the home. |
| 2026-11-16 | client | [auth](client/auth.md) | 1.0.0 | Initial | Trainee registration with OTP, login, password reset and change. |
| 2026-11-16 | client | [courses](client/courses.md) | 1.0.0 | Initial | Public course catalog and details; external link released to enrolled trainees. |
| 2026-11-16 | client | [home](client/home.md) | 1.0.0 | Initial | Home aggregate: categories, latest courses, offers, packages. |
| 2026-11-16 | provider | [events](provider/events.md) | 1.0.0 | Initial | Events: external or linked to a course, enable / disable. |
| 2026-11-16 | admin | [events](admin/events.md) | 1.0.0 | Initial | Events list and details, suspend and reactivate. |
| 2026-11-16 | admin | [packages](admin/packages.md) | 1.0.0 | Initial | Packages list and details, suspend and reactivate. |
| 2026-11-16 | trainer | [packages](trainer/packages.md) | 1.0.0 | Initial | Independent trainer packages: create, edit, deactivate. |
| 2026-11-16 | center | [packages](center/packages.md) | 1.0.0 | Initial | Center packages from the center's own courses. |
| 2026-11-15 | admin | [trainers](admin/trainers.md) | 1.0.1 | PATCH | Trainer accept / reject also create an in-app notice. |
| 2026-11-15 | center | [auth](center/auth.md) | 1.0.0 | Initial | Center login with the three account states, password reset. |
| 2026-11-15 | center | [dashboard](center/dashboard.md) | 1.0.0 | Initial | Home counts and latest activity. |
| 2026-11-15 | center | [trainers](center/trainers.md) | 1.0.0 | Initial | Affiliated trainers: list, create, details, suspend / reactivate, resend login, courses. |
| 2026-11-15 | center | [courses](center/courses.md) | 1.0.0 | Initial | Center courses: create with or without trainer, price approval, submit, edit requests, threshold date, enrollees. |
| 2026-11-15 | admin | [centers](admin/centers.md) | 1.0.0 | Initial | Training centers: list, create, details, activate / suspend / reactivate, move an affiliated trainer. |
| 2026-11-15 | provider | [bookings](provider/bookings.md) | 1.0.0 | Initial | Booking inbox, accept (Pending commission), reject, confirm Booked (commission Due), cancel, cancellation requests, auto-completion. |
| 2026-11-15 | admin | [hall-bookings](admin/hall-bookings.md) | 1.0.0 | Initial | Hall booking list and detail, commission list and Mark as Settled. |
| 2026-11-15 | trainer | [hall-bookings](trainer/hall-bookings.md) | 0.2.0 | MINOR | Cancellation request for a Booked booking; new booking fields. |
| 2026-11-15 | admin | [courses](admin/courses.md) | 1.0.0 | Initial | Course list and details, review (approve / reject), review of published-course edits, admin core edits, suspend / reactivate / complete / cancel. |
| 2026-11-15 | trainer | [course-create](trainer/course-create.md) | 0.2.0 | MINOR | Threshold scheduling inputs and current response examples. |
| 2026-11-15 | trainer | [courses](trainer/courses.md) | 1.0.1 | PATCH | Unchanged admin-only fields no longer refused on published edits; exact `status` filter. |
| 2026-11-15 | trainer | [courses](trainer/courses.md) | 1.0.0 | Initial | Course tabs, review requests, threshold scheduling and enrollee summaries. |
| 2026-11-15 | provider | [halls](provider/halls.md) | 1.2.1 | PATCH | Public `GET /cities`; `/countries` fixed (500 when a geo resolver matched); docs state the upload `hash`, the `?status=` list filter and that the feature list is built. |
| 2026-11-15 | provider | [account](provider/account.md) | 1.1.2 | DOCS | Provider permissions model stated: none, `permissions` is always `[]`; logo takes the upload `hash`. |
| 2026-11-15 | admin | [dashboard](admin/dashboard.md) | 0.1.1 | PATCH | The home response has no `system` block (the doc listed one the endpoint never returned); RBAC is enforced in every environment. |
| 2026-11-15 | admin | [settings](admin/settings.md) | 0.1.1 | PATCH | RBAC is enforced in every environment; `PUT /settings` still bypasses the commission rate history, so edit those rates on their own screens (TD-30). |
| 2026-11-15 | trainer | [auth](trainer/auth.md) | 1.0.1 | PATCH | Register and forgot-password `verification_token` is a plain uuid (was prefixed, 500 on MySQL); opaque to the app (TD-34). |
| 2026-11-15 | provider | [account](provider/account.md) | 1.1.1 | PATCH | Forgot-password `verification_token` is a plain uuid (was `reset:<uuid>`); opaque (TD-34). |
| 2026-11-15 | admin | [trainers](admin/trainers.md) | — | DOCS | Trainer list: one `status` filter covers the BRD's account status, review status and profile completion (TD-33). |
| 2026-11-15 | admin | [access](admin/access.md) | — | DOCS | **Deploy step, existing environments:** run `php artisan db:seed --class=PermissionSeeder` (creates the `*.delete` / `suspend` permissions and re-syncs the finance role), then re-save every non-super-admin role that must keep delete rights, because a supervisor who deleted through `*.edit` now needs `*.delete`. |
| 2026-11-15 | admin | [trainer-finance](admin/trainer-finance.md) | 1.1.0 | MINOR | `GET /trainer-subscriptions/{id}`: subscription detail with plan terms, trainer summary and payments (ADM-036). Same `trainer-subscriptions.view` permission; no new seeding. |
| 2026-11-15 | admin | [hall-providers](admin/hall-providers.md) | 1.0.0 | Initial | Providers with login accounts, hall feature list, halls overview, hall commission rate and history; deactivated features can no longer be booked (ADM-015..017, 019). |
| 2026-11-15 | admin | [trainer-finance](admin/trainer-finance.md) | 1.0.0 | Initial | Trainer packages, subscriptions list, commission rate with history (ADM-036). |
| 2026-11-15 | admin | [trainers](admin/trainers.md) | 1.0.0 | Initial | Trainer list, review details, accept / reject / suspend / reactivate (ADM-005..008). |
| 2026-11-15 | admin | [catalog](admin/catalog.md) | 1.1.0 | MINOR | Category usage counts; used categories cannot be deleted, unused ones are soft-deleted (ADM-044). |
| 2026-11-15 | admin | [access](admin/access.md) | 0.3.0 | MINOR | Permission grid (`grid`, new `delete` and `suspend` actions), roles in use cannot be deleted, suspension through edit (ADM-049). |
| 2026-11-15 | all | [MCP_APP_TEAM_KIT.md](MCP_APP_TEAM_KIT.md) | 1.0.1 | DOCS | Copy-paste MCP setup for Flutter and Vue teams: `morvia-docs` connection per agent, rules block, per-surface table; the viewer fills `{HOST}` with the backend's own URL. |
| 2026-11-15 | provider | [halls](provider/halls.md) | 1.2.0 | MINOR | Lean list rows; full record on the detail endpoint. |
| 2026-11-15 | trainer | [hall-bookings](trainer/hall-bookings.md) | 0.1.0 | Initial | Browse halls, price, send, list and withdraw booking requests (TRR-031, TRR-032). |
| 2026-11-15 | trainer | [course-create](trainer/course-create.md) | 0.1.0 | Initial | Course drafts, validation, submit with package enforcement (TRR-009..012). |
| 2026-11-15 | trainer | [subscriptions](trainer/subscriptions.md) | 1.0.0 | Initial | Packages, purchase, commission model, expiry (TRR-005..007, TRR-030). |
| 2026-11-15 | trainer | [profile](trainer/profile.md) | 1.0.0 | Initial | Trainer profile, review submit, password, public trainer page (TRR-002, TRR-004, TRR-028). |
| 2026-11-15 | trainer | [auth](trainer/auth.md) | 1.0.0 | Initial | Registration with OTP, Nafath, login, reset (TRR-001..004, PLT-003). |
| 2026-11-15 | provider | [halls](provider/halls.md) | 1.1.0 | MINOR | Hall activation validation; feature price above zero. |
| 2026-11-15 | provider | [account](provider/account.md) | 1.1.0 | MINOR | Phone login, forgot / reset password. |
| 2026-11-15 | provider | [account](provider/account.md) | 1.0.0 | Initial | Provider login, logout and profile (HPV-001, HPV-002). |
| 2026-11-15 | provider | [halls](provider/halls.md) | 1.0.0 | Initial | Halls, admin-list features with per-hall prices, status and availability (HPV-003..006). |
| 2026-11-15 | admin | [access](admin/access.md) | 0.2.0 | MINOR | Dashboard account types, explicit RBAC grants, supervisor visibility, role and permission seeding (ADM-049). |
| 2026-11-12 | admin | [access](admin/access.md) | 0.1.1 | PATCH | Document admin identity enforcement and suspension behavior. |
| 2026-11-12 | admin | [auth](admin/auth.md) | 0.2.0 | MINOR | Email-only login, throttling, JWT refresh and suspension enforcement. |
| 2026-11-12 | admin | [access](admin/access.md) | 0.1.0 | DOCS | Existing admin users, supervisors, roles, permissions, audit log and profile contract; suspension, permission-model and UUID gaps recorded. |
| 2026-11-12 | admin | [content-support](admin/content-support.md) | 0.1.0 | DOCS | Existing pages, FAQs, sliders and contact-message routes; no response examples captured, BRD gaps recorded. |
| 2026-11-12 | admin | [settings](admin/settings.md) | 0.1.0 | DOCS | Existing settings and feature-flag routes; missing BRD settings and partial-update behaviour recorded. |
| 2026-11-12 | admin | [dashboard](admin/dashboard.md) | 0.1.0 | DOCS | Existing home indicators contract versus ADM-002. |
| 2026-11-12 | admin | [notifications](admin/notifications.md) | 0.1.0 | DOCS | Existing admin notification list/send and relation to shared notifications. |
| 2026-11-12 | admin | [auth](admin/auth.md) | 0.1.1 | PATCH | Fix media model boot failure during login. |
| 2026-11-12 | all | [API conventions](API_CONVENTIONS.md) | 1.0.0 | MAJOR | Apps must remove `/client` from FAQ, page, slider and country URLs; routes are public and shared. |
| 2026-11-12 | admin | [auth](admin/auth.md) | 0.1.0 | DOCS | Existing admin login/logout contract and known gaps. |
| 2026-11-12 | admin | [catalog](admin/catalog.md) | 1.0.0 | MAJOR | Admin CRUD uses public UUIDs; cities expose linked usage counts. |
| 2026-11-12 | admin | [catalog](admin/catalog.md) | 0.1.0 | Initial | City management; catalog remains in progress. |
| 2026-11-12 | client | [enrollment](client/enrollment.md) | 0.2.0 | MINOR | Course availability and typed checkout refusal; HTTP integration remains planned. |
| 2026-11-12 | client | [enrollment](client/enrollment.md) | 0.1.0 | DOCS | Checkout domain actions and fake gateway only; HTTP integration remains planned. |
| 2026-11-12 | all | [database design](database/schema-design.md) | — | DOCS | Payment gateway and Nafath integrations deferred until the client provides them (TD-15, TD-16): checkout and trainer verification are built behind `PaymentGateway` / `NafathGateway` contracts with a `fake` driver so the full test cycle runs now; DEC-06 stays open. |
| 2026-11-12 | all | [database design](database/schema-design.md) | — | DOCS | Target schema final: 78 tables (`db-schema.sql`, loads on MySQL 8); live course row + edit / cancellation requests (TD-10), base wallet / geo tables dropped (TD-11), bilingual notifications (TD-12), domain ledgers (TD-13), trainer ratings (SCR-04), course sessions (SCR-05), price locked after first enrollment (DEC-34). |
| 2026-11-12 | all | [BRD guide](brd/BRD-Morvia-Project-Guide-en.md) | — | DOCS | Cancellation policy (10-11-2026) ingested: D5–D9, §9.1 change map, BR-CNL-01…11, hall cancellation moved to booker / provider; owner answered DEC-03/04/08/09/12/13/16/17/18/20/21/22/29/31 (DEC-15 partly); DEC-33, TD-09. |
| 2026-11-11 | all | [BRD guide](brd/BRD-Morvia-Project-Guide-en.md) | — | DOCS | BRD v1.0 + additional requirements ingested: 148 features (TRN/TRR/CTR/HPV/ADM/PLT), per-feature files, D1–D4, DEC-01…32; surfaces trainer, center, provider added, admin on Vue (TD-07). |
| 2026-11-11 | all | [app screens index](app_screens/INDEX.md) | — | DOCS | Indexed 32 trainee and trainer design exports, shared academy references and open screen differences. |
| 2026-11-11 | all | [MCP_AGENT_GUIDE.md](MCP_AGENT_GUIDE.md) | 1.2.0 | DOCS | Reusable base (TD-06): project name from `APP_NAME`; MCP server name is `{slug}-docs` (shown on `/docs`), stdio handle `project-docs`. |
| 2026-11-11 | all | [QUICK_SETUP.md](QUICK_SETUP.md) | 1.0.0 | DOCS | First-time setup guide: `.env` keys and secrets before any command, database + demo accounts, agent setup, known setup pitfalls. |
| 2026-11-11 | all | [MCP_AGENT_GUIDE.md](MCP_AGENT_GUIDE.md) | 1.1.0 | DOCS | Token budgets (TD-05): `read-doc` `outline` / `section`; briefs include the feature doc's Quick reference and per-feature BRD files. |
| 2026-11-11 | all | [MCP_AGENT_GUIDE.md](MCP_AGENT_GUIDE.md) | 1.0.0 | DOCS | Docs viewer (`/docs`), API console (`/tester`) and the `project-docs` MCP server for app coding agents (TD-01). |
| 2026-11-11 | all | [API_CONVENTIONS.md](API_CONVENTIONS.md) | 0.1.0 | DOCS | Base conventions as the code behaves today: envelope, errors, pagination, headers, Flutter/React setup. |
