Deucritic Story — Kullanım & Teknik Doküman

Kullanıcı Kılavuzu

Story Ekleme

1. Giriş yap: Yalnızca kayıtlı kullanıcılar story atabilir.
2. Üst çubuktaki Story Ekle (📷) butonuna tıkla.
3. Kamera açılır ya da galeriden seçim yapılır. Fotoğraf, kısa video veya düz metin eklenebilir.
4. İsteğe bağlı açıklama gir ve Paylaş tuşuna bas.
5. Paylaşılan story 24 saat görünür; süresi dolunca otomatik silinir.

Story Görüntüleme

• Ana sayfanın üst kısmında profil resimleri halkalı biçimde gösterilir.
• Halka tıklanınca story tam ekran modal olarak açılır; sağ/sol kaydırma ile geçiş yapılır.
• İzleme sayısı ve varsa izleyen listesi paylaşanın profilinde gösterilir.

Etkileşimler & Gizlilik

Kullanıcılar story'lere emoji reaksiyonu verebilir. Kısa yorum eklenirse bu yorum paylaşan tarafından görüntülenir; tercihe bağlı olarak yorumların herkese açık olması sağlanabilir.

Teknik Tasarım (Backend)

Aşağıdaki bölümde örnek veritabanı tabloları, endpoint'ler ve cron görevleri özetlenmiştir.

Önerilen Veritabanı - Özet

CREATE TABLE `stories` (
  `id` INT AUTO_INCREMENT PRIMARY KEY,
  `user_id` INT NOT NULL,
  `media_url` VARCHAR(255) DEFAULT NULL,
  `caption` TEXT DEFAULT NULL,
  `mediatype` ENUM('image','video','text') DEFAULT 'image',
  `created_at` DATETIME NOT NULL,
  `expires_at` DATETIME NOT NULL,
  `views_count` INT DEFAULT 0,
  `is_active` TINYINT(1) DEFAULT 1,
  INDEX(user_id),
  CONSTRAINT fk_stories_user FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

Backend Endpoints (örnek)

POST /api/stories/upload
  - auth required
  - form-data: file (image/video), caption
  - response: { success: true, story_id }

GET /api/stories/feed
  - returns active stories for a user + follow list

POST /api/stories/{id}/view
  - records view by current user

POST /api/stories/{id}/react
  - body: { emoji: '🔥' , comment: '...' }

DELETE /api/stories/{id}
  - owner or admin can delete story early

Zamanlanmış Temizlik (Cron)

DB'de expires_at < zaman olan kayıtlar için cron job çalıştırılmalı. Örnek:

0 * * * * php /var/www/deucritic/cron/expire_stories.php

expire_stories.php, süresi dolmuş story'leri is_active=0 yapar ve varsa dosyaları obje depodan siler.