feat(mobile-api): GET /api/mobile/invoices, GET /api/mobile/invoices/:id — invoice CRUD (P0, blocks iOS FEE-003/004)

[abdout]

Why

Guardians need to view their child's invoices on iOS to know what to pay. Accountants need access to record payments. Backend already has Invoice Prisma model + web UI; mobile endpoints missing.

Contract

GET /api/mobile/invoices
Authorization: Bearer <jwt>
Query: ?student_id=<id>&status=open|paid|overdue&page=1&page_size=20

Response 200:
{
  "data": [
    {
      "id": "<id>",
      "student_id": "<id>",
      "student_name": "<string>",
      "status": "open" | "paid" | "partial" | "overdue",
      "currency": "USD" | "SAR" | "SDG",  // from school config
      "amount_total": 1000.00,
      "amount_paid": 0.00,
      "balance": 1000.00,
      "due_date": "<ISO8601>",
      "issued_date": "<ISO8601>",
      "lang": "ar" | "en"
    }
  ],
  "meta": { "page": 1, "page_size": 20, "total": 12 }
}

GET /api/mobile/invoices/:id
Response: full detail with line_items[]

Implementation

• Scope by JWT.schoolId
• Guardian: only their children's invoices (via StudentGuardian join)
• Accountant: all in school
• Student: only their own
• Currency from School.currency per tenant

iOS stories blocked

• FEE-003 invoice-list
• FEE-004 invoice-detail
• PAY-005 payment-history (uses invoices)
• M1 phase pilot expansion blocked without these

Related

• See companion ticket: payment processing (referencing this issue)
• iOS PR with full backlog: docs: 48-epic / 414-story BMAD backlog with i18n + multi-tenant gates ios-app#2

[github-actions]

This issue has been automatically marked as stale because it has not had any activity for 30 days.

It will be closed in 7 days if no further activity occurs. If this issue is still relevant, please:

• Add a comment with any updates
• Remove the stale label

Thank you for your contributions to Hogwarts!

[github-actions]

This issue has been automatically closed due to inactivity.

If you believe this issue is still relevant, please feel free to reopen it with additional context or create a new issue.