📚 Sənədləşmə

1C inteqrasiya bələdçisi və API reference

🚀 Başlanğıc

cfe.mcp.az — 1C:Enterprise CFE-ləri üçün multi-tenant registry və auto-update platforması. Developer-lər öz CFE-lərini yükləyir, müştəri tərəfdəki 1C bazaları isə manifest oxuyub avtomatik yenilənirlər.

  1. Qeydiyyatdan keç — admin təsdiqini gözlə
  2. Dashboard-da "Yeni CFE" yarat
  3. cfe-starter template-ini endir, öz funksionallığını əlavə et
  4. İlk versiyanı yüklə (admin review olunur)
  5. Sonrakı versiyalar avtomatik publish olur

📦 CFE yaratmaq

Hər CFE üçün slug (URL-də) və name (1C identifier) lazımdır.

⚡ Template məcburi

Hər CFE rəsmi template (cfe-starter) əsasında qurulmalıdır. Template auto-update modulu, ayar forması və log registri ehtiva edir.

📤 Versiya yükləmək

Versiya yükləyəndə backend avtomatik olaraq:

  • .cfe extension yoxlanır
  • SHA256 hesablanır
  • Template uyğunluğu yoxlanır (MCP_* obyektlər)
  • Versiya unikallığı yoxlanır
  • S3 (MinIO) bucket-ə yüklənir

⚙️ 1C client setup

Hər CFE-nin daxilində ayar forması olur. İstifadəçi orada email, parol (və ya API key), kanal seçir.

// Yeniləməni yoxla
MCP_ОбновлениеCFE.ПроверитьИYüklə("mas3-claude-update");

// Manifest URL:
// https://cfe.mcp.az/api/v1/cfes/<slug>/manifest

🔌 API reference

POST
/api/v1/auth/login

Email + parol → JWT token (cookie + body)

POST
/api/v1/auth/token

1C client üçün — bearer JWT

GET
/api/v1/cfes/:slug/manifest

Cari versiya manifest (1C client oxuyur)

GET
/api/v1/cfes/:slug/download/:version

CFE binary download

POST
/api/v1/cfes/:slug/versions

Yeni versiya upload (multipart)