Hatim App hatim.app

Üç uygulama, tek kural kitabı.

Web sitesi, iOS/Android uygulaması ve sunucu aynı çekirdeği kullanır. İş kuralı bir kez yazılır; arayüz de sunucu da onu yeniden yazmaz. Bağımlılık yalnız içe akar ve sınırları ESLint korur.

class MemberAction<A> {
  constructor(
    private readonly ruleFn: MemberRule<A>,
    protected readonly groups: GroupRepository,
    private readonly khatms: KhatmRepository,
    private readonly session: SessionReader,
    private readonly clock: Clock,
  ) {}
  async execute(groupId: string, khatmId: string, arg: A): Promise<Khatm> {
    const user = await signedInUser(this.session);
    // Yönetici de üyelik tablosundadır
    if ((await this.groups.membership(groupId, user.id)) !== "member") throw authRequired("joinGroupFirst");
    const k = await fetchKhatm(this.khatms, groupId, khatmId);
    const updated = this.ruleFn(k, arg, { id: user.id, name: user.name }, this.clock.now());
    if (updated !== k) {
      await this.khatms.save(updated);
      await this.changed(updated, arg, user);
    }
    return updated;
  }
  protected async changed(_k: Khatm, _arg: A, _user: User): Promise<void> {}
}

Kurallar

• 01

  Kural bir kez yazılır

  İş kuralı arayüzde ya da API ucunda yeniden yazılmaz; @hatim/core'a girer, üç taraf oradan kullanır.

• 02

  Bağımlılık içe akar

  domain → application → infrastructure → di → presentation. Arayüz depoya doğrudan bağlanamaz.

• 03

  Çift dokunuşa dayanıklı

  Veritabanı kısıtı, satır kilidi ve Idempotency-Key. Aynı istek ikinci kez gelirse hiçbir şey değişmez.

• 04

  Çekirdek metin üretmez

  Hata bir kod olarak döner, arayüz sözlükten çevirir. Türkçe ve İngilizce tek sözlük, web ve mobil ortak.

• 05

  Aynı ad, aynı iş

  Atomic Design: Button, Sheet, KhatmScreen web'de ve mobilde aynı adla aynı işi yapar.

• 06

  İnternetsiz çalışır

  Kur'an metni ve meal gömülü; web'de service worker gezilen sayfaları saklar.

Teknolojiler

• TypeScript
• Bun
• Next.js 16
• React 19
• Expo SDK 58
• React Native
• Reanimated
• Hono
• PostgreSQL
• Drizzle
• Better Auth
• Firebase (FCM)
• Web Push
• Vitest
• EAS