尚未检测到更新。GitHub 发布版本后会显示在这里。
按最近已完成的 8 小时观测回合间的 GitHub 星标增量排序
提出一个问题，VoidAccess 便并行搜索 12+ 个 Tor 搜索引擎、GitHub 与安全订阅源，然后返回可供 STIX、MISP 或 Sigma 使用的行动者、钱包、泄露凭证和 IOCs。Open so
AI 翻译
个人 GitHub 账号下公开仓库的所有者可以登录并验证所有权，自行管理介绍，无需管理员批准。
登录并生成验证文件，在 30 分钟内将其提交到此仓库的默认分支。其他分支或分叉仓库中的文件无效。然后在下方检查文件，即可无需管理员批准直接管理项目。请保留文件以维持管理权限。
如需登录，将前往登录页面。登录后请回到此处，再次点击所选的验证按钮。
在项目文件夹中运行 /nomorevibe verify，即可验证所有权并自行管理介绍。
一分钟完成验证制作者的介绍仅有上面的一句话。 更多详情请阅读仓库 README。 仓库 README ↗
正在加载完整 README。
查看完整 README ↗DALSAN İSG Görüntü Analiz Sistemi'nin (RiosenBeq/DALSAN) Vercel'de duran sitesi. İki sayfası var:
| Adres | Ne |
|---|---|
/ | Tanıtım: sistemin ne yaptığı, nasıl çalıştığı, veri güvenliği notu |
/pano | Kişisel hesapla giren uzak izleme ve yönetim panosu: bugünün özeti, son 14 günün eğilimi, kameraların anlık görüntüsü, kanıt fotoğraflı son olaylar, kurulu olduğu bilgisayar ve role göre Müdahale (anons, hoparlör denemesi, olay inceleme) ile Yönetim (teşhis, yeniden başlatma, güncelleme) |
/demo | Aynı pano, örnek verilerle ve girişsiz: tasarımı denetlemek için (aşağıda Demo) |
/demo adresi panoyu örnek bir fabrikanın verisiyle açar: 6 kamera (biri yavaş,
biri yeniden bağlanıyor, biri kopuk), kanıt fotoğraflı 20 olay, son 14 gün,
saatlik dağılım, müdahale ve yönetim geçmişi, kullanıcılar, işlem kaydı ve
üç tesisli Tesisler ekranı (birinde kimlik çakışması örneği). İki adımlı
doğrulama da denenebilir: demoda kod olarak herhangi 6 hane kabul edilir.
Üstteki demo bandından rol (Yönetici / Operatör / İzleyici) ve bağlantı
(Canlı / Haber yok / Kapatıldı) seçilir; anons, hoparlör denemesi, olay
inceleme, teşhis, yeniden başlatma, güncelleme ve hesap işleri birkaç saniyede
sonuçlanır.
Demo gerçek veriye dokunmaz: sayfadaki /api/... istekleri tarayıcıda
public/demo.js tarafından karşılanır, siteye ve fabrikaya hiçbir istek gitmez,
hiçbir şey kaydedilmez (sayfa yenilenince başa döner). Kamera görüntüleri ve
kanıt fotoğrafları tarayıcıda çizilir. /pano adresinde demo.js hiçbir şey
yapmaz. Yönlendirme vercel.json'daki rewrites satırıdır; demoyu kaldırmak
için o satırı ve pano.html'deki demo.js etiketini silmek yeter.
Fabrikadaki program bu siteye düzenli aralıkla (varsayılan 30 sn) kısa, imzalı bir durum özeti, ihlallerin kanıt fotoğrafını ve (Kameralar ekranı açıkken) kameraların anlık görüntüsünü gönderir. Bağlantı yalnız fabrikadan dışarı doğrudur: fabrikada port açılmaz, modeme dokunulmaz. Fabrikadan 90 saniye haber gelmezse pano kırmızıyla "haber yok" der; program kapatılırken son bir "kapatıldı" raporu gönderdiği için bilerek kapatmayı bağlantı kopmasından ayırır.
Komut (anons, yeniden başlatma, güncelleme ...) fabrikaya ancak program sorduğunda
gider; site fabrikaya hiç bağlanmaz. İki depo arasındaki sözleşme DALSAN
docs/19-SITEDEN-YONETIM.md'dir; bu README aynı tabloları site gözünden tekrar
eder.
Panoya artık ortak bir şifreyle değil, kişiye özel hesapla girilir. Her hesabın bir rolü vardır; rol her istekte hesap kaydından okunur. Yetkisi olmayan düğme ekranda gizlenir, istek yine rolle denetlenir.
Rolün neyi yapabileceği ayarlanabilir: kurucu Kullanıcılar → Roller ve
yetkiler'den tek tek açıp kapatır (aşağıdaki tablo varsayılandır). Yetki rolün
içine gömülü değildir; her istekte okunur, değişiklik hemen geçerli olur ve
kimsenin oturumu kapanmaz. Yetki tek yerde yazılıdır: api/_pano.py'deki
YETKILER kataloğu ile EKRAN_YETKISI; varsayılanlar GORUNUM_EN_AZ_ROL ve
KOMUT_EN_AZ_ROL'den türer. public/pano.js aynı katalogdan gider ve
tests/test_yetki.py iki tarafı karşılaştırır: bir ekranı gizleyip ucu açık
bırakmak (ya da tersi) iki tabloyu birden değiştirmeden olmaz. Katalogda
olmayan bir iş hiçbir role açılmaz: varsayılan reddir.
| İş | İzleyici | Operatör | Yönetici |
|---|---|---|---|
| Durum, özet, olaylar, kanıt fotoğrafı, kameraların anlık görüntüsü | var | var | var |
| Kendi şifresini değiştirme, kendi iki adımlı doğrulamasını açma / kapatma | var | var | var |
| Hazır anons, hoparlör denemesi, olay inceleme | var | var | |
| Teşhis, yeniden başlatma, güncelleme | var | ||
| Hesap açma, rol, yeni şifre, girişi kapatma / açma, silme, iki adımı sıfırlama | var | ||
| İşlem kaydını görme | var |
Kullanıcılar → Roller ve yetkiler: rol × yetki kutucukları. Örneğin operatöre teşhis alma yetkisi verilebilir, izleyiciye Müdahale ekranı açılabilir (komut yetkisi vermeden: görür ama gönderemez) ya da bir rolden anons alınabilir.
Kurucu hesap. Site ilk kurulduğunda tek hesap vardır: kullanıcı adı kurucu,
şifresi Vercel'deki PANO_SIFRESI. Kurucu tam yetkilidir, silinemez, düşürülemez;
şifresi yalnız Vercel'de değişir. Yönetici hesaplarına dokunan her işi (yönetici
yapma / düşürme, yöneticiye yeni şifre, kapatma, silme, iki adımı sıfırlama)
yalnız kurucu yapar:
çalınan bir yönetici hesabı kendine kalıcı yetki açamaz. Kimse kendi hesabına
hesap işi yapamaz (rol, yeni şifre, kapatma / açma, silme, iki adımı sıfırlama);
kendi şifresini değiştirmek ve kendi iki adımını açıp kapatmak Sistem
ekranındadır. Kurucuyla girince her
ekranda bir bant çıkar ("... Kullanıcılar ekranından herkese kendi hesabını açın,
sonra Vercel'de PANO_SIFRESI'ni değiştirin."), çünkü ortak şifreyle yapılan işin
sahibi işlem kaydında görünmez.
kurucu + bugünkü PANO_SIFRESI ile girin; Kullanıcılar'dan
kendinize bir Yönetici hesabı açın.PANO_SIFRESI'ni yalnız sizin bildiğiniz yeni bir değerle (en az 16
karakter) değiştirip Redeploy edin: bütün oturumlar düşer, eski ortak
şifre artık hiçbir şey açmaz.Her kişi kendi hesabında açar; açılmamış hesap bugünkü gibi yalnız şifreyle girer (varsayılan kapalı). Açılınca girişte şifreden sonra telefondaki doğrulama uygulamasının 6 haneli kodu sorulur (RFC 6238 TOTP: 30 saniyede bir değişen kod; Google Authenticator, Microsoft Authenticator ve benzerleri). Yöneticilerin açması önerilir.
otpauth:// bağlantısı metin olarak çıkar (QR kod yok). Uygulamada hesap ekleyip anahtarı elle girin (hesap adı DALSAN,
tür zamana dayalı), uygulamanın gösterdiği kodu yazıp Onayla'ya basın.
Kurulum 10 dakika içinde bitmeli; 5 yanlış kodda baştan başlanır. Açmak açık
oturumları düşürmez.PANO_SIFRESI değişince düşer).dalsan:iki_adim:kurucu)
ve o anki PANO_SIFRESI'ne bağlı durur. Bağ, RAPOR_ANAHTARI'nı da içeren bir
HMAC izidir: Redis dökümünü okuyan biri PANO_SIFRESI'ni çevrimdışı deneyemez.
Kurucunun telefonu kaybolursa kurtarma yolu: Vercel'de PANO_SIFRESI'ni
değiştirip Redeploy edin; yeni şifreyle ilk girişte kayıt silinir, kod
sorulmaz (eski şifreye dönmek kaybolan telefonun sırrını geri getirmez).
RAPOR_ANAHTARI değişince de kurucunun iki adımı aynı yolla kapanır.Sır yalnız kurulum cevabında bir kez görünür; başka hiçbir cevaba, işlem
kaydına ya da Vercel günlüğüne girmez. Sözleşme: /api/giris {ad, sifre, kod}
alır; kod gerekiyorsa 401 iki_adim_gerekli, yanlışsa 401 kod_yanlis.
/api/hesap eylemleri: iki_adim_baslat {sifre} (sır ve uri döner),
iki_adim_onayla {kod}, iki_adim_kapat {sifre, kod} (herkes kendi hesabında)
ve iki_adim_sifirla {ad, sifre} (yönetici; öbür hesap işleriyle aynı kurallar).
| Siteye gelir | Ne kadar durur | Siteye gelmez |
|---|---|---|
| Sistem çalışıyor mu, analiz, model, sistem şeridindeki sorunlar, boş disk, bu ayın çalışma oranı (program gönderirse) | 7 gün (her raporda yenilenir) | Kamera ve hoparlör adresleri, fabrikadaki kullanıcı adları ve şifreler |
| Kameraların adı, bölümü, bağlantı durumu, kare hızı | 7 gün | Video kaydı (yalnız tek kareler gelir) |
| Bugünkü ve dünkü ihlal, inceleme bekleyen, aktif kural, saatlik dağılım, son 14 gün | 7 gün | Kural ve kamera ayarları |
| Son 20 olayın adı, yeri, önemi, durumu, zamanı; sistem olayının açıklaması (adres ve dosya yolu çıkarılmış) | 7 gün | Takip numarası, olayın ayrıntı kaydı |
| İhlallerin kanıt fotoğrafı (en çok 960 px, ihlal başına bir kez) | 7 gün, en çok 60 fotoğraf | |
| Kameraların anlık görüntüsü (640 px, 10 saniyede bir) | 2 dakika; yalnız Kameralar ekranı açıkken gelir | |
| Kurulu olduğu bilgisayar: adı, IP adresi, işletim sistemi, donanım | 7 gün | Oturum açan kullanıcının adı |
Pano hesapları siteye ait ayrı hesaplardır; şifreleri yalnız geri çevrilemeyen
scrypt özetiyle saklanır (aşağıda Güvenlik). Fabrikanın kendi kullanıcı adları
ve şifreleri siteye hiç gelmez.
Akıcı canlı görüntü bu siteden geçmez. Panodaki anlık görüntü 10 saniyede
bir yenilenir. Akıcı görüntü için fabrika ağına VPN ya da Tailscale ile
bağlanılır (DALSAN docs/15-UZAKTAN-ERISIM.md §4.1). O adres FABRIKA_ADRESI
olarak yazılırsa panoda "Fabrika ekranını aç" düğmesi çıkar.
Fabrika içi kullanım (operatör kararı 24.10.2026). Pano fabrikanın kendi kullanımı içindir; görüntünün siteye gelmesi bu kararla açıldı. Bilinmesi gerekenler: Vercel ve Upstash'in sunucuları yurt dışındadır; görüntüler yalnız hesabıyla giren kişiye gösterilir ve yukarıdaki sürelerin sonunda kendiliğinden silinir. Program tarafında uzak pano varsayılan olarak kapalıdır; açmak fabrikanın kararıdır.
Pano, fabrikaya hiç gitmeyen birinin bir dakikada okuyacağı biçimde kuruldu. Yurt dışındaki benzer ürünlerin yönetici ekranlarına bakıldı: Intenseye'ın Global View'u tesis başına eğilimi ve tehlike türlerini, Protex AI alan ve vardiya karşılaştırmasını, Voxel risk eğilimini, Visionify (G2) günlük ve haftalık eğilimle "incelenen" sayısını öne koyuyor. İş güvenliği ölçümü üzerine yazılanlar da yöneticiye az ve güvenilir gösterge vermeyi, eğilimi haftadan haftaya karşılaştırmayı öneriyor (NSC, EcoOnline).
Buradan alınanlar, sade haliyle:
Bilerek alınmayan: ürünlerin "güvenlik puanı". O puanın formülü her üreticide farklı ve gizli; uydurulmuş bir puan yerine her sayı gerçek bir sayımdır.
Panonun Müdahale (operatör ve üstü) ve Yönetim (yönetici) ekranlarından sayılı iş istenebilir. Hepsi aşağıdaki tabloyla sınırlıdır:
| Komut | Ekran | En az rol | Ne yapar | Onay |
|---|---|---|---|---|
Anons (anons) | Müdahale | Operatör | Anons sayfasındaki hazır bir mesajı seçilen kanaldan ya da "Tüm fabrika"dan çaldırır | Onay kutusu |
Hoparlör denemesi (ses_dene) | Müdahale | Operatör | Bir kanaldan deneme sesi verir | Çift dokunuş |
Olay inceleme (olay_incele) | Olaylar | Operatör | Son rapordaki bir ihlali İncelendi ya da Yanlış alarm işaretler | Çift dokunuş |
Teşhis (teshis) | Yönetim | Yönetici | Programdan tek seferlik durum metni ister (adres ve dosya yolu süzülür) | Tek dokunuş |
Yeniden başlat (yeniden_baslat) | Yönetim | Yönetici | Programı yeniden başlatır (1-3 dakika kameralar izlenmez) | Kendi şifresi |
Güncelle (guncelle) | Yönetim | Yönetici | GitHub'daki resmi son sürüme günceller (önce veritabanı yedeklenir, açılmazsa eski sürüme dönülür) | Kendi şifresi |
Hâlâ yapılamayanlar (sözleşme §0). Serbest metin okutma; kural, kamera, bölge ya da ayar değiştirme; fabrikada keyfi komut ya da betik çalıştırma; dosya yükleme; GitHub'daki resmi depo dışından kod ya da paket kurma; siteden fabrikaya bağlanma. Yeni bir iş eklemek ayrı karardır.
Nasıl yürür:
/api/komut'a imzalı ve o soruya
özgü bir nonce taşıyan istek gönderip komutu alır, yürütür ve sonucunu
bildirir. Cevap da imzalıdır ve aynı nonce'u taşır: eski bir cevap yeniden
oynatılamaz. Ekran kapalıyken program sormaz; ekrana 10 dakika dokunulmazsa
dinleme bekler.İkisi de raporla aynı anahtarla, aynı başlıklarla imzalı POST olarak gelir;
pano onları yalnız oturumla görür (GET /api/foto?olay=ID, GET /api/kare?kamera=ID). Site JPEG olmayan içeriği (FF D8 FF ile başlamayan)
ve sınırı aşanı depoya hiç yazmaz.
POST /api/foto, gövde {surum: 1, olay_id, jpeg: "<base64>"}, en çok 400 KB. Site hangi olayların fotoğrafını tuttuğunu
kendisi bilir ve raporun cevabında söyler: foto.var = raporundaki
olaylardan fotoğrafı sitede zaten olanların kimliği. Fabrika her rapordan
sonra, son_olaylar'daki fotoğraflı ihlallerden foto.var'da olmayanları
gönderir (en yenisi önce, turda en çok 5; genişlik en çok 960 px). Böylece
program yeniden başlasa da fotoğraf iki kez gitmez. Site en çok 60 fotoğraf
tutar, en eskisini siler; fotoğraf 7 gün sonra kendiliğinden silinir.kare.iste: true der. Fabrika o zaman 10 saniyede bir, görüntü veren her
kamera için POST /api/kare gönderir: {surum: 1, kamera_id, jpeg}, en çok
300 KB (640 px önerilir). Cevaptaki iste yanlışa dönünce ya da 60 saniye
boyunca doğru gelmezse bırakır. Görüntü 2 dakikada silinir; ekrana 10
dakika dokunulmazsa pano istemeyi bırakır.Raporun cevabı: {tamam, alindi, komut: {hizli}, kare: {iste}, foto: {var: []}}.
Cevapta foto ya da kare yoksa site eskidir: fabrika görüntü göndermemelidir.
Tesis taşıyan raporda ana tesisin cevabına filo: {ana: true} eklenir; öbür
tesisin cevabı yalnız {tamam, alindi, filo: {ana: false}}'dır.
Tek fabrika varsa hiçbir şey yapmanız gerekmez: program tesis alanını
göndermez, site bugünkü gibi çalışır. İkinci bir fabrika eklenince:
UZAK_PANO_TESIS_ID, ör. gebze, izmir: küçük
harf, rakam, - ve _, en çok 32 karakter). Program raporuna
"tesis": {"id": "gebze", "ad": "Gebze fabrikası"} ekler. Kimliği bozuk
rapor 400 ile reddedilir; program hatayı Ayarlar sayfasında gösterir. Önce
mevcut fabrikaya kimlik verin, sonra yenisini bağlayın. Her fabrika
farklı bir kimlik kullanmalı: bir bilgisayarın .env dosyasını öbürüne
kopyalarsanız kimliği değiştirin. Aynı kimliği gönderen iki bilgisayar sitede
tek tesis sayılır ve ikisi de ana olur: ikisi de komut alır, panoyu sırayla
ezer, Tesisler ekranında tek satır görünür. Site bunu yakalar: tesis
özeti raporun bilgisayarını (kurulum adı · bilgisayar adı) taşır; önceki rapor
hâlâ canlıyken (panoyla aynı bağlantı kuralı) başka bir bilgisayardan rapor
gelirse Tesisler ekranının üstünde "Aynı tesis kimliği iki bilgisayardan
geliyor: gebze (Gebze fabrikası · DALSAN-PC, Gebze fabrikası · ISG-PC-02). Her
bilgisayara farklı UZAK_PANO_TESIS_ID yazın." uyarısı ve satırda "Kimlik
çakışması" rozeti çıkar. İki bilgisayar göndermeyi sürdürdükçe uyarı tazelenir;
biri susunca yaklaşık bir saatte kendiliğinden kalkar. Bilgisayar bilgisi
göndermeyen (eski) programda karşılaştırma yapılmaz.ANA_TESIS (ör. gebze) yazılıysa ana tesis odur; Türkçe harf de
yazılabilir (İzmir kimlik olarak izmir okunur). Kimlik olamayan bir değer
(ör. boşluklu İzmir fabrikası) yok sayılır ve Tesisler ekranı uyarır.
ANA_TESIS yazılı değilse ilk rapor veren tesis ana olur; ana tesis 7 gün
hiç rapor göndermezse sıradaki tesis devralır.
Komut alan her zaman tek fabrikadır: tesis kimliği yazılmamış (eski) bir
program canlı rapor gönderdiği sürece hiçbir tesis ana olmaz. ANA_TESIS
yazılı olsa da, bir tesis daha önce ana olmuş olsa da komutları ve panoyu
eski program alır, tesisler yalnız izlenir ve Tesisler ekranı uyarır. Eski
program susunca ya da kapanınca ana tesis geri döner; kimliksiz yeniden
başlarsa yine bırakır.{"filo": {"ana": false}}
taşır (komut, kare, foto yok): program komut sormaz, anlık görüntü ve
kanıt fotoğrafı göndermez. Komut sorusu taşıyıp ana tesisten
gelmiyorsa site imzalı ama boş bir cevap verir; kuyruktan hiçbir şey çekilmez.Ana tesisi değiştirmek için Vercel'de ANA_TESIS'e tesisin kimliğini yazıp
yeniden yayınlayın (Settings → Environment Variables, yalnız Production,
sonra Redeploy). Ayar sonradan silinirse o tesis ana kalır. Değiştirmeden
önce Müdahale ve Yönetim ekranında bekleyen komut olmasın: bekleyen komut 2
dakika içinde yeni ana tesise gidebilir (sonra kendiliğinden düşer).
Karışık kurulumdan kaçının: birden çok fabrikada her programa farklı bir tesis kimliği yazın. Kimliksiz program her zaman bugünkü gibi komut alır; canlıyken hiçbir tesis komut almaz.
Depoda: dalsan:tesis:<id> (tesis başına küçük özet, 7 gün), dalsan:tesisler
(dizin, en çok 50 tesis), dalsan:ana_tesis (ana tesis; onun her raporunda 7
güne tazelenir), dalsan:tesis_cakisma:<id> (kimlik çakışması: iki bilgisayarın
adı ve zamanı, 1 saat).
Pano açık olmasa da fabrika bilgisayarı kapanır, program durur ya da internet
uzun süre giderse site seçtiğiniz kişilere bir kez e-posta bildirimi
gönderir. Bağlantı geri gelince (ilk taze rapor) işaret sıfırlanır ve
bir sonraki kesintide yeniden uyarır. Kesinti 24 saatten uzun sürerse günde bir
hatırlatma gider. Ana pano ve izlenen her tesis ayrı işaret taşır; aynı fabrika
iki kez sayılmaz. ANA_TESIS değişmişse ve pano hâlâ eski ana tesisin son
raporunu gösteriyorsa uyarı susan yeni ana tesisi adıyla anar.
Bekçi GET /api/bekci adresidir ve kendiliğinden çalışmaz: bir zamanlayıcı
çağırır (aşağıda). Ayarlar yoksa hiçbir şey yapmaz; hepsi isteğe bağlıdır ve
eksik ayar listesine girmez.
| Ad | Not |
|---|---|
BEKCI | acik (ya da açık) yazılmadıkça bekçi çalışmaz ({"atlandi": true} döner). Tanınmayan bir değer (ör. evet) bekçiyi açmaz; /api/bekci onu 503 bekci_ayari ile bildirir |
BEKCI_ESIK_DK | Kaç dakika haber gelmezse uyarsın; varsayılan 20 (1-1440). Dalgalı internette uzun tutun |
BEKCI_ALICILAR | Virgülle ayrık e-posta adresleri; en çok 20 |
CRON_SECRET | Vercel Cron'un gizli değeri, en az 16 karakter. Vercel onu Authorization: Bearer başlığıyla kendisi yollar |
BEKCI_ANAHTARI | Dış izleme servisinin gizli anahtarı, en az 16 karakter |
SMTP_SUNUCU, SMTP_PORT | E-posta sunucusu. Port 465 ise doğrudan TLS, başka port (varsayılan 587) ise STARTTLS; şifresiz bağlantıyla gönderilmez |
SMTP_KULLANICI, SMTP_SIFRESI | SMTP girişi |
SMTP_KIMDEN | Gönderen adresi (boşsa SMTP_KULLANICI) |
Hepsini yalnız Production'a ekleyin ve yeniden yayınlayın.
Telegram bildirimi sahibin isteğiyle 01.11.2026'da kaldırıldı: BEKCI_ALICILAR'da
kalan tg: girdileri yok sayılır (e-postalar yine gider; /api/bekci cevabı ve
Tesisler ekranı bunu uyarır), TELEGRAM_BOT ve TELEGRAM_SOHBET artık okunmaz.
Kim çağırır?
vercel.json /api/bekci'yi her gün bir kez, 05:00 UTC
(08:00 Türkiye) saatinde çağırır (Hobby'de o saatin içinde herhangi bir
dakikada). Hobby planı günde birden sık cron kabul etmez (daha sık bir
zaman yazılırsa yayın başarısız olur); Hobby'de bu yalnız günlük bir
denetimdir. CRON_SECRET'ı tanımlayın: Vercel onu her çağrıda başlıkta yollar.
Pro planda vercel.json'daki zamanı "*/5 * * * *" yapın (5 dakikada bir).https://<projeniz>.vercel.app/api/bekci adresini 5 dakikada bir çağırsın.
Başlık eklenebiliyorsa onu kullanın: ?anahtar= adresi servisin ve Vercel'in
günlüklerine düşebilir. CRON_SECRET adreste kabul edilmez.
Authorization: Bearer <BEKCI_ANAHTARI>.?anahtar=<BEKCI_ANAHTARI> ekleyin. Site HEAD'i GET gibi cevaplar
(aynı durum kodu, gövdesiz).Cevap: {uyarildi, gonderilen, durum: [{ad, baglanti, gecikme_dk, bayat}]};
BEKCI_ALICILAR'da yok sayılan bir tg: girdisi varsa uyarilar (düz metin) da
gelir. Bir hedef eşikten uzun süredir sessizse durum kodu 503, değilse 200:
e-posta kurmasanız da izleme servisi 503'te kendisi alarm verir.
Anahtar yoksa 401, yanlışsa ya da sitede hiç tanımlanmamışsa 403 döner; anahtar
doğru ama BEKCI tanınmayan bir değerse 503 bekci_ayari. Cevapta sır, alıcı
adresi ya da görüntü yoktur.
Bildirim kısa bir metindir: tesisin adı, son rapordan bu yana geçen dakika, son raporun saati (Türkiye) ve neye bakılacağı (bilgisayar açık mı, program çalışıyor mu, internet var mı). Bir alıcıya gidemezse öbürleri yine denenir; hiçbir alıcıya gidemezse işaret bırakılır ve sonraki çağrı yeniden dener. Hata Vercel günlüğüne yalnız türüyle yazılır, alıcı kısmen gizlenir; şifre yazılmaz. Program kapatılıp açılmadıysa (Kapandı) da eşik dolunca uyarır; hiç rapor gelmemiş kurulumda uyarmaz.
Fabrika programı /api/rapor'a JSON gönderir. Site yalnız aşağıdaki alanları
tanır; gerisini atar. Her alan tip ve uzunluk denetiminden geçer.
| Alan | Biçim |
|---|---|
surum, uretildi, aralik_sn, kapanis | 1, ISO zaman, saniye (5-3600), true/false |
kapanis_sebebi | "" / guncelleme / yeniden_baslatma (yalnız kapanış raporunda dolu) |
program | {ad, surum, yapi: {commit (7-40 küçük hex ya da boş), tarih (ISO ya da boş), calistirma}} |
sistem | {analiz, hazir, model, uyari_garantisi, sorunlar[], bos_disk_gb, calisma_suresi_sn} |
kameralar[] | {id, ad, bolum, durum, okunan_fps, islenen_fps, hedef_fps, yavas, son_kare_yasi_sn} (id anlık görüntünün anahtarı) |
sayilar | {bugun_ihlal, dun_ihlal, bekleyen, aktif_kural, kamera_toplam, kamera_canli} |
saatlik | bugünün 24 saati, ihlal sayısı |
ogeler[] | son 7 günün ihlal türleri {ad, sayi} |
son_olaylar[] | {id, zaman, tur, baslik, yer, onem, onem_adi, durum_adi, durum, suruyor, sure, ayrinti} (id kanıt fotoğrafının anahtarı; ayrinti sistem olayının açıklaması, en çok 300 karakter, adres ve dosya yolu çıkarılmış; durum = new / reviewed / false_alarm) |
mudahale | {acik, isler, mesajlar[{id, metin}], kanallar[{id, ad, bolum}]}; isler ⊆ (anons, ses_dene, olay_incele) |
yonetim | {acik, isler, kurulum, yeniden_baslatma: {mumkun, sebep}, guncelleme: {mumkun, sebep}}; isler ⊆ (teshis, yeniden_baslat, guncelle), kurulum = paket / git / diger |
gunluk | son 14 günün ihlal sayısı, en eskisi başta, sonuncusu bugün (Türkiye günü) |
yedi_gun |
bilgisayar.ad, kurulumun okunur adıdır ("Gebze fabrikası"); fabrika
programında elle yazılan bir ayardır. son_olaylar[].foto fabrikadan okunmaz:
sitede fotoğrafı olup olmadığını site kendisi yazar.
Eski bir program program.yapi, son_olaylar[].durum, mudahale.isler,
yonetim ve kapanis_sebebi alanlarını göndermez: site o kartları gizler ya da
Yönetim ve inceleme düğmelerini pasif bırakır ("Fabrika programı bu işi bilmiyor;
programı güncelleyin."). Anons ve hoparlör denemesi bugünkü gibi çalışır.
/api/komut)Komut sorusu ve cevabı da raporla aynı anahtarla, aynı başlıklarla imzalanır;
program imzası ya da nonce'u tutmayan cevaptaki komutu yürütmez.
{surum: 1, nonce: "<32 küçük hex>", sonuclar: [<sonuç>...]}. Gövde
en çok 64 KB; site bir istekte en çok 10 sonucu işler.{tamam: true, nonce: "<istekteki>", alinan: ["<id>", ...], komutlar: [<komut>...], hizli}. alinan = sitenin yazdığı ya da zaten bitmiş
bulduğu sonuç kimlikleri (program kalıcı sonuç dosyasını ancak kimlik burada
görününce siler). hizli, fabrikaya "sık sor" demektir.{id, tur, son_gecerlilik, kalan_sn, kim: {ad, rol}} ve türe özgü alanlar (anons → mesaj_id,
kanal_id; ses_dene → kanal_id; olay_incele → olay_id, olay_zaman,
karar; teshis / yeniden_baslat / guncelle → yok).{id: "<16 hex>", durum: "yapildi" | "hata" | "suruyor", mesaj: "<tek satır, en çok 300>", ek: "<yalnız teshis; çok satır, en çok 8192 bayt>"}.
Site mesaj'ı tek satıra indirir; ek'teki denetim karakterlerini atar, kalan
xxx:// adreslerini "(adres)" yapar ve 8192 bayta keser.Eski bir program nonce ve kim göndermez; site boş nonce ile cevap verir ve
program yalnız anons ile ses_dene'yi kabul eder.
İstek tesis (raporla aynı biçim ya da yalnız kimlik) taşıyabilir. Ana tesisten
gelmiyorsa (ya da kimliksiz bir program canlıyken) cevap komutlar: [],
hizli: false, filo: {ana: false} olur: kuyruktan hiçbir şey çekilmez,
gönderilen sonuçlar yine yazılır. tesis yoksa cevap bugünkü gibidir.
Projeyi açın. vercel.com'a GitHub hesabıyla girin:
Add New → Project → RiosenBeq/bot → Import. Ayarlara dokunmadan
Deploy'a basın (Framework Preset "Other" kalır, derleme adımı yoktur).
Veri deposunu bağlayın. Projede Storage sekmesi → Create Database → Upstash (Redis). Bölge olarak Avrupa'yı (Frankfurt) seçin ve bu projeye bağlayın. Bağlarken ortam yalnız Production olsun (Preview ve Development işaretli kalmasın); Vercel bağlantı ayarlarını projeye kendisi ekler.
İki ayarı yazın. Settings → Environment Variables - her ikisini de yalnız Production ortamına ekleyin:
| Ad | Değer |
|---|---|
PANO_SIFRESI | Kurucu hesabının şifresi, en az 10 karakter (öneri: 16). Geçiş sırasından sonra yalnız kurucu girişinde kullanılır |
RAPOR_ANAHTARI | En az 32 karakterlik rastgele anahtar. Pano sayfası, site kurulmamışken bir tane önerir |
FABRIKA_ADRESI | (isteğe bağlı) Fabrika ekranının VPN/Tailscale adresi, ör. http://100.64.0.7:8080 |
Dört ortam değişkeni de (PANO_SIFRESI, RAPOR_ANAHTARI ve Upstash'in iki
değeri) yalnız Production'a bağlı kalmalı: önizleme (Preview) yayınından
fabrikaya komut ve hesap değişikliği gönderilmez (aşağıda önizleme kilidi).
Yeniden yayınlayın. Deployments → son yayının menüsü → Redeploy. Ayarlar ancak yeniden yayından sonra geçerli olur.
Bölgeyi seçin (önerilir). Settings → Functions → Region: Frankfurt
(fra1). İşlevler veri deposuna yakın çalışır.
Panoyu açın: https://<projeniz>.vercel.app/pano. Giriş ekranı gelmeli. Ayar
eksikse sayfa neyin eksik olduğunu yazar. İlk girişte kullanıcı adı kurucu,
şifresi PANO_SIFRESI'dir; sonra yukarıdaki Geçiş sırası'nı uygulayın.
Fabrika programını bağlayın. Programda :
MGET daha yapar. İki adımı açık
hesabın her girişi 2 istek daha yapar (son kullanılan adım okunur, adım
harcanır). Giriş kilit payını ayırıp geri verdiği için başarılı giriş 3
istektir, yanlış giriş 2. Müdahale ya da
Yönetim ekranı açıkken program komutları sormak için /api/komut'a birkaç
saniyede bir uğrar (ekran kapanınca durur).BEKCI=acik rapor başına komut eklemez: "haber yok" işareti raporun
zaten yaptığı okumayla (aynı MGET) okunur; yalnız bir kesintiden sonraki ilk
raporda bir DEL gider. Vercel Hobby en çok 12 işlev (api/*.py) kabul eder;
site 10 kullanır.SET ... GET komutunda okunur);
yalnız çakışma varken ana olmayan tesiste rapor başına 1 istek daha gider. 30 sn aralıkla ana tesis
ayda yaklaşık 860 bin, öbür her tesis 430-520 bin komut. Ana olabilecek
tesisin raporu (ANA_TESIS yazılı değilse her tesis) eski program denetimi
için panonun son durumunu da okur: rapor başına bir rapor boyu veri. Birden
çok tesiste kullandıkça öde planı gerekir.fabrika programı ──(HTTPS POST, imzalı JSON)──> /api/rapor, /api/foto, /api/kare ──> Upstash Redis
fabrika programı ──(imzalı komut sorusu + nonce)──> /api/komut <──(imzalı cevap)── Upstash Redis
tarayıcı ──(kişisel hesapla giriş, oturum çerezi)──> /api/durum, /api/hesap, /api/mudahale, /api/foto, /api/kare <── Upstash Redis
| Dosya | İşi |
|---|---|
api/rapor.py | Fabrikanın raporunu alır: imza ve zaman denetimi, alan süzme, kayıt |
api/giris.py, api/cikis.py | Panoya kişisel hesapla giriş ve çıkış (oturum çerezi, kilitler, iki adımlı doğrulama kodu) |
api/durum.py | Panonun verisi; oturum ister ve rolü uygular (?mudahale=1 operatör+, ?yonetim=1 yönetici, ?kare=1: anlık görüntü istenir) |
api/hesap.py | Hesaplar ve işlem kaydı: yönetici hesap açar / siler / rol verir / iki adımı sıfırlar, herkes kendi şifresini değiştirir ve kendi iki adımlı doğrulamasını açar / kapatır (onay şifresiyle) |
api/foto.py | Kanıt fotoğrafı: fabrikadan imzalı POST, panoya oturumlu GET |
api/kare.py | Anlık görüntü: fabrikadan imzalı POST, panoya oturumlu GET |
api/mudahale.py | Panodan komut (anons, hoparlör denemesi, olay inceleme, teşhis, yeniden başlatma, güncelleme); rol ve onay şifresi |
api/komut.py | Fabrika programının komut yoklaması (imzalı istek + nonce, imzalı cevap) |
api/_pano.py | Ortak çekirdek (adres değildir): imza, depo, hesap, rol, kilit, komut, rapor biçimi |
public/ | Sayfalar: index.html, pano.html, pano.js, pano.css (pano), stil.css (tanıtım ve 404), 404.html; demo.js yalnız /demo'da örnek veri verir |
vercel.json | Güvenlik başlıkları, public/'in yayınlanması, /demo yönlendirmesi |
yerel_sunucu.py | Siteyi Vercel'siz, bu bilgisayarda denemek için |
Yalnız Python'un standart kütüphanesi ve sade HTML/CSS/JS kullanılır: kurulacak
paket, npm, derleme adımı yoktur. Her Vercel işlevi (api/ altındaki adresler)
ayrı bir dosyadır; _pano.py adres değil, ortak parçadır. Yazı tipi (Inter)
siteyle birlikte gelir (CDN yok). Logo DALSAN'ın "Eşik" logosudur (köşeden
bakan kameranın görüş alanı ve eşikteki kişi), ince ayarlı sürümü.
Görünüm: panonun 2. tasarımı (Claude Design, Kasım 2026). Bilgisayarda gri zemin
üstünde kenar çubuğu ve sayfa kartı, telefonda beyaz sayfa, yapışkan cam üst
çubuk ve altta yüzen sekme çubuğu (en az 44 px dokunma alanı, çentik ve alt
çizgi payı). Giriş ekranında solda (telefonda üstte) koyu marka paneli.
Panodaki simgeler bu proje için çizildi ve sayfanın içindedir; tanıtım
sayfasındakiler Lucide'dendir, lisanslar public/LISANSLAR.md.
?mudahale=1, ?yonetim=1 ve ?filo=1 sorgularını elle eklemek
bir şey açmaz.scrypt (yoksa güçlü PBKDF2) özetiyle saklanır; karşılaştırma sabit sürede
yapılır. Kurucunun şifresi (PANO_SIFRESI) yalnız Vercel'dedir.RAPOR_ANAHTARI ile
HMAC-SHA256 imzalanır (başlıklar X-Dalsan-Zaman, X-Dalsan-Imza). İmza
tutmayan ya da saati 5 dakikadan fazla kaymış istek reddedilir; gövde imzadan
önce okunmaz. Komut cevabı programın o soruda gönderdiği nonce'u taşır: eski
bir cevap yeniden oynatılamaz.PANO_SIFRESI'ne bağlı (rapor anahtarlı HMAC izi) ayrı anahtarda durur ve
yalnız kurulum cevabında görünür. Kapatmak şifre ve kod, başkasınınkini
sıfırlamak yönetici onay şifresi ister (yöneticininkini yalnız kurucu).Bir hesap ya da kurucu şifresi çalınırsa: Vercel'de PANO_SIFRESI'ni
değiştirip Redeploy edin (bütün oturumlar düşer); fabrikada Uzaktan yönetim ve
Uzaktan müdahale'yi kapatın; gerekiyorsa RAPOR_ANAHTARI'nı iki tarafta
yenileyin.
| Görülen | Sebep ve çözüm |
|---|---|
| Pano: "Site henüz kurulmadı" | Listedeki ayarları yazın, sonra Redeploy |
| Pano: "Fabrikadan henüz rapor gelmedi" | Fabrika programında Ayarlar → Uzak izleme panosu doldurulmadı ya da sistem yeniden başlatılmadı |
| Pano: "Kullanıcı adı ya da şifre yanlış" | İlk girişte ad kurucu, şifre PANO_SIFRESI; kendi hesabınızı yöneticiniz açar |
| Pano: "Oturumunuz kapandı" | Şifreniz / rolünüz değişti, hesabınız kapatıldı, iki adımınız kapatıldı / sıfırlandı, onay şifresi 15 dakikada 5 kez yanlış girildi ya da kurucu şifresi değişti; yeniden giriş yapın |
| Giriş: "Doğrulama kodu yanlış ya da süresi geçti" | Telefonun tarih ve saatinde "otomatik ayarla"yı açın; aynı kod ikinci kez geçmez, uygulamadaki yeni kodu bekleyin |
| Telefon kayboldu, kod üretilemiyor | Yönetici Kullanıcılar → hesabın ⋯ menüsü → 2 adımı sıfırla (yöneticininkini kurucu); kurucuda Vercel'de PANO_SIFRESI'ni değiştirip Redeploy |
| Tesisler: "Aynı tesis kimliği iki bilgisayardan geliyor" | Bir .env öbür bilgisayara kopyalanmış: bilgisayarlardan birinde UZAK_PANO_TESIS_ID'yi değiştirip programı yeniden başlatın; uyarı yaklaşık bir saatte kalkar |
| Pano: "ÖNİZLEME - fabrikaya komut ve hesap değişikliği gönderilmez" | Önizleme (Preview) adresindesiniz; Vercel'in ana (Production) adresini açın |
| Yönetim: düğme pasif, "Fabrika programı bu işi bilmiyor" | Fabrika programı eski; güncellendiğinde Yönetim işleri açılır (ilk güncelleme fabrikada elle yapılır) |
| Program: "İmza tutmadı" | Programdaki anahtar ile RAPOR_ANAHTARI aynı değil |
| Program: "saati yaklaşık ... saniye geri" | Fabrika bilgisayarının tarih ve saatinde "otomatik ayarla"yı açın |
| Program: "beklenmeyen bir cevap verdi (HTTP 401)" | Önizleme adresi yazılmış; Vercel'in ana (Production) adresini yazın |
| Program: "Siteye ulaşılamadı" | İnternet yok ya da şirket güvenlik duvarı vercel.app adreslerini engelliyor |
| Pano: "Veri deposuna ulaşılamadı" | Storage sekmesinde Upstash bağlantısını kontrol edin; Vercel → Logs |
| Kameralar: "Fabrika programı anlık görüntü göndermiyor" | Programın uzak pano bağlantısı eski; güncellenince kameralar görüntüsüyle çıkar |
docs/15-UZAKTAN-ERISIM.md §4.4).python3 yerel_sunucu.py # http://127.0.0.1:3000 - kurucu şifresi ve anahtar ekrana yazılır
Fabrika programında site adresi olarak http://127.0.0.1:3000 yazılabilir (düz
http yalnız bu bilgisayar için kabul edilir). Yerel sunucu Upstash yerine bellek
kullanır; kapatınca her şey silinir. Yerel sunucuda VERCEL_ENV yoktur, bu
yüzden önizleme kilidi çalışmaz: komut ve hesap işleri açıktır.
Testler ve biçim denetimi:
python3 -m pip install pytest ruff
python3 -m pytest
ruff check . && ruff format --check .
Rapor ve komut biçimi iki depoda birlikte değişir: sitede api/_pano.py
(RAPOR_SURUMU, rapor_temizle), programda backend/app/uzak_pano.py ve
uzak_mudahale.py. İmzanın ve biçimin ortak örnekleri iki deponun
tests/sozlesme/ klasöründe birebir aynıdır (sözleşme DALSAN
docs/19-SITEDEN-YONETIM.md).
tesis/api/durum?filo=1 ile yalnız bu ekran
açıkken istenir. Kütükte tesis yoksa bugünkü fabrika tek satır görünür.
Kimliksiz bir program canlıyken (o komut alan satırdır), ANA_TESIS
geçersizken, aynı kimlik iki bilgisayardan gelirken ya da BEKCI_ALICILAR'da
yok sayılan bir tg: girdisi varken ekranın üstünde bir uyarı çıkar
(filo.uyarilar; çakışan satırda cakisma: {adlar, zaman}).{ihlal, incelenen, yanlis_alarm}: son 7 gün |
yerler[] | son 7 gün, kamera başına {ad, bolum, sayi}, çoktan aza, en çok 10 |
bilgisayar | {ad, bilgisayar_adi, isletim_sistemi, islemci, cekirdek, bellek_gb, ekran_karti, cikarim, disk_toplam_gb, kurulum_turu, kurulum_tarihi, acilis, ip[]} (ip yerel ağdaki adresler, en çok 4) |
tesis | (isteğe bağlı) {id, ad}: id küçük harf, rakam, -, _ (1-32 karakter), ad en çok 80 karakter. Yoksa site tek fabrika gibi davranır; bozuk id 400 alır (yukarıda Birden çok fabrika) |
calisma | (isteğe bağlı) bu ayın çalışma oranı {ay, sistem_yuzde, kamera_yuzde, olculen_saat}: ay YYYY-AA (ör. 2026-11), yüzdeler 0-100 (site bir ondalığa yuvarlar), olculen_saat 0-744 tam sayı. Bir parçası bile bozuksa alan hiç girmez (rapor bugünküyle aynı). Varsa Sistem ekranında her role tek satır: "Bu ay çalışma: %99,6 (kameralar %98,9; 312 saat ölçüldü)" |
https://<projeniz>.vercel.app (Vercel'in verdiği ana adres)RAPOR_ANAHTARI'nın aynısıKaydedin ve sistemi yeniden başlatın. Ayarlar sayfasının aynı bölümünde "Çalışıyor: son durum özeti ... saatinde gönderildi" yazmalı; panoda Sistem çalışıyor görünmeli.
GET /api/hesap denemesi de yetki yetmezse kayda geçer:
çalınan bir izleyici / operatör çerezi bu ucu iz bırakmadan yoklayamaz. Rolü yetmeyen her
deneme (ör. izleyicinin müdahale isteği) de "reddedildi" diye yazılır (hesap
başına dakikada en çok 10 satır). Şifre asla kayda girmez.nonce).image/jpeg ve nosniff ile, yalnız oturumla verilir.HttpOnly, Secure, SameSite=Strict, 12 saat;
imzası PANO_SIFRESI ve RAPOR_ANAHTARI'ndan türer, bu yüzden kurucu şifresi
değişince bütün oturumlar düşer. Rol, hesap kimliği ve oturum sürümü her
istekte kayıtla karşılaştırılır: rolü düşürülen, kapatılan ya da silinen
hesabın oturumu anında biter.noindex, robots.txt).
Veri sayfaya yalnız textContent ile yazılır (CSRF için SameSite=Strict,
köken denetimi ve JSON zorunluluğu).| Kameralar: "Görüntü beklemede" | Ekrana 10 dakikadır dokunulmadı; Sürdür'e basın |
| Olaylar: "Fotoğraf alınamadı" | Fotoğraf sitede silinmiş (7 gün, en çok 60) ya da henüz gelmedi; asılları fabrikadaki bilgisayardadır |