okulcom-api — Okul İçerik Türleri (Announcement, Achievement, Events)

Proje: Okul Platform · Hub: Okul Platform — Domain

Announcement (Duyuru)

Sistem duyuruları: Okul.com platformu tarafından yayınlanan genel duyurular.

• type — Duyuru tipi
• starts_on / ends_on — Geçerlilik dönemi
• show_homepage — Ana sayfada göster
• is_active — Aktif mi
• Medya: MediaRoleIdType::ANNOUNCEMENT_CONTENT

Okul duyuruları (SchoolAnnouncement): Okul sahiplerinin okul sayfasına eklediği duyurular. B2B portal: CRUD /customer/school-content/announcements

SchoolContentType

app/Enums/SchoolContentType.php — İçerik türleri (announcement, achievement, event)

SchoolAchievementGrant (Başarı/Burs İstatistikleri)

Okul YKS/LGS başarı verileri:

• grant_rate — Burs oranı (%)
• highest/lowest_point — En yüksek/düşük puan
• highest/lowest_point_percentile — Yüzdelik dilim
• year — Yıl

B2B portal: CRUD /customer/school-content/achievements Admin: Admin\SchoolContent\

Events (Etkinlikler)

Okul etkinlikleri. CalendarEvent ile ilişkili. B2B portal: CRUD /customer/school-content/events

Announcement + School İlişkisi

school_announcements pivot — Okul sayfasında gösterilecek platform duyuruları. School::announcements() — BelongsToMany

Pivot kolonları: school_id, announcement_type, show_home_page. announcement_type her zaman announcements.type ile senkron tutulmalı — aksi halde okul profilinde yanlış kategoride görünür. Pivot yazımı için SchoolContentRepository::attachSchoolContentSchools() / syncSchoolContentSchools() kullan, doğrudan ->attach/sync($ids) kullanma. Bkz. 2026-04-20-api-school-content-pivot-sync.

General API (Herkese Açık)

GET /school-content/announcements?homepage=1  → Ana sayfa duyuruları
GET /school-content/announcements
GET /school-content/achievements
GET /school-content/events

Related

• api-content-modules — Makale ve diğer içerik modülleri
• api-media-system — Duyuru görselleri (MediaRoleIdType)
• api-b2b-customer-portal — B2B içerik yönetimi