سُلالة | 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.
