أثر · Athar AI

منصّة عربية تتعلّم صوت الكاتب من محتواه، ثم تكتب به.

الحلقة: ارفع مصادرك → تُستخرج «بصمة المحتوى» (Content DNA) → تُولَّد بوستات بصوتك → تُراجَع وتُجدوَل وتُنشر فعليًا → يُقرأ أداؤها الحقيقي ويعود ليغذّي البصمة. هذه الحلقة الأخيرة هي الفرق بين مولّد نصوص ونظام يتحسّن مع الوقت.

Next.js 16 · TypeScript · Postgres + pgvector عبر Drizzle · Supabase Auth · Stripe · عربي/إنجليزي بتكافؤ تامّ واتجاهين (RTL/LTR).

التشغيل محليًا

npm ci
cp .env.example .env.local     # ثم املأ DATABASE_URL ومفاتيح المزوّدين
npm run db:migrate
npm run dev

بلا DATABASE_URL يقلع التطبيق ويعمل، وتتعطّل الميزات التي تحتاج قاعدة بيانات بدل أن ينهار.

الأوامر

الأمر	ماذا يفعل
npm run dev · build · start	التطوير والبناء والتشغيل
npm run lint	ESLint — ومعه قاعدة العزل (ADR-005)
npm test	كامل الاختبارات؛ ما يحتاج قاعدة بيانات يُتخطّى إن غابت
npm run db:generate · db:migrate	توليد الهجرات وتطبيقها
npm run db:status [-- --deep]	ما يقوله سجلّ الهجرات — و--deep يسأل المخطط نفسه
npm run db:baseline -- --through <tag>	إصلاح سجلّ انحرف عن المخطط
npm run db:rls-check	هل عزل الصفوف مُفعَّل فعلًا؟ يسأل القاعدة لا الكود
npm run eval	تقييم الاسترجاع

ثلاث قواعد يحرسها الكود لا العرف

1. كل وصول لبيانات المستأجرين يمرّ بـ forOrg(db, orgId) (ADR-005). قاعدة ESLint تمنع الالتفاف، وقائمة الاستثناءات موثّقة ويحرسها اختبار. تحتها عزل صفوف في القاعدة نفسها (ADR-011): استعلام ينسى نطاقه يعيد صفر صفوف لا بيانات مستأجر آخر.
2. ملفّا الترجمة متكافئان مفتاحًا بمفتاح. next-intl لا يُفشل البناء على مفتاح ناقص — يعرض مسار المفتاح للمستخدم. اختبار يمنع ذلك.
3. لا رقم مُختلَق في الواجهة. ما لا تعطيه المنصّة يبقى «غير متاح»، لا صفرًا. وتحليل لا تسنده بيانات كافية لا يُعرض أصلًا، وتُذكر كم بوستًا ينقص.

الوثائق

ابدأ من docs/README.md — فهرس يفصل ما يصف الكود اليوم عن السجلّات التاريخية. أقصر مسار:

• docs/ARCHITECTURE.md — ما هو مبنيّ وكيف
• docs/DECISIONS.md — لماذا (ADR-000 … ADR-013)
• docs/LAUNCH_READINESS.md — ما تبقّى قبل أول عميل يدفع
• docs/ADMIN_RUNBOOK.md — النشر والهجرات والنسخ الاحتياطي

النشر

cPanel/Passenger خلف Cloudflare. scripts/deploy-cpanel.sh يطبّق الهجرات قبل تنصيب الإصدار، فهجرة فاشلة تُجهض النشر والإصدار السابق يبقى يخدم. التفاصيل والأخطاء المعروفة في docs/ADMIN_RUNBOOK.md.