فهرست مستندات

چشم‌انداز محصول#

الامر متاورسی متمرکز نیست که یک تیم آن را یک‌جا بسازد؛ شبکه‌ای باز از محیط‌های سه‌بعدی مستقل در وب است که یک قرارداد کوچک و پایدار پلتفرم آن‌ها را به هم متصل می‌کند.

این پلتفرم به توسعه‌دهندگان امکان می‌دهد محیط‌ها، اپ‌ها و پلاگین‌ها را بسازند، با هم ترکیب کنند، بیازمایند، منتشر و پیدا کنند و واردشان شوند. مخاطب اصلی محصول با کمک هوش مصنوعی توسعه می‌دهد؛ بنابراین URLهای عمومی و مرجع، طرح‌واره‌ها، نمونه‌ها، APIها و رابط خط فرمان غیرتعاملی، همگی بخش‌های درجه‌یک محصول‌اند. همین منابع باید برای انسان نیز کامل و قابل استفاده بمانند.

واژگان محصول#

  • محیط (Environment): مقصدی که کاربر وارد آن می‌شود و تجربه‌اش می‌کند.
  • اپ (App): باندل کاربرمحور و مستقلی که AppHost دسکتاپ آن را باز می‌کند؛ از خانه یا در محیط‌های مختلف در دسترس است و نشست محدودشدهٔ خودش را می‌گیرد.
  • پلاگین (Plugin): قابلیتی نسخه‌دار و قابل نصب در یک محیط.
  • آداپتور فرانت‌اند (Frontend adapter): سطح اختیاری یک پکیج برای زمان‌های اجرایی مانند وب ساده، React، Web Components یا React Three Fiber.
  • مولفهٔ بک‌اند (Backend component): قابلیتی اختیاری در لایهٔ داده که یک مجوز کوتاه‌عمر پلاگین (Plugin Grant) از آن محافظت می‌کند.
  • پرتال توسعه‌دهندگان (Developer Portal): بخش عمومی آموزش و کشف، به‌همراه کنسول مدیریتی.
  • رجیستری (Registry): منبع حقیقت کاتالوگ، انتشارها، فرایند انتشار، اعتماد، سازگاری، تنظیمات، نشست‌های زمان اجرا و حضور کاربران.

قاعدهٔ اصلی ثابت است: داخل هر محیط آزادی؛ اتصال به الامر استاندارد است.

چرخهٔ رشد#

  1. توسعه‌دهنده، پروژهٔ آغازگر یک محیط، اپ یا پلاگین را در URL عمومی و پایدار پیدا می‌کند.
  2. دستیار کدنویسی او همان مستندات مرجع و طرح‌واره‌ها را می‌خواند.
  3. رابط خط فرمان alamr ساخت، نصب، اعتبارسنجی، آزمایش و انتشار را انجام می‌دهد.
  4. رجیستری، انتشارهای بررسی‌شده را در کاتالوگ عمومی پرتال توسعه‌دهندگان نمایش می‌دهد.
  5. صفحه‌های عمومی نشان می‌دهند محیط‌ها چگونه اپ‌ها را میزبانی و پلاگین‌ها را ترکیب می‌کنند.

انتشار در کاتالوگ هرگز هاب را ویرایش یا جای‌گذاری سه‌بعدی ایجاد نمی‌کند. landmarkهای هاب همچنان محتوای جداگانه و تألیف‌شدهٔ خود برنامهٔ هاب هستند.