Hazır uygulama şablonları
İstediğiniz iş aşağıdaki kalıplardan birine benziyorsa uygulama boş iskeletten değil, şablondan üretilir. Şablon; veri modelini, sunucu kurallarını, ekranları (hazır bileşenlerle), Excel aktarımını, Devoplus yapay zekası araçlarını ve rehberini, testleri, README'yi ve AGENTS.md'yi hazır getirir ve yayın kapılarından geçer. Yapılacak iş şablonu ihtiyacınıza göre değiştirmektir. Baştan yazmak hem yavaştır hem de şablonun koruduğu kuralları (eksi stok, sunucuda hesaplanan puan ve tarih, durum akışı, kişisel verinin silinmesi) kaybettirir.
Hangi şablon
Şablonlar Devoplus Portal'ın zaten sunduğu işleri tekrar etmez. Rezervasyon, anket, onay akışı ya da destek talebi için Portal'ın Rezervasyon, Anket ve Destek Talep Formu modülleri ile Devoplus İş Akışı vardır; bunlar için yeni uygulama yazmadan önce o modüllere bakın. Yine de ayrı bir uygulama gerekiyorsa boş iskeletten başlanır.
| Şablon | İhtiyacınız şöyleyse | İçinde gelenler |
|---|---|---|
bakim-takvimi | "Cihazların bakımını takip edelim", "bakım zamanı gelince sorumluya hatırlatılsın" | Ekipman kaydı (konum, sorumlu, bakım aralığı), bakım kaydı ve fotoğraf ya da dosya eki, sunucuda hesaplanan sıradaki bakım tarihi, gecikenler listesi, yaklaşan ve geciken bakım için sorumluya sabah e-postası (günde bir kez), Excel |
saha-denetimi | "Mağaza denetimi yapalım", "kontrol listesiyle puanlayalım" | Kontrol listesi (bölüm, ağırlık, kritik madde), iş yeri seçimi (organizasyon şemasından), madde başına uygun, uygun değil ya da uygulanamaz + not + fotoğraf, sunucuda hesaplanan ağırlıklı puan (uygun olmayan kritik madde sonucu başarısız yapar), tamamlanınca değişmeyen denetim, yazdırılabilir rapor, yerlere göre pano, Excel |
egitim-sertifika | "Eğitim ve sertifikaların süresini takip edelim", "süresi dolmadan haber versin" | Sertifika türleri (geçerlilik süresi), kişi başına kayıt ve belge eki, sunucuda hesaplanan geçerlilik sonu, "Sertifikalarım" ve "Ekibim" (yönetici, organizasyon şemasından), süresi 30 gün içinde dolacaklar için kişiye ve yöneticisine sabah e-postası, Excel |
ziyaretci-kaydi | "Resepsiyonda ziyaretçileri kaydedelim", "ziyaretçi gelince çalışana haber verilsin" | Ziyaretçi kaydı (ad, firma, amaç, ziyaret edilen çalışan), sunucunun yazdığı giriş ve çıkış saati, ziyaret edilen çalışana bildirim, "Bugünkü ziyaretçiler" ve "Ziyaretçilerim", günün Excel'i, 90 gün sonra kişisel bilgileri silen gece işi (telefon ve kimlik numarası toplanmaz) |
uygunsuzluk-dof | "Kalite ya da iş güvenliği uygunsuzluklarını kaydedelim", "düzeltici faaliyetleri takip edelim" | Uygunsuzluk kaydı (kaynak, önem, dosya), kök neden, sorumlu ve terminli düzeltici faaliyetler, sunucuda zorlanan durum akışı (açık, faaliyet planlandı, doğrulama, kapandı; açık faaliyetle kapanmaz), "Faaliyetlerim", geciken faaliyet için sorumluya sabah e-postası, Excel |
musteri-ziyaret | "Saha ekibinin müşteri ziyaretlerini raporlayalım" | Ziyaret kaydı (tür, not, sonuç, sonraki adım ve tarihi), "Ziyaretlerim", "Ekip ziyaretleri" (yönetici, organizasyon şemasından sunucuda), yaklaşan sonraki adımlar, Excel; müşteri listesi ERP'den DEXA ile okunur, sorgu bağlanana kadar müşteri elle girilir ve ekran bunu söyler |
hedef-takibi | "Ekip hedeflerini ve ilerlemeyi takip edelim", "çeyreklik hedefler" | Dönemler, hedefler (sorumlu, ağırlık), ölçülebilir sonuçlar ve aksiyonlar, sunucuda hesaplanan ilerleme, değer güncellemesinin geçmişi, "Hedeflerim", "Ekip panosu", grafikli dönem panosu, kapanan dönemin salt okunur olması, Excel |
envanter | "Stok, malzeme ya da demirbaş takibi", "azalınca haber versin" | Kalemler, giriş, çıkış ve sayım hareketleri (stok eksiye düşmez), en az miktar uyarısı (sorumluya e-posta), konuma göre grafik, sabah stok kontrolü |
blank | Hiçbiri uymuyor | Kişisel notlar örnekli en küçük iskelet |
Seçerken:
- Bir şeyin belli aralıklarla yapılması (bakım, kontrol, yenileme) gerekiyorsa
bakim-takvimi; süresi dolan bir belge kişiye bağlıysaegitim-sertifika. - Bir yeri bir listeye göre kontrol edip puanlamak için
saha-denetimi; bulunan bir sorunun çözülmesini izlemek içinuygunsuzluk-dof. İkisi birlikte gerekiyorsa (denetimde çıkan sorun faaliyete dönüşsün) baskın olan seçilir ve ötekinin kuralı şablona eklenir; iki şablon birleştirilmez. - Kurum dışından gelen kişiyi kaydetmek için
ziyaretci-kaydi; müşteriyle yapılan görüşmeyi kaydetmek içinmusteri-ziyaret. - Hedef, ölçü ve ilerleme konuşuluyorsa
hedef-takibi; sayı ya da miktar tutup azalıp çoğalanı izlemek içinenvanter. - Birinin onayı gerekiyorsa onay akışı uygulamaya yazılmaz: onay Devoplus İş Akışı'nın işidir. Uygulama yalnız kaydı tutar.
Şablonu genellikle yapay zeka aracınız sizin anlattıklarınızdan seçer ve size iş diliyle doğrulatır ("bakım takvimi uygulamasıyla başlayıp sizin alanlarınızı ekleyeceğim").
Şablondan üretme
Şablondan uygulama iskelet üreticiyle (create-devoplus-one-app) üretilir: npm create devoplus-one-app -- <dizin> --template <şablon> --slug <kısa ad> --owner <sahibin e-postası>. Komutu yapay zeka aracınız da çalıştırabilir. Seçenekler: --template <şablon>, --slug <kısa ad>, --owner <sahibin e-postası>, --name "<Türkçe ad>", --name-en "<İngilizce ad>"; --list-templates şablonları kısa özetleriyle listeler. --template verilmezse boş iskelet (blank) üretilir.
Komut kararlı sürümü (latest) kullanır; @next yalnız test kanalı içindir (sınırlar). ⛔ Adı benzeyen ama Devoplus'a ait olmayan paketler vardır; yalnız create-devoplus-one-app'i kullanın.
Üretimden sonra ne değişir
- Uygulamanın kökündeki
AGENTS.mdyapay zeka aracınızın uyduğu kurallardır; en üstte şablona özgü bölüm (dosya haritası ve bozulmaması gereken kurallar) vardır (uygulama kuralları). - İhtiyacınıza göre değişenler:
- Alanlar ve seçenekler:
one.data.json, ardındanpnpm data:generate. Veritabanı değişikliği dosyaları ve tipler elle yazılmaz (veri modeli). Seçenek listelerini ilk yayından önce netleştirin. - Kurallar (süre, eşik, puan, durum akışı, saklama süresi): şablonun kural dosyası (
schedule.ts,score.ts,certificate.ts,visitor.ts,capa.ts,visit.ts,progress.tsya dastock.ts) ve yanındaki test. - Ekran metinleri:
src/shell.ts(Türkçe ve İngilizce birlikte). - Devoplus yapay zekası: manifest
agent.tools,src/agent.tsveAGENT_GUIDE.mdüçü birlikte (yapay zeka). - README: kullanıcılarınız için; şablonun "Neleri değiştirebilirsiniz" bölümü uygulamaya göre güncellenir.
- Alanlar ve seçenekler:
- Gereken izinler erişim talebiyle istenir: kayıt, kurulum, şablonun beyan ettiği yetki alanları (
orgschema.read,mail.execute; ziyaretçi kaydındapush.execute) ve uygulama içi rolün (One.<Uygulama>.Manage) bir kullanıcı grubuna atanması. Sabah e-postası gönderen şablonlarda kurulumda arka plan işi servisi olarak e-postanın da onaylanması gerekir (zamanlanmış görev). pnpm test,pnpm type-checkvepnpm buildgeçtikten sonra yayın.
Bilinmesi gerekenler
- Zamanlanmış işler kullanıcısızdır ve Devoplus servislerini uygulamanın kimliğiyle çağırır. Sabah e-postası gönderen şablonlar (
bakim-takvimi,egitim-sertifika,uygunsuzluk-dof) e-postayı manifesttejobs.servicesiçinde beyan eder; kurulumda portal yöneticisi onaylamadıysa iş e-postayı göndermez, "onay gerekiyor" diye kaydeder ve ertesi gün yeniden dener (zamanlanmış görev). Bir çağrıda gönderilen e-posta sayısı sınırlıdır; şablonlar kişi başına tek e-postayı birkaç kişiyle sınırlar, kalanlar ertesi güne kalır. - Hatırlatmalar günde bir kez gider: şablon önce damga koyar, gönderim düşerse damgayı geri alır.
- Şablonlar bir şeyi yazmadan önce denetliyorsa (kaydın durumu, kişinin sorumluluğu, üst kaydın silinmemiş olması) o denetim yazımla aynı veritabanı ifadesinde de durur: aynı anda gelen iki istek birbirinin koşulunu bozamaz. Üretilen
AGENTS.mdbu kuralı uygulamayı genişleten yapay zeka aracına da yazar. musteri-ziyaretERP sorgu anahtarını içermez; anahtar ve kolon adları portalın DEXA sorgu listesinden (one dexa queries) seçilir, uygun sorgu yoksa yeni sorgu talep edilir; sonraAGENTS.md'deki adımlarla bağlanır (manifestdexa.read,services.dexa.queryKeys, sorgu erişim talebi).- Devoplus yapay zekası araçları yalnız uygulamanın kendi veritabanını okur; kayıt açan, onaylayan ya da silen araç şablonlarda bilinçli olarak yoktur.
- Menü sekmeleri herkese görünür; yetkisi olmayan kişi yönetim sekmelerinde bir bilgi notu görür. Asıl kapı her uçta sunucudadır.
- E-posta, kullanıcının Portal'daki "İzinleri incele" onayına bağlıdır; onay yoksa işlem yapılır ama e-posta gitmez ve ekran bunu söyler.