CoreLink یک محصول واحد با چند مرز پیادهسازی است: قراردادهای عمومی، runtime، SDKها، مستندات و ابزارها با یک مدل maturity مشترک تکامل پیدا میکنند.
Developer Documentation · API Contracts · Product Website · Repository Maturity
CoreLink هنوز یک انتشار Stable v1 نیست. مرز عمومی فعلی بهصورت شفاف محدود است:
- API Contracts: Alpha، با baseline فعلی
1.0.0-draftبرای Device و Command و canonical event envelope. - TypeScript SDK: Prerelease Alpha.
- Python SDK: Prerelease Alpha.
- Java SDK / CLI / Mock Server / MCP Server: Scaffold · Planned.
- Core runtime: foundation پیادهسازیشده دارد، اما تکمیل engineering foundation بهتنهایی معادل پذیرش محصول یا انتشار Stable نیست.
موجودی کامل maturity ریپوها مرجع این خلاصه است.
CoreLink برای ساخت محصولات متصل طراحی شده است: دستگاه و integration در مرز زیرساخت جذب میشوند و applicationها با شناسهها، قراردادها و رفتارهای CoreLink-owned کار میکنند.
جهت محصول شامل device lifecycle، commands، telemetry/state، events، integrations و تجربههای white-label است؛ اما هر مورد فقط وقتی «قابلیت پشتیبانی شده» محسوب میشود که contract، runtime، مستندات و release evidence همان maturity را تأیید کنند.
| منبع | وضعیت | کاربرد فعلی |
|---|---|---|
| Developer docs | Alpha | مستندات نسخهدار و quickstart مبتنی بر contract |
| API contracts | Alpha · 1.0.0-draft |
مرز عمومی Device + Command و event envelope |
| TypeScript SDK | Prerelease Alpha | کلاینت generated؛ هنوز release پایدار نیست |
| Python SDK | Prerelease Alpha | کلاینت generated؛ هنوز release پایدار نیست |
| Java SDK | Scaffold · Planned | مسیر توسعه آینده؛ package پشتیبانیشده ندارد |
| CLI | Scaffold · Planned | ابزار برنامهریزیشده؛ installable release ندارد |
| Mock Server | Scaffold · Planned | شبیهساز برنامهریزیشده |
| MCP Server | Scaffold · Planned | سطح agent/MCP برنامهریزیشده |
برای integration جدید، قرارداد عمومی منبع حقیقت است؛ نه ساختار provider یا جزئیات داخلی runtime.
- شناسه عمومی دستگاه:
corelink_device_id; - tenant scope در مسیرهای عمومی صریح است;
- authentication فعلی قرارداد عمومی: Bearer JWT;
- Command create نیازمند
Idempotency-Keyاست; - provider/connector identifiers جزئیات پیادهسازیاند.
Quickstart و referenceهای نسخهدار در
developer-docs قرار
دارند.
Product hierarchy، milestone gates و تصمیمهای cross-repository در
product-planning
مدیریت میشوند. هر repository فقط implementation/evidence مرز خودش را نگه
میدارد.
وضعیت یک repository را از public بودن، تعداد فایلها یا وجود یک scaffold نتیجه نمیگیریم. واژگان مشترک maturity عبارتاند از Scaffold, Experimental, Alpha, Beta, Stable, Deprecated, Planned.
- آسیبپذیری امنیتی را طبق Security Policy گزارش کنید.
- تغییرات کد و مستندات باید Contribution Guide را رعایت کنند.
- Issueهای اجرایی از organization Issue forms استفاده میکنند و به Product Epic مربوط لینک میشوند.
- وضعیت محصول یا package را قبل از استفاده production از repository مالک و maturity inventory بررسی کنید.
CoreLink Platform · one product, explicit maturity, evidence before claims.