CoreLink یک محصول واحد با چند مرز پیادهسازی و انتشار است: runtime، Console، Control، قراردادهای عمومی، SDKها، مستندات و ابزارها با یک مدل maturity مشترک تکامل پیدا میکنند.
Developer Documentation · API Contracts · CoreLink Console · Product Website · Repository Maturity
CoreLink هنوز Stable v1 نیست.
- Runtime: Alpha / implemented foundation؛ hosted-alpha و acceptance evidence در حال تکمیل است.
- Console: Alpha؛ سطح tenant/customer/partner/reseller با OIDC/BFF و جریانهای عملیاتی CoreLink-owned.
- Control: Alpha و Private؛ control-plane داخلی برای platform operators، tenants/devices/connections/diagnostics و خارج از قرارداد tenant-facing.
- API Contracts: Alpha، baseline عمومی فعلی
1.0.0-draft. - TypeScript / Python SDKs: Prerelease Alpha با tagged-contract provenance و regeneration CI.
- Java SDK: Experimental · Generated Baseline؛ Java 17+ و generation/build قابل تکرار دارد، اما artifact پشتیبانیشده عمومی هنوز منتشر نشده است.
- CLI / Mock Server / MCP Server: Scaffold · Planned.
موجودی کامل maturity مرجع این خلاصه است.
CoreLink برای ساخت و بهرهبرداری محصولات متصل طراحی شده است. دستگاهها و providerها در مرز زیرساخت جذب میشوند و applicationها با شناسهها، قراردادها و رفتارهای CoreLink-owned کار میکنند.
جهت محصول شامل device lifecycle، commands، telemetry/location/state، events/webhooks، integrations، commercial controls و تجربههای white-label است؛ اما هر مورد فقط وقتی «پشتیبانیشده» محسوب میشود که contract، runtime، documentation و release/acceptance evidence همان maturity را تأیید کنند.
- Console سطح محصول برای tenantها، مشتریان، partnerها و resellerها است و نباید provider credentials/IDs یا جزئیات زیرساخت را به قرارداد عمومی تبدیل کند.
- Control سطح خصوصی و privileged برای تیم CoreLink است. دسترسی tenant بهتنهایی هیچ مجوزی برای Control ایجاد نمیکند.
- Developer Platform از
api-contracts، مستندات نسخهدار، SDKها و ابزارهای پذیرفتهشده تشکیل میشود.
| منبع | وضعیت | کاربرد فعلی |
|---|---|---|
| Developer docs | Alpha | مستندات نسخهدار، quickstart و راهنماهای توسعهدهنده |
| API contracts | Alpha · 1.0.0-draft |
مرز machine-readable عمومی/admin/internal و event schemas |
| Console | Alpha | تجربه hosted SaaS برای tenant/assets/telemetry/alerts/usage/integrations |
| TypeScript SDK | Prerelease Alpha | generated client با provenance/CI؛ هنوز Stable package نیست |
| Python SDK | Prerelease Alpha | generated client با provenance/CI؛ هنوز Stable package نیست |
| Java SDK | Experimental | generated Java 17+ baseline و Blacksmith build؛ هنوز supported artifact ندارد |
| CLI | Scaffold · Planned | installable release ندارد |
| Mock Server | Scaffold · Planned | contract-driven simulation در backlog |
| MCP Server | Scaffold · Planned | سطح MCP امن و tenant-scoped در backlog |
Control عمداً private است و developer/customer entry point عمومی محسوب نمیشود.
برای 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 مرز خودش را نگه میدارد.
واژگان maturity مشترک: Scaffold, Experimental, Alpha, Beta, Stable, Deprecated, Planned.
CoreLink Platform · one product, explicit maturity, evidence before claims.