ماژول فنی روز و شب در زیرساخت متاورس رنگ

۱. زمان‌بندی پیشنهادی

فرض اولیه: محیط کلاینت Unity آماده است. کارهای اصلی باقی‌مانده شامل تعریف قرارداد JSON، اتصال به Node.js و تست عملکرد مالک و بازدیدکننده است.

زمان‌بندی پیشنهادی برای تکمیل ماژول به شرح زیر است:

• ۰٫۵ روز: تعریف قرارداد daynight.json و تعیین مسیر دایرکتوری محیط.
• ۱ روز: جایگزینی سیستم ذخیره‌سازی PlayerPrefs با ارتباط GET/PUT به Node.js.
• ۰٫۵ تا ۱ روز: اتصال تشخیص مالک از طریق API و اجرای ApplyState برای همه کاربران.
• ۰٫۵ روز: تست عملکرد مالک و بازدیدکننده و بهینه‌سازی سیستم.

مجموع زمان پیشنهادی: ۲ تا ۳ روز کاری، مشروط به آماده بودن Endpointهای موردنیاز Node.js.

۲. نقش ماژول

این ماژول وظیفه کنترل نور جهت‌دار خورشید، شدت نور محیطی (Ambient) و در صورت وجود، دیسک خورشید قابل‌مشاهده را بر عهده دارد.

داده‌های مربوط به نور به محیط تعلق دارند، نه به کاربر. تنها مالک محیط مجاز است تنظیمات نور را تغییر دهد و ذخیره کند. هر کاربری که وارد همان محیط شود، وضعیت نور ذخیره‌شده را مشاهده خواهد کرد.

۳. تشخیص مالک (Owner)

تشخیص مالک از طریق API بیرونی انجام می‌شود و این مسئولیت بر عهده خود ماژول نیست.

پس از ورود کاربر به محیط، وضعیت مالکیت مشخص می‌شود:

• اگر IsEnvironmentOwner = true باشد، کاربر مجاز به تغییر تنظیمات نور و ذخیره آن‌ها است.
• اگر IsEnvironmentOwner = false باشد، کاربر فقط می‌تواند وضعیت نور را مشاهده کند و تنظیمات ذخیره‌شده از طریق ApplyState روی محیط اعمال می‌شوند؛ امکان تغییر و ذخیره‌سازی برای او وجود ندارد.

۴. ذخیره‌سازی (مدل کارفرما)

روش پیشنهادی ذخیره‌سازی، استفاده از Node.js به همراه یک فایل JSON در دایرکتوری اختصاصی همان محیط است.

هدف این روش، جلوگیری از ایجاد میکروسرویس سنگین و فراهم کردن امکان خواندن سریع اطلاعات از دیسک است.

نمونه محتوای فایل:

{
  "version": 1,
  "environmentId": "building_12",
  "time01": 0.35,
  "cycleRunning": true,
  "updatedAt": "2026-10-17T00:00:00Z",
  "updatedBy": "owner_user_id"
}

معنای فیلدهای فایل به شرح زیر است:

time01 : موقعیت در چرخه روز و شب، در بازه صفر تا یک.

cycleRunning: مشخص می‌کند چرخه خودکار روشن است یا خاموش.

version: نسخه اطلاعات، برای سازگاری‌های آینده.

environmentId: شناسه محیط یا ساختمان.

updatedBy: شناسه مالکی که آخرین بار تنظیمات را ذخیره کرده است.

updatedAt: زمان آخرین به‌روزرسانی اطلاعات.

۵. فرایند اجرا

فرایند اجرای ماژول به ترتیب زیر انجام می‌شود:

۱. کاربر وارد محیط می‌شود.

۲. API برای تشخیص مالک بودن کاربر فراخوانی می‌شود.

۳. Node.js فایل daynight.json مربوط به همان محیط را از طریق درخواست GET می‌خواند.

۴. کلاینت Unity با اجرای ApplyState، وضعیت نور را اعمال می‌کند.

۵. اگر مالک تنظیمات را تغییر دهد، اطلاعات جدید از طریق درخواست PUT در همان فایل ذخیره می‌شوند.

۶. کاربر بعدی هنگام ورود، همان فایل JSON را دریافت می‌کند و وضعیت نور یکسانی را مشاهده خواهد کرد.

۶. بهینه‌سازی

برای بهینه‌سازی عملکرد ماژول، موارد زیر در نظر گرفته شده‌اند:

• از اجرای Find در هر فریم جلوگیری شود.
• اطلاعات هنگام ورود کاربر به محیط یک‌بار خوانده شوند.
• ذخیره‌سازی فقط زمانی انجام شود که مالک تنظیمات را تغییر داده باشد.
• رابط سیستم ذخیره‌سازی به‌گونه‌ای طراحی شود که در آینده امکان جایگزینی روش فعلی با ارتباط HTTP به Node.js وجود داشته باشد.
• در مرحله فعلی، PlayerPrefs به‌صورت موقت برای تست استفاده می‌شود و در ادامه باید با سیستم ذخیره‌سازی مبتنی بر Node.js جایگزین شود.

۷. وضعیت پیاده‌سازی

منطق چرخه، Apply و تشخیص مالک: در کلاینت Unity آماده است.

نمونه ذخیره‌سازی با PlayerPrefs: به‌صورت موقت برای تست موجود است.

اتصال واقعی به JSON از طریق Node.js: باید پیاده‌سازی شود.

API تشخیص مالک محیط: خارج از محدوده این ماژول است و باید از طریق لابی فراخوانی شود.

۸. موارد نیازمند تأیید

برای تکمیل پیاده‌سازی، موارد زیر باید تأیید و نهایی شوند:

• مسیر دقیق دایرکتوری روی سرور برای هر محیط.
• قرارداد نهایی فیلدهای فایل daynight.json .
• Endpointهای Node.js برای خواندن و نوشتن فایل از طریق GET/PUT.
• نام دقیق API تشخیص مالک محیط.