저장소 정보는 아직 수집하지 않았습니다.
아직 감지된 업데이트가 없습니다. GitHub 릴리스가 나오면 여기에 보입니다.
최근 완료된 8시간 회차 사이 GitHub 스타 증가량 순
당신이 사랑하는 배경화면, 맥에서 새롭게 만나보세요
무료 오픈소스 터치스크린으로 USB 설정 가이드, 드래그‑드롭 편집기, 로컬 제어를 제공하며 Home Assistant용으로 제작되었습니다
브라우저에서 카메라 펌웨어를 시험하고 Fujimod SD 부팅 파일을 만든다
TV 리모컨으로 사용하기 최적화된 안드로이드용 간편 웹 브라우저
오픈소스 온라인 가계도 시스템
메이커가 쓴 소개는 위의 한 줄이 전부입니다. 더 자세한 내용은 저장소 README에서 읽을 수 있습니다. 저장소 README ↗
README 전체를 불러오는 중입니다.
README 전문 보기 ↗تطبيق عربي RTL لإدارة ومراقبة منظومة الطاقة الشمسية المنزلية، مبني على Next.js App Router وPrisma/PostgreSQL.
الإنفرتر
↓
Gateway محلي (ESP32 / Raspberry Pi / Wi‑Fi dongle أو جهاز محلي مناسب)
↓ HTTPS + Authorization: Bearer <TELEMETRY_INGEST_TOKEN>
/api/telemetry
↓
Prisma / PostgreSQL
↓
لوحة Solar
Vercel لا يتصل مباشرة بمنفذ USB/RS485 أو COM الموجود داخل المنزل. القراءة الفعلية من الإنفرتر تتم محلياً، والـ Gateway يحوّل القراءات إلى صيغة telemetry الموحدة ويرسلها إلى التطبيق.
المسار المخصص لاستقبال بيانات الـ Gateway هو:
POST /api/telemetry
يجب إرسال:
Authorization: Bearer <TELEMETRY_INGEST_TOKEN>
Content-Type: application/json
مثال payload:
{
"timestamp": "2026-09-29T12:00:00.000Z",
"pv_power": 4200,
"load_power": 3350,
"battery_soc": 78,
"battery_power": 850,
"battery_voltage": 51.2,
"battery_current": 16.6,
"battery_temperature": 28,
"grid_status": false,
"grid_power": 0,
"source": "inverter"
}
في Solar، القيمة الموجبة لـ battery_power وbattery_current تعني الشحن، والقيمة السالبة تعني التفريغ. يجب على الـ Gateway تطبيع إشارة الإنفرتر وفق هذه القاعدة قبل الإرسال.
/api/auth/* و/api/telemetry مستثناة من حماية middleware.verifySessionToken متوافق مع Edge middleware.next التي تبدأ بـ //، ويوجد حد لمحاولات الدخول الفاشلة.Prisma هو مصدر البيانات الأساسي.
المتغير الأساسي هو:
DATABASE_URL
ويتم تطبيق migrations في build production قبل توليد Prisma Client وبناء Next.js:
prisma migrate deploy
node scripts/prisma-generate.mjs
next build
للتطوير:
npm run db:migrate
npm run db:generate
npm run typecheck
npm run lint
npm run build
المجلد prisma/migrations يحتوي migrations الخاصة بالطاقة، إعدادات الإنفرتر، الـ Gateway، الرقم التسلسلي، العملة SYP، وإعدادات Safe Zone.
لا تضع أي secret داخل الواجهة أو متغيرات NEXT_PUBLIC_*.
أضف القيم التالية في Project → Settings → Environment Variables لكل بيئة تريد تشغيلها:
DATABASE_URL — رابط PostgreSQL المستخدم من Prisma. هو المتغير الأساسي؛ لا حاجة إلى PRISMA_DATABASE_URL أو POSTGRES_URL عند ضبطه.SOLAR_AUTH_SECRET — مفتاح عشوائي قوي لتوقيع الجلسات.SOLAR_AUTH_USERNAME مع SOLAR_AUTH_PASSWORD (أو SOLAR_PASSWORD_HASH بدلاً من كلمة المرور)، أو SOLAR_OWNER_USER مع SOLAR_OWNER_PASSWORD.SMARTESS_USERNAME وSMARTESS_PASSWORD وSMARTESS_PN — حساب SmartESS للدنجل؛ يعتمده اتصال الإنفرتر تلقائياً ما لم يُحفظ حساب من صفحة الإعدادات.TELEMETRY_INGEST_TOKEN — مطلوب إذا كان الـ Gateway سيرسل القراءات إلى /api/telemetry.CRON_SECRET — مطلوب إذا كان مجدول خارجي يستدعي /api/telemetry/sync. يجب أن يكون 16 حرفاً على الأقل؛ أرسله في ترويسة Authorization: Bearer <secret>.INVERTER_CONFIG_SECRET — موصى به كمفتاح عشوائي مستقل لتشفير إعدادات الإنفرتر؛ يمكن للتطبيق استخدام AUTH_SECRET عند غيابه.أنشئ قيمة مختلفة لكل مفتاح سري، ولا تستخدم القيم التوضيحية في .env.example. أضف القيم الحساسة إلى Vercel مباشرة ولا ترسلها أو تحفظها في Git. استخدم قاعدة بيانات منفصلة لبيئة Preview إذا كانت مفعلة.
متغيرات اختيارية بحسب التكامل:
SOLAR_SESSION_EPOCH — غيّره لإبطال كل الجلسات الحالية.SOLAR_GATEWAY_URL وSOLAR_GATEWAY_TOKEN — قيم احتياطية لاتصال الـ Gateway عند عدم حفظها في إعدادات التطبيق.SOLAR_DESSMONITOR_URL — عنوان SmartESS/DESSMonitor بديل عند الحاجة.ضع قيمة TELEMETRY_INGEST_TOKEN نفسها في الـ Gateway تحت SOLAR_TELEMETRY_TOKEN. لا تضبط SOLAR_MOCK_INVERTER=true في Production.
الـ Gateway هو المكان الصحيح لتعريف بروتوكول الإنفرتر:
voltronic_pi30: بروتوكول QPI/PI30 لإنفرترات Axpert/MPP/MAST المتوافقة.modbus_generic: Modbus RTU/TCP فقط عندما يكون Register Profile الخاص بالموديل معروفاً وموثوقاً.لا يتم اعتبار نتيجة discovery الرقمية دليلاً على أن Register Map موثقة من الشركة المصنعة.
/api/telemetry.