کلاینت وب
Next.js 14 (App Router)، سروررندرشده، احراز هویت SSR-اول، بدون جاوااسکریپت کلاینتیِ غیرضروری.
Next.js 14
Taxonomy Engine · AI Content Pipeline · Real-Time Delivery
پلتفرمِآگاداری
Three Systems Working As One
یک موتور طبقه‌بندی ثابت، یک خط تولید محتوای مبتنی بر عامل‌های هوش مصنوعی، و یک لایهٔ تحویل بلادرنگ — سه سامانه که پیش از نوشتن نخستین صفحهٔ محصول، به‌طور کامل مستند و قفل شدند.
Agadari · In Development
04 — Architecture & Stack
یک Turborepo مونوریپو؛ یک منبع صدق برای هر دو کلاینت.
وب، موبایل و هر نگرانی مشترک — توکن‌های طراحی، فید و کلاینت‌های Supabase — زیر یک مونوریپوی واحد با Turborepo مدیریت می‌شوند.
کلاینت موبایل
Expo (React Native، SDK 51) با Expo Router؛ توکن‌های طراحی و تایپ‌های دامنه را با وب به اشتراک می‌گذارد.
Expo SDK 51
پایگاه‌داده و احراز هویت
Supabase (PostgreSQL 15+)؛ Row-Level Security روی هر جدول؛ پسوند ltree برای سلسله‌مراتب طبقه‌بندی.
Supabase · Postgres
استایل
Tailwind CSS از طریق یک پریست مشترک (@agadari/ui) که سیستم طراحیِ Spatial Minimalism را اجرا می‌کند.
Tailwind CSS
صف پس‌زمینه
صفی بومیِ PostgreSQL (FOR UPDATE SKIP LOCKED) به‌همراه LISTEN/NOTIFY — orchestration عامل‌های هوش مصنوعی و رویدادهای انتشار، بدون بروکر بیرونی.
Postgres Queue
خط تولید هوش مصنوعی
عامل‌های Node.js دیرپا (Railway/Render)، ردیابی‌شده از طریق جدول صف ai_agent_jobs.
AI Pipeline Workers
زبان
TypeScript در همه‌جا، حالت strict، یک tsconfig.base.json مشترک برای کل مونوریپو.
TypeScript Strict
05 — The Taxonomy Matrix
۱۲ دستهٔ اصلی × ۱۲ زیردسته × ۱۲ نیچ = ۱٬۷۲۸ موضوع نشانی‌پذیر.
کل گراف محتوا در یک جدول categories خودارجاع مدل شده — نه سه جدول جدا — با استفاده از پسوند ltree پستگرس برای پرس‌وجوهای نیا/نواده.
پیامد این یک تصمیم معماری است: خواننده‌ای که کل یک دستهٔ اصلی را دنبال می‌کند (مثلاً «سیاست»)، به‌طور خودکار هر نیچ زیر آن را نیز می‌بیند — یک پرس‌وجوی ltree زندهٔ subscribed.path @> news.path، نه فهرستی که دستی نگه‌داری شود.
طرح پایگاه‌داده
supabase/migrations/0001_taxonomy_schema.sql — تعریف جدول خودارجاعِ categories با ستون ltree برای مسیر سلسله‌مراتبی هر موضوع.
پرس‌وجوی فید
supabase/migrations/0010_feed_query_function.sql — تابع پستگرسی که فید هر کاربر را مستقیماً از مسیرهای دنبال‌شده در ltree می‌سازد.
06 — The AI Content Pipeline
پیش از رسیدن به خواننده، هر خبر از چهار عامل می‌گذرد.
عامل‌های خودمختار، خام‌ترین منابع را می‌کاوند، راستی‌آزمایی، ترجمه و در نقشهٔ ۱٬۷۲۸ موضوعی طبقه‌بندی می‌کنند — پیش از آنکه چیزی به فید برسد. هر کار از طریق جدول صف ai_agent_jobs ردیابی می‌شود.
اسکرپر
منابع خام را از سراسر عراق و اقلیم کوردستان جمع‌آوری می‌کند — نخستین گام خط تولید.
راستی‌آزما
هر خبر خام را پیش از عبور به مرحلهٔ بعد، در برابر منابع دیگر راستی‌آزمایی می‌کند.
مترجم
محتوای راستی‌آزمایی‌شده را میان زبان‌های منطقه برمی‌گرداند — بدون از دست دادن ظرافت زمینه‌ای.
دسته‌بند
هر خبر ترجمه‌شده را در نقشهٔ ۱۲×۱۲×۱۲ جای می‌دهد — آمادهٔ رسیدن به هر خواننده‌ای که دقیقاً همان مسیر را دنبال می‌کند.
07 — Core Features & User Journey
یک جریان پیوسته؛ از افتتاحیه تا تنظیمات.
محصول یک جریان پیوسته و نه‌گانه است — نه مجموعه‌ای از صفحات جدا.
افتتاحیه
یک میکرو-تعامل کوتاه از برند، در همان لحظهٔ باز شدن اپ.
آشناسازی
معرفی بصری و کمینه‌گرا به پلتفرم، پیش از ورود.
احراز هویت
موبایل + کد پیامکی، ایمیل + کد، گوگل یا فیسبوک — به‌طور کامل سروررندرشده، بدون منطق احراز هویت در کلاینت.
تنظیم پروفایل
نام، جنسیت، تاریخ تولد و یک هندل الفبا‌عددیِ دائمی و آزادانه‌قابل‌ویرایش.
۱۵ روز آزمایشی نامحدود
هر حساب تازه به‌طور خودکار سطح «Legend» نامحدود می‌گیرد؛ هیچ‌چیز کشف هفتهٔ اول را محدود نمی‌کند.
فید بلادرنگ
سطح اصلی، با چهار حالت نمایش قابل‌تعویض (Pill، Thumbnail، Cover، List)؛ همه از یک تابع پستگرسیِ واحد تغذیه می‌شوند.
کاوش
کل درخت طبقه‌بندی ۱۲×۱۲×۱۲، برای کشف فراتر از دنبال‌شده‌های فعلیِ کاربر.
پروفایل
مرکز شخصی: موضوعات دنبال‌شده، کیف‌پول، و برای تولیدکنندگان محتوا، آمار درآمدزایی.
تنظیمات
اشتراک، اعلان‌ها، زبان و کنترل‌های حساب.
08 — Entitlements As Data
چهار سطح؛ صفر شرط پراکنده در کد.
Free، Pro، Premium و Legend — با یک جدول subscription_tiers و یک تریگر دفاعی پایگاه‌داده اجرا می‌شوند، نه شرط‌های پراکنده در منطق برنامه؛ یعنی حدود اشتراک می‌توانند بدون هیچ استقراری تغییر کنند.
Free
سطح ورودی — دسترسی کامل به فید و نقشهٔ طبقه‌بندی، با محدودیت‌های استاندارد.
Pro
حدود بالاتر برای خوانندگان و تولیدکنندگان محتوای فعال‌تر.
Premium
دسترسی گسترده‌تر، برای بنگاه‌ها و سازمان‌های رسانه‌ای.
Legend
سطح نامحدود — هر حساب تازه به‌مدت ۱۵ روز به‌طور خودکار آن را دریافت می‌کند.