عن المشروع

Aetherfield هي منصة ذكاء استدامة B2B تساعد الشركات على تتبع ونمذجة والإبلاغ عن بيانات الانبعاثات والعمل عليها. تعالج الفجوة بين بيانات ESG المتناثرة واليدوية والرؤية التشغيلية من خلال تحويل الاستدامة من تمرين إبلاغ سنوي إلى ممارسة مستمرة. يحتوي المستودع على كل من موقع تسويقي مُسبق العرض والمنصة الموثقة في تطبيق Next.js واحد مع بنية App Router ولا توجد خدمة خلفية منفصلة. تشمل الميزات الرئيسية: - **الموقع التسويقي**: سبعة مسارات عامة (الصفحة الرئيسية، المجلة، المقالات، الوظائف، قوائم الوظائف، حول، نظام التصميم) مع محتوى كأنواع ثابتة. مسارات كتابة عامة لطلبات العرض التوضيحي، والاشتراك في النشرة الإخبارية بتأكيد مزدوج، وطلبات الوظائف مع تحميل السيرة الذاتية الخاص، جميعها محدودة المعدل ومحمية من الروبوتات. - **المنصة**: منظمات متعددة المستأجرين مع عضوية ودعوات، واستيراد نشاط CSV مع صفوف مرحلية، ومجموعات عوامل انبعاثات منشورة ومقدمة من العملاء (مزروعة DEFRA 2025/2026)، واختيار عوامل فعالة حسب التاريخ، ومحرك حساب النطاق 1/2/3 (النطاق 2 القائم على الموقع والقائم على السوق)، وتتبع الأهداف مع التوقعات، وتقارير ESG مولدة، وثلاث وظائف cron ليلية لإعادة الحساب وتنبيهات العتبة وعمليات التطهير الاحتفاظ. - **تكامل الذكاء الاصطناعي**: وحدة واحدة تصوغ نثرًا سرديًا لتقارير ESG عبر بوابة Vercel AI. لا ينتج LLM أرقامًا أبدًا؛ جميع الحسابات حتمية في دوال نقية. تُفحص السرديات المولدة رمزًا برمز مقابل قائمة مسموح بها مغلقة من الأرقام المحسوبة، وتُهمل المسودات التي تفشل في الفحص. تُرسل فقط أقسام التقارير المعروضة والمقربة إلى المزود. **حزمة التقنية**: Next.js 16.2.12 (App Router، Turbopack)، React 19.2.4، TypeScript 5، Tailwind CSS 4 (بدون إعداد)، Neon Postgres مع node-postgres، Drizzle ORM، Better Auth (مستضاف ذاتيًا)، Resend + React Email، Upstash Redis لتحديد المعدل، Vercel Blob (خاص)، حماية الروبوتات BotID، تحقق Zod، GSAP و Motion للرسوم المتحركة، AI SDK، Vitest و Playwright للاختبار. **البنية**: متعددة الطبقات مع UI، وServer Actions (مسار الطفرات الوحيد)، وRoute Handlers (للمتصلين الخارجيين فقط)، وطبقة البيانات (lib/db)، وطبقة المجال (دوال نقية). لا يقوم UI بالطفرات أبدًا عبر Route Handlers؛ كل طفرة تُصرح وتتحقق من صحتها على الخادم. تتبع النماذج العامة مسارًا ثابتًا: تحقق العميل، فحص BotID، تحديد المعدل، تحقق Zod على الخادم، التفويض، كتابة قاعدة البيانات، وإشعار البريد الإلكتروني (الفشل لا يفشل الكتابة أبدًا). **البدء**: يتطلب Node.js 20+، وقاعدة بيانات Neon Postgres (سلاسل اتصال مجمعة ومباشرة)، واختياريًا Vercel CLI. يتضمن الإعداد نسخ .env.example، وتشغيل الترحيلات، وزرع عوامل التحويل. لا يوجد وضع قاعدة بيانات محلية. **الاختبار**: Vitest مقصور على lib/domain (دوال نقية فقط). يغطي Playwright Chromium وFirefox وWebKit ضد بناء إنتاجي، مع WebKit في حاوية Podman بدون جذر لإعادة الإنتاجية. **معالجة البيانات الشخصية**: تُخزن السير الذاتية في تخزين blob خاص مع روابط موقعة، ونشرة إخبارية بتأكيد مزدوج، ولا تسجيل لأجسام الطلبات أو رسائل البريد الإلكتروني أو السير الذاتية، واحتفاظ محدود مع تطهير ليلي، وحذف حقيقي للمنظمة. **النشر**: Vercel Fluid Compute مع بيئة تشغيل Node.js. ثلاث وظائف cron ليلية معلنة في vercel.json. من المتوقع بدء تشغيل بارد لـ Neon scale-to-zero. **التوثيق**: AGENTS.md هو عقد المساهمين؛ docs/ يحتوي على سجلات بناء لكل سطح؛ prompts/ يحمل مطالبات التنفيذ المرقمة التي بنت المستودع.