Mind’i kullanma kılavuzu

İlk adımlar

1. Daveti doğrula

   Davet kodun ve e-posta adresinle kaydı başlat. Tek kullanımlık e-posta kodunu gir.

2. Giriş yöntemini seç

   Parolanı koruyabilir; desteklenen cihazda Face ID, Touch ID, Windows Hello veya cihaz kilidiyle çalışan passkey ekleyebilirsin.

3. Kişisel alanını aç

   Collect önce kişisel bağlamda açılır. Kimlik, konum veya belge yalnız ilgili iş akışı gerektiğinde sorulur.

4. Niyetini söyle

   Yaz, ses kullan veya desteklenen bir belge ekle. Önerilen işlemi görmeden hiçbir kritik adım tamamlanmaz.

Niyet nasıl çalışır?

“Kahve almak istiyorum”, “arabamı tamir ettirmek istiyorum” veya “bugün dükkânda neye bakmalıyım?” gibi doğal bir cümleyle başlarsın. Collect, cümleyi tek bir cevaba indirgemez; kişi, yer, zaman, varlık ve aktif bağlamı ayırır.

Aynı kişi, ayrı bağlamlar

Kişisel kullanıcı, aile üyesi, işletme sahibi ve çalışan olmak ayrı hesaplar açmak anlamına gelmez. KYC ile doğrulanan tek kişi, yetkisi bulunan bağlamlara geçer. Her bağlamın verisi ve işlem sınırı ayrıdır.

Harita ve işletmeler

Harita, cihaz izni verilirse canlı konumunun çevresindeki işletmeleri harita sağlayıcısından getirir. Dış kaynaktan görülen bir işletme, Collect’e kayıtlı veya doğrulanmış sayılmaz. Kaynak ve güven durumu ayrı gösterilir.

Ailem

Aile alanı, özel verileri topluca açmaz. Her bilgi kendi paylaşım amacıyla eklenir. Ortak eksik listesi, görevler, takvim, uygun envanter alanları ve FlowPoints aynı aile bağlamında çalışabilir.

• Bir öğeyi kimin eklediği ve kimin tamamladığı görünür.
• Görev bir kişiye atanabilir ve tamamlanma kanıtı tutulabilir.
• Özel kişisel alanlar aileye varsayılan olarak açılmaz.
• Ortak avantajın kaynağı ve dağılımı şeffaf gösterilir.

İşletmem

İşletme hesabı bir harita yerini seçmekle başlar; sahiplik ise belge eşleşmesi ve inceleme tamamlanınca doğar. Onaydan sonra rolüne uygun operasyon yüzeyi açılır.

Çalışan deneyimi

Çalışan, sahibi olduğu bir işletme panelini değil; işletmenin kendisine verdiği görev ve yetkileri görür. Örneğin bir barista siparişi kabul eder, hazırlamaya alır, hazırlar ve teslim kanıtını tamamlar; işletme finansına ancak ayrıca yetkilendirildiyse erişebilir.

KYC, KYB ve varlıklar

Bu kayıtlar aynı şey değildir. KYC tek kişinin kimliğini; KYB işletmenin tüzel ve operasyonel gerçekliğini; varlık kaydı ise araç, mülk veya başka bir varlıkla olan bağını kanıtlar.

İzinler ve gizlilik

Kimlik ve işletme belgeleri herkese açık olmaz. İnceleme yüzeyleri rol kapısındadır. Normal kullanıcılar geliştirici araçlarını, iç sistem adlarını, kaynak dosyalarını, sunucu yollarını, anahtarları veya operasyon günlüklerini göremez.

Güven durumları

Collect

Collect, Mind’in açık öğrenme ve kontrollü katkı alanıdır. Bir kişi şirkete veya üretim koduna doğrudan “developer” olarak girmez. Önce ürünü kullanan ve başkalarının doğru kullanmasına yardım eden supporter olur; gerçek katkısı, güvenilirliği ve yetkinliği kanıtlandıkça daha sınırlı görevler atanır.

Collect ile geliştirme

Geliştiriciler de normal bir Collect kimliğine sahiptir ve Collect içinde supporter geçmişinden gelir. Teknik yüzey ancak doğrulanmış yetkinlik ve atanmış iş kapsamıyla açılır. Üretim sistemi kaynak kodunu veya sırlarını tarayıcıya vermez. Bir geliştirme doğrudan canlıya çıkmaz.

Bir niyet nasıl ürüne dönüşür?

Bir özellik, Collect’e yeni bir menü ekleyerek değil; doğrulanabilir bir yetenek sözleşmesi sağlayarak katılır. Yürütücü, isteği aktif kimlik ve bağlamla eşleştirir; izin planını hazırlar; onaydan sonra uygun yeteneği çağırır; yalnız güvenli sonuç tariflerini arayüze taşır.

Değişmez kurallar

• Bir model gerçek fiyatı, stoğu, kimliği, sahipliği veya işlem sonucunu uyduramaz.
• Durum değiştiren her adım görünür insan onayı ister.
• Aynı işlem anahtarıyla tekrar gelen aynı komut ikinci bir sonuç üretmez.
• Bir yetenek yalnız beyan ettiği veri kapsamını ve rolü kullanabilir.
• Arayüz sonucu ham HTML değil, izinli ve doğrulanan bileşen tariflerinden oluşur.
• Her sonuç bir iz, korelasyon ve varsa kanıt referansı taşır.

Yetenek ekleme

Aşağıdaki örnek, kolektif geliştirmenin genel sözleşmesini gösterir. Üretim adresi, erişim anahtarı veya gizli altyapı bilgisi içermez. Adlar örnektir; gerçek bir yetenek, kayıtlı kapsam ve analist onayı olmadan keşfedilebilir hale gelmez.

import { defineAdapter } from '@mind/adapter-sdk';

export const adapter = defineAdapter({
  manifest: {
    moduleId: 'collective.example',
    version: '1.0.0',
    displayName: 'Ortak liste işlemleri',
    transport: 'in-process',
    healthEndpoint: '/health',
    capabilities: ['collective.list.add'],
    requiredScopes: ['collective.write'],
    dataClassification: 'sensitive',
    timeoutMs: 5000,
    retryPolicy: { maxAttempts: 2, idempotentOnly: true },
    availability: 'role_gated',
    inputSchema: { type: 'object' },
    outputSchema: { type: 'object' }
  },
  capabilityScopes: {
    'collective.list.add': ['collective.write']
  },
  idempotentActions: ['collective.list.add'],
  handlers: {
    async 'collective.list.add'({ params, principal, idempotencyKey }) {
      const item = await listService.add({
        householdId: params.householdId,
        label: params.label,
        actorId: principal.userId,
        idempotencyKey
      });
      return {
        data: { item },
        proofRefs: [item.proofId],
        ui: [{ type: 'text', text: 'Ortak liste güncellendi.' }],
        nextActions: []
      };
    }
  }
});

Minimum test sözleşmesi

Kolektif katkı, kontrollü yayın

Mind’in nihai hedefi, dünyanın farklı ticaret pratiklerini ortak ve taşınabilir sözleşmelerle bir araya getirmektir. Kılavuz herkese açıktır; canlı kullanıcı verisi, üretim erişimi ve yayın yetkisi herkese açık değildir.

Kapalı beta ilkeleri

• Bir ekranın görünmesi, arkasındaki işlemin tamamlandığı anlamına gelmez.
• Gerçek veri yoksa sayı, menü, sahiplik, doğrulama veya başarı uydurulmaz.
• Beta dışındaki paketler satış sözü yerine “Gelince haber ver” olarak gösterilir.
• Her kritik işlem izin, rol, tekrar çalıştırma ve kanıt kontrolünden geçer.
• Yeni sektörler, aynı uçtan uca kabul zinciri doğrulandıktan sonra açılır.

Sık sorulanlar