Ce fichier relie chaque route OpenAPI à un parcours documenté. Il s'adresse aux développeurs et à la QA pour vérifier qu'une route n'est pas orpheline.

Les routes ci-dessous sont générées à partir de docs/api/openapi.json. Les routes invisibles d'OpenAPI (/metrics, /health/ready et le WebSocket) sont décrites dans les guides temps réel et configuration.

Catalogue et restaurants

/food/v1/restaurants accepte limit, offset, q, category, is_open et, en V1, latitude, longitude, radius_km. /food/v1/restaurants, /food/v1/restaurants/{restaurant_id}, /food/v1/restaurants/{restaurant_id}/menu, /food/v1/restaurants/{restaurant_id}/dishes, /food/v1/restaurants/{restaurant_id}/dishes/{dish_id}, /food/v1/restaurants/{restaurant_id}/dishes/{dish_id}/availability, /food/v1/restaurants/{restaurant_id}/kitchen/dishes, /food/v1/restaurants/{restaurant_id}/logo, /food/v1/restaurants/{restaurant_id}/availability, /food/v1/restaurants/{restaurant_id}/service-settings, /food/v1/me/restaurants sont couverts par restaurant-pro-flow.md et customer-order-flow.md.

Commandes et livraison

/food/v1/orders, /food/v1/orders/{order_id}, /food/v1/orders/{order_id}/cancel, /food/v1/orders/{order_id}/rating (POST et GET), /food/v1/restaurants/{restaurant_id}/quote, /food/v1/restaurants/{restaurant_id}/orders, /food/v1/restaurants/{restaurant_id}/orders/{order_id}/accept, /food/v1/restaurants/{restaurant_id}/orders/{order_id}/reject, /food/v1/restaurants/{restaurant_id}/orders/{order_id}/ready, /food/v1/restaurants/{restaurant_id}/orders/{order_id}/delivery/request, /food/v1/orders/{order_id}/delivery, /food/v1/orders/{order_id}/delivery/tracking, /food/v1/orders/{order_id}/delivery/refresh, /food/v1/restaurants/{restaurant_id}/orders/{order_id}/pickup/complete sont couverts par customer-order-flow.md et delivery-flow.md.

Paiement, remboursements et wallet

/food/v1/orders/{order_id}/payment, /food/v1/orders/{order_id}/payment/refresh, /food/v1/orders/{order_id}/payments/prepare, /food/v1/restaurants/{restaurant_id}/orders/{order_id}/payments/confirm-cash, /food/v1/payment-returns/{token}, /food/v1/orders/{order_id}/refund-requests (POST et GET), /food/v1/admin/refund-requests, /food/v1/admin/refund-requests/{refund_request_id}/approve, /food/v1/admin/refund-requests/{refund_request_id}/reject, /food/v1/restaurants/{restaurant_id}/wallet, /food/v1/restaurants/{restaurant_id}/wallet/entries, /food/v1/restaurants/{restaurant_id}/wallet/withdrawal-quote, /food/v1/restaurants/{restaurant_id}/wallet/withdrawals, /food/v1/restaurants/{restaurant_id}/wallet/withdrawals/{withdrawal_id}, /food/v1/admin/restaurants/{restaurant_id}/wallet/beneficiary sont couverts par payments-wallet.md.

Backoffice, pilotage, support et notifications

Les routes /food/v1/internal/backoffice/* sont couvertes par restaurant-pro-flow.md et payments-wallet.md. Les routes /food/v1/internal/pilotage/* sont couvertes par pilotage-flow.md. La route /internal/v1/support/order/{order_id}/context est couverte par support-context-flow.md. /food/v1/devices/register et /food/v1/devices/unregister sont couvertes par customer-order-flow.md.

Couverture explicite des opérations administratives et V1

Les décisions restaurant et l'audit utilisent /food/v1/restaurants/{restaurant_id}/approve, /food/v1/restaurants/{restaurant_id}/reject, /food/v1/restaurants/{restaurant_id}/staff, /food/v1/restaurants/{restaurant_id}/staff/{target_user_id}, /food/v1/internal/backoffice/restaurants, /food/v1/internal/backoffice/restaurants/{restaurant_id}, /food/v1/internal/backoffice/restaurants/{restaurant_id}/staff, /food/v1/internal/backoffice/restaurants/{restaurant_id}/staff/{target_user_id}, /food/v1/internal/backoffice/restaurants/{restaurant_id}/service-settings, /food/v1/internal/backoffice/restaurants/{restaurant_id}/decisions et /food/v1/internal/backoffice/audit-events; ces opérations sont couvertes par restaurant-pro-flow.md.

Le Backoffice suit les commandes et remboursements avec /food/v1/internal/backoffice/orders, /food/v1/internal/backoffice/orders/{order_id}, /food/v1/internal/backoffice/orders/{order_id}/cancel, /food/v1/internal/backoffice/orders/{order_id}/delivery, /food/v1/internal/backoffice/orders/{order_id}/payment, /food/v1/internal/backoffice/refund-requests, /food/v1/internal/backoffice/refund-requests/{refund_request_id}/approve, /food/v1/internal/backoffice/refund-requests/{refund_request_id}/reject et /food/v1/internal/backoffice/restaurants/{restaurant_id}/dishes; ils sont couverts par payments-wallet.md et restaurant-pro-flow.md.

La notation client est active après livraison avec /food/v1/orders/{order_id}/rating. Les substitutions restent contrôlées par porte : /food/v1/orders/{order_id}/items/{item_id}/substitution/respond et /food/v1/restaurants/{restaurant_id}/orders/{order_id}/items/{item_id}/substitution sont couvertes par customer-order-flow.md. Le résumé restaurant /food/v1/restaurants/{restaurant_id}/daily-summary est couvert par restaurant-pro-flow.md. Les routes /food/v1/internal/pilotage/daily-summary, /food/v1/internal/pilotage/finance-summary, /food/v1/internal/pilotage/breakdown, /food/v1/internal/pilotage/orders/{order_id}/financial-breakdown et /food/v1/internal/pilotage/health-summary sont couvertes par pilotage-flow.md.