سُلالة | SULALAH

منصة عربية لبناء شجرات العائلات والقبائل كشجرة مرسومة حيّة: الجذع هو الجد، كل أب غصن، وأبناؤه أوراق بأسمائهم. الضغط على غصن يحرّك الكاميرا إليه، والإضافة الجديدة تنمو ورقةً من موضعها الصحيح وتنتظر الاعتماد.

البنية

المسار	الدور
apps/web	تطبيق Next.js: الصفحات، Server Actions، Webhooks
packages/tree-engine	محرك الشجرة: النسب، تخطيط 2D حتمي (جذع، أغصان، أوراق)، الكاميرا السينمائية (TypeScript خالص)
packages/tree-svg	مشهد <LivingTree> بـ SVG: الأغصان والأوراق والحركة واللمس
packages/domain	قواعد الصلاحيات can()، البحث العربي، الباقات، مخططات Zod
supabase	قاعدة البيانات: المايغريشن، سياسات RLS، الدوال، واختبارات الصلاحيات
packages/ui	نظام التصميم
legacy/aghsan	النموذج الأولي السابق، للمرجعية فقط ولا يُبنى

التفاصيل في docs/ARCHITECTURE.md.

التشغيل

pnpm install
cp .env.example apps/web/.env.local
pnpm dev        # http://localhost:3000
pnpm test       # اختبارات المحرك والصلاحيات
pnpm typecheck
pnpm db:test    # سياسات قاعدة البيانات على أي Postgres (DATABASE_URL)

يتطلب Node 22 و pnpm 10. بدون مفاتيح Supabase يعمل التطبيق كنسخة تجريبية في المتصفح؛ ومعها يسجّل الدخول بالجوال ويحفظ الأشجار مشفّرة. البيئات الثلاث (محلي، تجربة، إنتاج) في docs/ENVIRONMENTS.md. الاشتراكات والدفع ورموز الدخول في docs/BILLING.md.