LOADING...

Texniki sənədləşmə və şəffaflıq

< Bütün mövzular
Çap

Ağıllı evdə ən çox qiymətləndirilməyən hissə — sənəddir.
Amma məhz sənəd olmayan sistemlər illər sonra problemə çevrilir.

Şəffaflıq dizaynla yox, sənədlə ölçülür.


Texniki sənədləşmə nədir?

Bu, PDF və ya qovluq deyil.
Bu, sistemin başqasına izah edilə bilməsidir.

Texniki sənədləşmə cavab verir:

  • sistem necə qurulub
  • hansı məntiq üzrə işləyir
  • hansı hissə nəyə cavabdehdir
  • dəyişiklik necə edilir

Əgər bunlar yazılmayıbsa — sistem yalnız bir nəfərin başındadır.


Sənəd olmayan sistemin problemi

Belə sistemlərdə:

  • dəyişiklik qorxulu olur
  • başqa mütəxəssis sistemi başa düşmür
  • servis bir nəfərə bağlanır
  • istifadəçi nəzarəti itirir

Bu vəziyyət bir gün mütləq üzə çıxır.


Şəffaflıq nə deməkdir?

Şəffaf sistem:

  • gizli qaydalar saxlamır
  • istifadəçidən məlumat gizlətmir
  • nə baş verdiyini izah edə bilir

Əgər sistem:

  • “belə işləyir” deyə izah olunursa
  • amma niyə belə işlədiyi bilinmirsə

orada şəffaflıq yoxdur.


Nələr sənədləşdirilməlidir?

Minimum səviyyədə bunlar olmalıdır:

  • ümumi arxitektura təsviri
  • əsas funksiyaların loji̇kası
  • rejimlərin davranışı
  • istisna halların reaksiyası
  • giriş və səlahiyyət bölgüsü

Bu sənədlər:

  • istifadəçini qoruyur
  • sistemi gələcəyə hazırlayır

“Bu sənədlər lazımsızdır” yanlışdır

Bu fikir adətən belə səslənir:

“Onsuz da biz baxacağıq”

Amma:

  • insanlar dəyişir
  • şirkətlər bağlanır
  • texnologiya yenilənir

Sənəd qalır.


Şəffaflıq nəyə xidmət edir?

Şəffaflıq:

  • etibar yaradır
  • səhvləri azaldır
  • qərar verməni asanlaşdırır
  • istifadəçini gücləndirir

Gizli sistem rahat görünə bilər.
Amma uzunmüddətdə risklidir.


Seçim zamanı verilməli suallar

  • Bu sistemin sənədi varmı?
  • Başqa mütəxəssis bunu başa düşərmi?
  • Loji̇ka izah edilə bilirmi?
  • Dəyişiklik necə edilir?
  • Bu məlumatlar mənə veriləcəkmi?

Bu suallara “sonra baxarıq” deyilibsə — risk var.


Nəticə

Ağıllı ev:

  • kabeldən
  • tətbiqdən
  • cihazdan əvvəl

sənədlə başlayır.

Sənəd olmayan sistem:

  • sürətli qurulur
  • amma yavaş-yavaş problemə çevrilir

Şəffaf sistem isə:

  • sakit işləyir
  • sahibini qoruyur
  • gələcəyə açıq qalır
Başlıq