> **For client planning only:** This is an incomplete coverage/verification record, not a backend implementation guide or a release sign-off.

# Outlet — Full module route inventory and contract gap audit

**Checked:** 2026-11-22. **Repository:** `alalmiyalhura/outlet` / GitLab project `89166951` / `main`.

## Certification verdict

**NOT COMPLETE / NOT STAGING-VERIFIED.** The user's requested all-at-once handoff cannot responsibly be certified from the current Markdown. The audit below covers every discovered module route file, but counts are **source declarations**, not runtime `route:list` results, and do not certify individual endpoint payloads. No server tests were run. Existing Flutter and Dashboard files remain separate.

## Repository inventory — all 34 module API route files

Source: each `modules/<Module>/Routes/api.php` read from GitLab `main` in this pass. Count = occurrences of `Route::get/post/put/patch/delete/match/any(`, **including routes nested in groups**. It does not resolve prefixes, environment conditionals, or externally registered routes. The root `routes/api.php` has **1** additional authenticated `GET /user` declaration. `Realtime` uses no direct HTTP verb declaration in its module API file.

| Module | HTTP verb declarations |
|---|---:|
| `Access` | 27 |
| `Accounts` | 32 |
| `Audit` | 1 |
| `AuditChain` | 2 |
| `BulkActions` | 3 |
| `Cart` | 13 |
| `Catalog` | 93 |
| `Chat` | 18 |
| `Core` | 3 |
| `Dashboards` | 2 |
| `Delivery` | 16 |
| `Devices` | 4 |
| `Disputes` | 25 |
| `FeatureFlags` | 1 |
| `Identity` | 28 |
| `Impersonation` | 3 |
| `ImportExport` | 10 |
| `Locations` | 9 |
| `Media` | 5 |
| `Notifications` | 16 |
| `Orders` | 40 |
| `Pages` | 15 |
| `Payments` | 15 |
| `Pricing` | 9 |
| `Push` | 1 |
| `Realtime` | 0 |
| `Reports` | 6 |
| `Reviews` | 16 |
| `Scheduler` | 4 |
| `Search` | 3 |
| `Settings` | 4 |
| `Support` | 29 |
| `Verification` | 4 |
| `Wallet` | 26 |
| **Modules total** | **483** |
| **Root `routes/api.php`** | **1** |
| **Combined source declarations** | **484** |

**Important:** Do not interpret 484 as a verified number of callable production endpoints. Route registration, group prefixes, duplicates, conditional registration and versioning need `php artisan route:list --json` on the target deployment.

## Current documentation file inspection

Counts are **text-quality indicators**, not missing endpoint totals. `not yet verified` is an exact phrase count. Pending/unverified terms may appear in historical appendices even where newer sections have been source-reviewed.

| File | Lines | Exact `not yet verified` | Pending/unverified terms |
|---|---:|---:|---:|
| `dashboard/access.md` | 853 | 0 | 0 |
| `dashboard/accounts.md` | 154 | 31 | 31 |
| `dashboard/audit.md` | 80 | 0 | 1 |
| `dashboard/auditchain.md` | 82 | 0 | 1 |
| `dashboard/bulkactions.md` | 98 | 1 | 1 |
| `dashboard/carts.md` | 164 | 0 | 0 |
| `dashboard/catalog.md` | 774 | 0 | 1 |
| `dashboard/chat.md` | 246 | 0 | 38 |
| `dashboard/dashboards.md` | 149 | 0 | 0 |
| `dashboard/delivery.md` | 204 | 0 | 1 |
| `dashboard/disputes.md` | 289 | 0 | 3 |
| `dashboard/general-settings-contracts.md` | 90 | 0 | 0 |
| `dashboard/identity-users.md` | 234 | 0 | 8 |
| `dashboard/impersonation.md` | 174 | 1 | 15 |
| `dashboard/importexport.md` | 136 | 0 | 40 |
| `dashboard/locations.md` | 264 | 0 | 29 |
| `dashboard/notifications.md` | 419 | 0 | 0 |
| `dashboard/orders-management.md` | 449 | 1 | 12 |
| `dashboard/pages.md` | 908 | 0 | 60 |
| `dashboard/payments.md` | 249 | 29 | 30 |
| `dashboard/pricing.md` | 833 | 13 | 16 |
| `dashboard/reports.md` | 84 | 0 | 24 |
| `dashboard/reviews.md` | 494 | 1 | 31 |
| `dashboard/scheduler.md` | 94 | 0 | 1 |
| `dashboard/search.md` | 183 | 0 | 6 |
| `dashboard/settings.md` | 1034 | 7 | 12 |
| `dashboard/support.md` | 747 | 0 | 1 |
| `dashboard/verification.md` | 106 | 0 | 0 |
| `dashboard/wallet.md` | 324 | 0 | 10 |
| `flutter/access.md` | 111 | 0 | 0 |
| `flutter/accounts.md` | 260 | 0 | 1 |
| `flutter/authentication-verified-contracts.md` | 957 | 0 | 2 |
| `flutter/authentication.md` | 166 | 0 | 10 |
| `flutter/cart.md` | 211 | 0 | 1 |
| `flutter/catalog.md` | 731 | 0 | 2 |
| `flutter/chat.md` | 164 | 0 | 18 |
| `flutter/checkout-orders.md` | 550 | 1 | 9 |
| `flutter/core.md` | 198 | 0 | 14 |
| `flutter/delivery.md` | 102 | 0 | 0 |
| `flutter/devices-contracts.md` | 65 | 0 | 0 |
| `flutter/devices.md` | 347 | 9 | 12 |
| `flutter/disputes.md` | 158 | 0 | 6 |
| `flutter/featureflags.md` | 33 | 0 | 0 |
| `flutter/locations.md` | 194 | 0 | 8 |
| `flutter/media-contracts.md` | 43 | 0 | 0 |
| `flutter/media.md` | 118 | 0 | 0 |
| `flutter/notifications.md` | 261 | 0 | 1 |
| `flutter/pages.md` | 737 | 0 | 8 |
| `flutter/payments.md` | 140 | 0 | 9 |
| `flutter/pricing-contracts.md` | 61 | 0 | 3 |
| `flutter/pricing.md` | 346 | 7 | 11 |
| `flutter/push.md` | 100 | 0 | 0 |
| `flutter/realtime.md` | 132 | 0 | 0 |
| `flutter/reviews.md` | 474 | 1 | 25 |
| `flutter/search.md` | 193 | 0 | 9 |
| `flutter/settings.md` | 310 | 0 | 2 |
| `flutter/support.md` | 509 | 0 | 1 |
| `flutter/verification-realtime.md` | 94 | 0 | 0 |
| `flutter/verification.md` | 139 | 0 | 0 |
| `flutter/wallet.md` | 160 | 0 | 12 |

**Totals:** 60 Flutter/Dashboard Markdown files; 102 explicit `not yet verified` phrases across 12 files. This count is independent of the number of route declarations.

## Critical integration boundaries confirmed from route sources

- `Cart`: 7 authenticated app routes and 6 Dashboard routes. Admin carts list/detail/history are read-only; admin settings change separately. No direct admin cart-item mutation endpoint.
- `Wallet`: 7 authenticated app routes and 19 Dashboard routes. `ledger.correct` is separate from `ledger.view`; ledger reversals/adjustments create new transactions, not edits.
- `Payments`: 1 gateway webhook, 4 app-side routes (two fake simulator actions restricted to development), and 10 Dashboard routes. Webhooks are **not** user-facing Flutter endpoints.
- `Accounts`: 1 public seller route, 16 authenticated app routes, and 15 Dashboard routes. Sensitive data has separate permissions.
- `Delivery`: 3 public/app-facing routes and 13 Dashboard routes. Courier enable/disable and rate activation are distinct from fee updates.
- `Verification`: 2 public OTP routes and 2 Dashboard policy routes.
- `Search`: 2 authenticated user routes and 1 admin analytics route requiring `search.analytics`.

## Blocking items for a truthful all-complete claim

1. Resolve each nested route prefix, method, middleware and permission into a canonical inventory, then compare it against Flutter/Dashboard Markdown by route identity (not just headings).
2. Review every route's controller action and FormRequest, including cross-field rules and allowed values.
3. Review resource/presenter serialization for exact nullable fields, localization and monetary units; remove contradictory historical text where necessary.
4. Confirm error response shapes from exception mappings and tests; never invent captured response examples.
5. Verify real requests against Staging for 200/201/204, 401/403/404/422/429, idempotency, localization and webhook signature handling.
6. Run a final static link/path check and `zip.testzip()`; archive integrity is distinct from API validation.

## Highest-risk unresolved documentation

Prioritize `dashboard/accounts.md`, `dashboard/payments.md`, `dashboard/pricing.md`, `dashboard/settings.md`, `flutter/devices.md`, `flutter/pricing.md`, and order/checkout contracts. The current bundle contains explicit unresolved markers, so it is **not ready to be represented as a complete developer handoff**.


## Pricing documentation cleanup (2026-11-22)

Removed duplicated historical unverified sections from `flutter/pricing.md`; removed misplaced Verification and Localization contracts and the duplicate historical inventory from `dashboard/pricing.md`. The six Pricing dashboard contracts and three Flutter fee contracts remain. Based on GitLab main source; staging not tested.
