توثيق واجهة المنافسات والمورّدين

{
  "data": [
    {
      "id": "uuid",
      "title": "توريد وتركيب أجهزة",
      "summary": "...",
      "organization": "نص الجهة كما ورد في المصدر",
      "reference_number": "...",
      "category": "...",
      "region": "الرياض",
      "city": "الرياض",
      "url": "https://...",
      "publish_date": "2026-09-01",
      "deadline_date": "2026-09-20T12:00:00+00:00",
      "value_amount": 1500000,
      "currency": "SAR",
      "language": "ar",
      "first_seen_at": "2026-09-01T10:00:00Z",
      "last_seen_at": "2026-09-11T10:00:00Z",
      "sources": { "slug": "nupco", "name_ar": "نوبكو", "name_en": "NUPCO", "sector": "government" },
      "organizations": { "name_ar": "...", "website": "https://...", "profile_confidence": 0.8 },
      "tender_awards": [
        {
          "award_date": "2026-08-01",
          "award_amount": 900000,
          "currency": "SAR",
          "confidence": 0.8,
          "evidence_url": "https://...",
          "organizations": { "name_ar": "المورّد", "email": null, "phone": null, "mobile": null }
        }
      ]
    }
  ],
  "pagination": { "page": 1, "page_size": 25, "total": 189, "total_pages": 8 }
}

يعيد نفس حقول المنافسة مضافًا إليها tender_attachments (الاسم والرابط ونوع الملف) وملف الجهة الطارحة كاملًا وبيانات المورّد الفائز إن وُجدت ترسية موثقة.

curl -H "X-API-Key: tnd_live_..." \
  "https://gulf-deal-dig-bot.lovable.app/api/public/tenders/00000000-0000-0000-0000-000000000000"

{
  "data": [
    {
      "id": "uuid",
      "name_ar": "نوبكو",
      "name_en": "NUPCO",
      "is_issuer": true,
      "is_awarded_vendor": false,
      "sector": "government",
      "registration_number": null,
      "website": "https://...",
      "email": null,
      "phone": null,
      "mobile": null,
      "address": null,
      "city": null,
      "region": null,
      "country": "SA",
      "profile_confidence": 0.5,
      "contact_sources": {},
      "evidence_urls": ["https://..."],
      "tender_awards": [],
      "first_seen_at": "2026-09-01T10:00:00Z",
      "last_seen_at": "2026-09-11T10:00:00Z"
    }
  ],
  "pagination": { "page": 1, "page_size": 25, "total": 23, "total_pages": 1 }
}

حقول التواصل (البريد، الجوال، الهاتف، العنوان) تبقى فارغة ما لم تنشرها الجهة أو المورّد علنًا؛ ولا يتم تخمين أي قيمة. evidence_urls يحمل روابط المصدر وprofile_confidence يعبّر عن درجة الثقة في الملف. تظهر المورّدون الفائزون فقط عند وجود اسم فائز ورابط دليل عام صالح؛ وتحتوي tender_awards على ملخص الترسيات المرتبطة بكل مورّد.

يعيد الملف كاملًا مع intelligence المحسوبة من السجلات المرصودة فقط، وقائمة المنافسات التي طرحتها الجهة (issued_tenders) والترسيات التي فازت بها (awards)، حتى 100 عنصر لكل قائمة.

{
  "data": {
    "id": "uuid",
    "name_ar": "...",
    "intelligence": {
      "tenders_posted": 12,
      "awards_won": 3,
      "published_value": 45000000,
      "known_award_value": 12000000,
      "awards_with_value": 2,
      "awards_with_date": 3,
      "awards_with_evidence": 3,
      "basis": "observed_records"
    },
    "issued_tenders": [ { "id": "uuid", "title": "...", "value_amount": 100000 } ],
    "awards": [ {
      "id": "uuid",
      "award_date": "2026-08-01",
      "evidence_url": "https://...",
      "issuer": { "id": "uuid", "name_ar": "..." },
      "tenders": { "id": "uuid", "title": "...", "url": "https://..." }
    } ]
  }
}

قائمة المصادر المهيأة مع القطاع والروابط ونوع الجمع ودورة التحديث بالدقائق وحالة الصحة وآخر تشغيل ناجح وآخر تشغيل أعاد نتائج.

{
  "data": [
    {
      "slug": "nupco",
      "name_ar": "نوبكو",
      "name_en": "NUPCO",
      "sector": "government",
      "site_url": "https://...",
      "tenders_url": "https://...",
      "status": "active",
      "enabled": true,
      "collection_kind": "tenders",
      "cadence_minutes": 360,
      "health_status": "healthy",
      "last_run_at": "2026-09-11T10:00:00Z",
      "last_run_status": "success",
      "last_success_at": "2026-09-11T10:00:00Z",
      "last_nonempty_at": "2026-09-11T10:00:00Z",
      "retry_after": null
    }
  ]
}