How gotxe/monkiosk works
Monkiosk presents managed content on kiosk screens and provides a web console for kiosk health, server status, remote controls, access policy, and document management. Its core loop is kiosk presentation → heartbeat report → dashboard state, with kiosks polling for pending actions. Separate branches cover content administration, server operations, and kiosk provisioning/heartbeat services. Evidence is limited to the README and supplied excerpts/SOURCE INDEX; unsampled subsystems are included only where documented, with no inferred implementation links.
Main entry points: update_status.php Heartbeat intake · docs_api.php Document API · index.php Manual viewer · index.html Status dashboard
Components 23
Kiosk presentation
- Content presentation
kiosk_web/index.php - Presentation files
kiosk_web/docs
Monitoring and control
- Status dashboard
estado_quioscos/index.html - Heartbeat intake
estado_quioscos/update_status.php - Kiosk status state
estado_quioscos/app_config.php - Pending actions
estado_quioscos/get_action.php - Kiosk access policy
estado_quioscos/allowed_kiosks.php - Policy API
estado_quioscos/allowed_kiosks_api.php - Server health
estado_quioscos/server_status.php - Server controls
estado_quioscos/server_control.php - Session authentication
estado_quioscos/auth_lib.php
Content and documentation
- Document manager
estado_quioscos/docs_manager.php - Document API
estado_quioscos/docs_api.php - Document preview
estado_quioscos/docs_preview.php - Managed documents
estado_quioscos - Manual viewer
kiosk_info/index.php - Manual files
kiosk_info/src
Kiosk heartbeat and setup
- Heartbeat reporter
kiosks_report/debian/report_status.sh - Alpine heartbeat service
kiosks_report/alpine - Alpine kiosk installer
Quioscos_install_alpine/setup_quiosco.sh - Reporter installer
Quioscos_install_alpine/install_report.sh
Other components
- Operator
- Kiosk device
Connections 26
- Kiosk device → Content presentation: opens content
README.md - Content presentation → Presentation files: reads files
README.md - Kiosk device → Heartbeat intake: reports status
README.md - Heartbeat reporter → Heartbeat intake: posts heartbeat
- Alpine heartbeat service → Heartbeat intake: reports status
- Heartbeat intake → Kiosk status state: updates state
estado_quioscos/update_status.php - Status dashboard → Kiosk status state: shows status
README.md - Status dashboard → Server health: shows health
README.md - Kiosk device → Pending actions: polls actions
README.md - Pending actions → Kiosk device: returns actions
README.md - Operator → Status dashboard: manages fleet
README.md - Operator → Server controls: controls server
- Operator → Kiosk access policy: edits policy
estado_quioscos/allowed_kiosks.php - Kiosk access policy → Policy API: fetches policy
estado_quioscos/allowed_kiosks.php - Policy API → Kiosk status state: purges status
estado_quioscos/allowed_kiosks_api.php - Document manager → Document API: manages documents
estado_quioscos/docs_manager.php - Document API → Managed documents: reads and writes
estado_quioscos/docs_api.php - Document preview → Managed documents: reads preview
estado_quioscos/docs_preview.php - Operator → Manual viewer: views manuals
- Manual viewer → Manual files: loads manuals
kiosk_info/index.php - Manual viewer → Document preview: requests preview
- Alpine kiosk installer → Kiosk device: configures device
- Reporter installer → Alpine heartbeat service: installs service
- Document manager → Session authentication: requires session
estado_quioscos/docs_manager.php - Document API → Session authentication: checks session
estado_quioscos/docs_api.php - Server health → Session authentication: checks session
estado_quioscos/server_status.php