HandyCafe Docs
it-admin

Pagsisimula: IT Administrator

Sinasaklaw ng guide na ito ang teknikal na setup ng HandyCafe. Pagkatapos nito, na-install mo na ang server at clients, naka-configure na ang network, nabuuo na ang app menus, at na-test na ang remote management.

Oras para makumpleto: 5 minuto (dagdag pa ang oras ng client deployment)

Hakbang 1: I-install ang Server at Clients

Pag-install ng server:

  1. I-verify na natutugunan ng iyong server PC ang system requirements.
  2. I-download at i-install ang HandyCafe Server sa iyong management PC.
  3. Buksan ang server at kumpletuhin ang First Setup Wizard para gumawa ng admin account.
  4. Tandaan ang local IP address ng server PC. Kakailanganin ito ng mga client para makakonekta.

Pag-install ng client (ulitin para sa bawat PC):

  1. I-download ang HandyCafe Client sa bawat customer-facing PC.
  2. I-install at buksan ang client.
  3. Maghahanap ang client ng server sa local network gamit ang mDNS discovery.
  4. Kung hindi awtomatikong mahanap ang server, manu-manong ilagay ang server IP address sa client settings.
  5. Kapag nakakonekta na, lalabas ang client sa Admin Panel ng server.

Tip: Gamitin ang auto-naming feature ng server (Settings > Clients) para awtomatikong pangalanan ang mga client na may prefix tulad ng "PC #1", "PC #2", atbp. Maaari mong i-customize ang display names sa ibang pagkakataon.

Tingnan ang Pag-install ng Server at Pag-install ng Client para sa detalyadong mga hakbang.

Hakbang 2: I-configure ang Network Settings

Pumunta sa Settings > Network sa server.

Gumagamit ang HandyCafe ng apat na port para sa komunikasyon:

Port Default Layunin
TCP Port 5001 Command at response na komunikasyon
File Port 5002 File transfers sa pagitan ng server at clients
Remote Management Port 5003 Kontrol ng remote desktop streaming
UDP Port 5004 Data ng streaming ng screen

Configuration:

  1. I-set ang mga ports (ang defaults ay gumagana para sa karamihan ng setup).
  2. I-set ang Connection Key. Ito ay isang shared secret na ginagamit para sa HMAC-SHA256 authentication. Lahat ng clients ay dapat gumamit ng parehong key.
  3. I-click ang Save.

Mga firewall rules:

Tiyaking bukas ang mga port na ito sa parehong server at client PCs:

  • TCP: 5001, 5002, 5003 (inbound sa server, outbound sa clients)
  • UDP: 5004 (bidirectional para sa screen streaming)

Mahalaga: Lahat ng PCs ay dapat nasa parehong local network (subnet). Gumagamit ang HandyCafe ng mDNS para sa client discovery na nangangailangan ng LAN connectivity.

Tingnan ang Network Settings para sa lahat ng network options.

Hakbang 3: I-set Up ang Client Menu

Ang client menu ang app launcher na nakikita ng mga customer sa kanilang desktop. Pumunta sa Settings > Clients > Content tab.

  1. Gumawa ng mga category. I-group ang mga app ayon sa uri (hal., Games, Browsers, Social Media, Tools).
  2. Magdagdag ng apps sa bawat category:
    • I-set ang pangalan ng app at description.
    • Piliin ang uri ng app: Laro, Browser, Link, File, o App.
    • I-set ang executable path o launch URI.
    • Mag-upload ng icon at opsyonal na poster image para sa app card.
  3. I-reorder ang mga category at apps gamit ang drag handles.
  4. I-toggle ang visibility para ipakita o itago ang mga items.
  5. I-click ang Save.

Awtomatikong naipu-push ang mga pagbabago sa lahat ng nakakonektang clients sa real time sa pamamagitan ng TCP.

Tip: Gamitin ang IGDB integration para awtomatikong maghanap ng game metadata at icons.

Tingnan ang Client Menu para sa kumpletong menu builder documentation.

Hakbang 4: I-configure ang Idle Screen at Appearance

Idle Screen (Mga Setting > Mga Kliyente > Tab na Idle Screen):

Ang idle screen ang nakikita ng mga customer kapag walang aktibong session (ang lock screen).

  1. I-enable ang idle screen slideshow.
  2. Magdagdag ng images o videos (PNG, JPG, WebP, GIF, MP4, WebM).
  3. I-set ang duration kada item at transition effect (fade, slide, zoom).
  4. Opsyonal na i-enable ang clock overlay at cafe name display na may custom colors.
  5. I-click ang Save.

Hitsura (Mga Setting > Mga Kliyente > Tab ng Hitsura):

I-configure ang hitsura ng online desktop na ginagamit ng mga customer sa mga session.

  1. Pumili ng theme: Neon Arena, Crimson Pulse, o Emerald Depth.
  2. Pumili ng layout preset: Split Classic, Hero Wide Top, Catalog Wide Bottom, o Compact Focus.
  3. I-configure ang background: solid color, gradient, image, o video na may overlay at blur settings.
  4. I-adjust ang card density (Large, Medium, Compact) at hover effects.
  5. I-click ang Save.

Tingnan ang Client Idle Screen at Client Appearance para sa lahat ng mga opsyon.

Hakbang 5: I-test ang Remote Desktop at Screenshots

I-verify na gumagana ang remote management:

Screenshots:

  1. Sa Admin Panel, pumili ng anumang online client card.
  2. I-click ang Screenshot sa client card.
  3. Lalabas ang screenshot ng client screen sa viewer.
  4. Maaari mong i-download o i-refresh ang screenshot.

Remote Desktop:

  1. Pumili ng online client card at i-click ang Remote Desktop.
  2. Magbubukas ang remote desktop window na may live H.264 streaming.
  3. Maaari mong kontrolin ang mouse at keyboard sa remote PC.
  4. Gumagana ang clipboard synchronization sa pagitan ng server at client.

Paalala: Gumagamit ang remote desktop ng UDP streaming. Kung mabagal ang video, suriin ang iyong network bandwidth at tiyaking hindi naka-block ang UDP port 5004. Maaari mo ring i-adjust ang bitrate sa stream settings (350-25,000 kbps).

Tingnan ang Remote Desktop at Screenshots para sa lahat ng remote features.

Pangkalahatang-tanaw ng Network Architecture

Server PC (Management)
    |
    |--- TCP (5001) --- Command/Response (bincode + HMAC-SHA256)
    |--- TCP (5002) --- File Transfers
    |--- TCP (5003) --- Remote Management Control
    |--- UDP (5004) --- Screen Streaming (H.264)
    |--- mDNS ------- Client Discovery (automatic)
    |
    +-- Client PC 1
    +-- Client PC 2
    +-- Client PC 3
    +-- ...

Ano ang Susunod na Gagawin