How ltcuong1997-creator/khachsancliffhouse works
Cliff House is a browser-based hotel administration app for reviewing monthly finances and managing cashbook, attendance, payroll, staff, and settings. Its main workflow is a user opening a reporting or operational page, reviewing or editing hotel data, and using payroll rules to calculate labor costs and profit. A companion robot logs into KiotViet, retrieves cashbook entries, reconciles them, and writes them to Firestore. The app source is a single unsampled HTML file, so page components and their internal data flow are based on README documentation; robot relationships are supported by the excerpts.
Main entry points: index.html Admin app · sync.js Cashbook sync robot · kv.js KiotViet API client · survey.js API survey
Components 18
Financial reports
- Admin app
public/index.html - Monthly report
public/index.html - Expense details
public/index.html - Annual P&L
public/index.html
Hotel operations
- Cashbook view
public/index.html - Attendance
public/index.html - Payroll
public/index.html - Staff records
public/index.html - Configuration
public/index.html - Profit calculation
public/index.html - Browser demo data
public/index.html
Cashbook sync
- Cashbook sync robot
robot/soquy/sync.js - KiotViet API client
robot/soquy/kv.js - API survey
robot/soquy/survey.js
Other components
- Hotel staff
- GitHub Actions
- KiotViet Hotel
- Firestore
Connections 19
- Hotel staff → Admin app: opens
README.md - Admin app → Monthly report: offers page
README.md - Admin app → Expense details: offers page
README.md - Admin app → Annual P&L: offers page
README.md - Admin app → Cashbook view: offers page
README.md - Admin app → Attendance: offers page
README.md - Admin app → Payroll: offers page
README.md - Admin app → Staff records: offers page
README.md - Admin app → Configuration: offers page
README.md - Monthly report → Profit calculation: uses totals
README.md - Annual P&L → Profit calculation: uses totals
README.md - Attendance → Payroll: supplies hours
README.md - Payroll → Profit calculation: supplies labor cost
README.md - Admin app → Browser demo data: uses in demo
README.md - GitHub Actions → Cashbook sync robot: runs
robot/soquy/sync.js - Cashbook sync robot → KiotViet API client: calls login and fetch
robot/soquy/sync.js - KiotViet API client → KiotViet Hotel: reads cashbook
robot/soquy/kv.js - Cashbook sync robot → Firestore: writes cash records
robot/soquy/sync.js - API survey → KiotViet Hotel: probes API
robot/soquy/survey.js