Mentoring szoba

Az ajtófigyelő beállítása az irodai MacBookon

Az ajtón egy Shelly BLU szenzor van, ami Bluetooth-on jelez. A Bluetooth csak kb. 10 méterig ér, ezért a jelet az irodában, az ajtó közelében lévő MacBook fogja, és az interneten át küldi tovább erre az oldalra. Ehhez egyszer kell lefuttatni egy telepítő parancsot a MacBookon.

  • 🚪 Shelly szenzor
  • 💻 irodai MacBook (Bluetooth)
  • 🌐 internet
  • ez az oldal (Mac mini)

1Ami kell hozzá

  • Egy MacBook az irodában, az ajtótól legfeljebb kb. 10 méterre, lehetőleg fal nélkül. Ennek a gépnek bekapcsolva és bejelentkezve kell maradnia.
  • Az oldal nyilvános címe, amit az irodából is el lehet érni (a Mac mini Tailscale Funnel címe, vagyis: https://hestencz-mac-mini.tail018e03.ts.net).
  • A titkos token. Ezt az oldal gazdájától kapod meg. Nem szerepel ezen az oldalon, mert bárki láthatja. A gazda így nézi meg a Mac minin: grep INGEST_TOKEN ~/Exmentoring/.env

Gyorsabb út: add oda Claude-nak

Ha az irodai MacBookon van Claude (Claude Code vagy a Claude asztali app), töltsd le ezt a fájlt, és add oda neki azzal, hogy „állítsd be ezt”. Pontosan leírja, mit kell futtatnia és ellenőriznie. A tokent tőled fogja elkérni, a jelszavas és engedélyes lépéseket pedig neked mondja meg.

Útmutató letöltése Claude-nak (.md)

2A telepítő parancs

A MacBookon nyisd meg a Terminált (Spotlight: Cmd+Szóköz, írd be: Terminál), másold be az alábbi parancsot, és nyomj Entert.


    
  

  
A telepítő ezután megkérdez néhány dolgot. Mindegyiknél Enterrel elfogadhatod a szögletes zárójelben lévő értéket.

  

    
KérdésMit írj be

    
      
A játék oldalának címeMár ki van töltve a fenti címmel, csak nyomj Entert.

      
Titkos tokenA gazdától kapott token. Gépelés közben nem látszik, ez így van rendjén. Beillesztés: Cmd+V, majd Enter.

      
Az ajtószenzor nevének részleteEnter (alapból SBDW, a Shelly ajtószenzorok neve így kezdődik).

    
  

  
Ha a telepítő azt írja, hogy „A szerver elérhető, a token jó.”, akkor a MacBook már beszél az oldallal.

  

    
Ha az első futásnál egy Apple ablak ugrik fel

    
Egy friss Macen előbb az Apple fejlesztői eszközöket kell telepíteni (ebben van a git és a Python). Kattints a Telepítés gombra, várd meg a végét (pár perc), majd futtasd újra ugyanazt a parancsot.

  






  
3Engedélyek

  
A telepítő végén megnyílik egy új Terminál-ablak, abban fut az ajtófigyelő. Ezt hagyd nyitva, lekicsinyítheted. A macOS ilyenkor engedélyeket kér, mindet engedélyezd:

  
    
    
  • Bluetooth a Terminálnak. Ha nem kérdezi meg, kapcsold be kézzel: Rendszerbeállítások › Adatvédelem és biztonság › Bluetooth › Terminál. Utána zárd be az ajtófigyelő ablakát, és indítsd újra (lásd lent).
    • 
    
  • A „System Events” vezérlése, hogy bejelentkezéskor magától induljon.
    • 
  

  
Ha az ablakban ezt látod: Bluetooth device is turned off, akkor a Terminálnak még nincs Bluetooth-engedélye.






  
4A MacBook ne aludjon el

  
Ha a MacBook alszik, nem hallja az ajtót. Tartsd töltőn, és a Rendszerbeállítások › Akkumulátor › Beállítások részen kapcsold be: töltőn ne aludjon el automatikusan, ha a kijelző ki van kapcsolva. Terminálból ugyanez (jelszót kér):

  

    
sudo pmset -c sleep 0 disksleep 0

    
  

  
A fedelet hagyd nyitva, mert csukott fedéllel a MacBook külső kijelző nélkül elalszik.






  
5Ellenőrzés

  
    
    
  • Nyisd ki, majd csukd be az ajtót. Az ajtófigyelő ablakában megjelenik: Az ajtó ki lett nyitva, majd Az ajtó be lett csukva, mindkettő alatt szerver: elküldve. Záráskor elindul a kerék.
    • 
    
  • Ezen az oldalon nő az ajtószámláló, és elindul egy pörgetés.
    • 
    
  • Ha nem jelez: nyomd meg a szenzoron a gombot (ettől azonnal hirdet), és nézd meg, elég közel van-e a MacBook.
    • 
  






  
6Napi használat

  

    
TeendőHogyan

    
      
Újraindítás utánSemmi: bejelentkezéskor az ajtófigyelő magától elindul a Terminálban.

      
FrissítésMinden indulásnál magától letölti a legújabb verziót a GitHubról.

      
Kézi újraindításZárd be az ablakát, és futtasd: open ~/exmentoring-ajto/iroda-macbook/start-ajto.command

      
Új token vagy új címFuttasd újra a 2. lépés parancsát. A többi beállítás Enterrel megmarad.

      
Beállítások~/exmentoring-ajto/ajto.env (csak ezen a gépen van, a GitHubra nem kerül fel)

    
  






  
7Mit csinál a telepítő

  
A teljes kód a GitHubon van: github.com/richardhestencz/exmentoring. A telepítő szkript itt olvasható: iroda-macbook/install.sh. Lépésről lépésre:

  
    
    
  1. Ellenőrzi, hogy megvannak-e az Apple fejlesztői eszközök, és ha nincsenek, elindítja a telepítésüket.
    2. 
    
  2. Letölti a kódot a GitHubról a ~/exmentoring-ajto mappába (vagy frissíti, ha már ott van).
    3. 
    
  3. Megkérdezi a címet és a tokent, és kipróbálja őket az oldal /api/ping végpontján.
    4. 
    
  4. Elmenti a beállításokat az ajto.env fájlba, amit csak a te felhasználód olvashat.
    5. 
    
  5. Létrehoz egy Python-környezetet a Bluetooth-csomaggal (bleak).
    6. 
    
  6. Felveszi az ajtófigyelőt a bejelentkezési elemek közé, és most el is indítja egy Terminál-ablakban.
    7. 
  

  
Kézzel, telepítő nélkül is kipróbálhatod, hogy a MacBook eléri-e az oldalt (a TOKEN helyére a sajátodat írd):

  

    

    
  

  
Válasz {"ok":true}: minden jó. hibás token: rossz a token. Ha nincs válasz, a cím nem érhető el az irodából.