مرجع API — ملخص عام
تفاصيل الطلب/الاستجابة الحساسة تبقى في وثائق المستودع الداخلية عند الحاجة. هنا ملخص آمن بعد مراجعة: مسارات مسجّلة + صلاحيات + أثر عالي المستوى. الأمثلة وهمية.
المصادقة
| Method | Path | Auth | الغرض |
|---|---|---|---|
| POST | /api/v1/auth/login | عام | إصدار JWT |
| GET | /api/v1/auth/me | JWT | المستخدم الحالي |
| GET | /api/health | عام | فحص صحة |
المدفوعات
| Method | Path | Perm | أثر |
|---|---|---|---|
| GET | /api/v1/admin/payments | payments.view | قراءة |
| POST | /api/v1/admin/payments | payments.create | pending + حجز |
| POST | .../record-collection | payments.create | paid + ledger |
| POST | .../cancel | payments.create | cancelled |
| POST | .../refund | payments.refund | refunded + ledger debit |
| POST | /api/v1/payments/gateway/{code}/notify | تحقق مزوّد | تحصيل إن نجح (البوابة الافتراضية معطّلة) |
مثال وهمي (ليس بيانات حقيقية)
POST /api/v1/admin/payments
Authorization: Bearer <token-not-real>
{
"family_id": 1,
"student_id": 1,
"amount_cents": 6500,
"currency": "AED",
"method": "bank",
"reference": "DEMO-REF-001",
"items": [{"student_fee_id": 10, "description": "Tuition", "amount_cents": 6500}]
}التغطية
المستودع يسجّل عشرات المسارات تحت /api/v1/admin/* (أشخاص، رسوم، محافظ، مؤسسات، تقارير، رؤى…). الجرد الكامل للربط بالمصدر محفوظ داخليًا في docs/system-portal/internal/ وغير منشور مع هذه الحزمة العامة.
Routes discovered ≈ 100+ registrations including insight summaries