<?php

return [
    'api' => 'API',
    'api_docs' => 'Rest API',
    'api_docs_help' => 'Centralized documentation for POS, delivery, waiter, and kiosk integrations.',
    'breadcrumb' => 'Super Admin > Settings > API',
    'open_docs' => 'Open docs',
    'copy_link' => 'Copy',
    'public_link' => 'Public share link',
    'public_link_help' => 'Generate a secure link for external developers. Regenerate to rotate.',
    'generate_link' => 'Generate link',
    'revoke_link' => 'Delete link',
    'public_link_empty' => 'No public link yet. Generate one to share read-only documentation.',
    'public_link_created' => 'Public link generated.',
    'public_link_revoked' => 'Public link revoked.',
    'public_banner' => 'Public, read-only documentation link generated from Super Admin settings.',
    'tester_title' => 'API testing',
    'tester_help' => 'Run live diagnostics using real credentials. Permission issues are highlighted.',
    'username' => 'Username / Email',
    'password' => 'Password',
    'password_placeholder' => '********',
    'run_test' => 'Run diagnostic',
    'testing' => 'Testing...',
    'status_ok' => 'Healthy',
    'status_permission' => 'Permission issue',
    'status_fail' => 'Unreachable',
    'no_tests' => 'Run a test to see endpoint health.',
    'unauthorized' => 'Unauthorized',
    'token_loaded' => 'Authenticated and loaded live user context.',
    'skipped_missing_context' => 'Skipped: missing :fields data but API is reachable.',
    'no_categories' => 'No categories returned yet; endpoint reachable.',
    'no_menus' => 'No menus returned yet; endpoint reachable.',
    'no_items' => 'No items available to test yet; endpoint reachable.',
    'no_order_type' => 'No order type returned to test charges.',
    'no_tables' => 'No tables available to test unlock.',
    'no_orders' => 'No orders available to validate this endpoint.',
    'no_reservations' => 'No reservations found to validate this endpoint.',
    'no_customers' => 'No customers available to test addresses.',
    'no_notifications' => 'No notifications found; API responding.',
    'no_branches' => 'No branches available for this account.',
    'internal_error' => 'Something went wrong. Please check logs.',
    'invalid_status' => 'Unsupported status value.',
    'not_found' => 'Record not found.',

    'doc' => [
        'toc' => 'On this page',
        'theme' => 'Theme',
        'overview_title' => 'Overview',
        'overview_desc' => 'Lightweight, token-based endpoints for building mobile POS, delivery, and admin experiences without touching core POS logic.',
        'base_url' => 'Base URL',
        'auth' => 'Auth',
        'formats' => 'Formats',

        'auth_title' => 'Authentication & Tokens',
        'auth_desc' => 'Issue scoped bearer tokens per staff account. Tokens inherit restaurant and branch context.',
        'login_summary' => 'Exchange staff credentials for a bearer token.',
        'login_note_token' => 'Send the returned token as Authorization: Bearer <token> on every request.',
        'login_note_permissions' => 'Token privileges match the user roles and permissions.',
        'me_summary' => 'Return the authenticated profile and enabled modules.',
        'me_note_roles' => 'Use the roles array to drive client-side feature flags.',

        'platform_title' => 'Platform & Config',
        'platform_desc' => 'Locale, currency, features, branches, and payment gateway flags to bootstrap clients.',
        'platform_config' => 'Bootstrap restaurant, branch, modules, and feature flags for the current token.',
        'platform_note_cache' => 'Responses are branch-aware. Switch branches to refresh context.',
        'languages_summary' => 'List active languages with codes and status.',
        'languages_note' => 'Fallback uses LanguageSetting::LANGUAGES if DB columns are limited.',
        'permissions_summary' => 'Return role names and granular permissions for the token.',
        'printers_summary' => 'List branch printers for routing tickets.',
        'receipt_summary' => 'Fetch receipt header/footer and formatting.',
        'switch_branch' => 'Switch the active branch for the current token.',

        'pos_title' => 'POS Endpoints',
        'pos_desc' => 'Menu, items, orders, and reservations for FOH and KDS workflows.',
        'menus_summary' => 'List active menus for the current branch.',
        'items_summary' => 'List menu items with pricing. Use filters for menus/categories.',
        'items_note_filters' => 'Filter by menu or category ids to reduce payload size.',
        'categories_summary' => 'List menu categories for the branch.',
        'items_by_category' => 'Fetch items by category.',
        'items_by_menu' => 'Fetch items for a specific menu.',
        'variations' => 'List variations for an item.',
        'modifiers' => 'List modifier groups for an item.',
        'extra_charges' => 'Fetch extra charges by order type.',
        'orders_create' => 'Create a POS order with items, actions, and routing.',
        'orders_list' => 'List orders with pagination.',
        'orders_filters' => 'Filter by status, type, branch_id, and page.',
        'orders_detail' => 'Fetch a single order.',
        'orders_status' => 'Update an order status.',
        'orders_pay' => 'Pay an order with payment records.',
        'customers' => 'List POS customers.',
        'customers_create' => 'Create a POS customer.',
        'phone_codes' => 'List phone codes for customer creation.',
        'taxes' => 'List taxes for the branch.',
        'restaurants' => 'List restaurants (super admin tokens).',
        'branches' => 'List branches for current restaurant.',
        'reservations' => 'List reservations.',
        'reservations_create' => 'Create a reservation.',
        'reservations_status' => 'Update reservation status.',
                'reservations_today' => 'Today\'s reservations shortcut.',
        'tables' => 'List tables for the branch.',
        'tables_unlock' => 'Force unlock a table.',
        'order_types' => 'List available order types.',
        'actions' => 'List allowed order actions.',
        'delivery_platforms' => 'List configured delivery platforms.',
        'order_number' => 'Fetch the next order number.',
        'waiters' => 'List waiters for assignment.',

        'customer_title' => 'Customer App',
        'customer_desc' => 'Customer catalog and order submission endpoints.',
        'catalog_summary' => 'Return menus, categories, and items for customer apps.',
        'customer_order' => 'Place a customer order (delivery/takeaway).',
        'customer_order_note' => 'Include customer_address_id for delivery flows.',
        'customer_orders' => 'List customer orders for the current token.',

        'notifications_title' => 'Notifications',
        'notifications_desc' => 'Register device tokens and fetch in-app notifications.',
        'notifications_register' => 'Register a device token for push notifications.',
        'notifications_list' => 'List notifications for the current user.',
        'notifications_read' => 'Mark a notification as read.',
        'notifications_test' => 'Send a test notification.',

        'sdks_title' => 'SDK Examples',
        'sdks_desc' => 'Use any language shown to consume endpoints with bearer auth.',
        'auth_required' => 'Auth required',
        'header' => 'Header',
        'value' => 'Value',
        'body_schema' => 'Request body',

        'shared_title' => 'Shared & Utilities',
        'shared_desc' => 'Common lookups and helpers for building clients.',
        'currencies_summary' => 'List currencies with codes and rates.',
        'gateways_summary' => 'Payment gateway meta for the restaurant.',
        'staff_summary' => 'List staff scoped to the restaurant.',
        'roles_summary' => 'List role names attached to the restaurant.',
        'areas_summary' => 'List delivery areas for the branch.',
        'customer_addresses' => 'List customer addresses by customer_id.',
    ],
];







