Cài đặt hệ thống

Nơi lưu toàn bộ dữ liệu của app

Dữ liệu App
/Users/macbook/.openclaw/workspace/haru-demo
Sheet Sync Config
/Users/macbook/.openclaw/workspace/haru-demo/sync_config.json
Hình ảnh chuyển khoản (nhân sự)
/Users/macbook/.openclaw/workspace/haru-demo/bills/staff
Thông tin nhận tiền KH
/Users/macbook/.openclaw/workspace/haru-demo/bills/customers
Thư mục gốc
/Users/macbook/.openclaw/workspace/haru-demo
Hướng dẫn chạy app trên server mới
1) Copy thư mục /Users/macbook/.openclaw/workspace/haru-demo sang máy mới
2) Mở Terminal và chạy:
cd /Users/macbook/.openclaw/workspace/haru-demo
python3 -m http.server 8787
3) Mở trình duyệt: http://<IP_MÁY_MỚI>:8787
4) (Tuỳ chọn) Auto-start: tạo file launchd tương tự com.haru.demo.plist
Bảng quy trình làm việc (tự động cập nhật)
Đang tải quy trình...
Bước Hành động Kích hoạt Đích Trạng thái
Hướng dẫn hệ thống (Tổng quan)
1) Nguồn dữ liệu
- Google Sheet/CSV → sync tạo cards-*.html, detail-*.json, reminders-*.json (theo tháng).
- LocalStorage: haru_local_jobs, haru_hidden_jobs, haru_paid_roles, haru_job_status_photo, haru_job_status_video, haru_staff_profiles, haru_manual_transactions, haru_reminder_extras, haru_history.
2) App & Server
- App tĩnh: HTML/CSS/JS trong /haru-demo.
- API sync: sync_api.py (Flask).
- Online: Google Cloud Run (service haru-wedding).
- Link online: https://haru-wedding-449309210483.asia-southeast1.run.app
3) Google Cloud
- Project: haru-wedding-app-2
- Region: asia-southeast1
- Billing: 0180AC-2B7EFA-09D171
4) Backup
- Bucket: gs://haru-wedding-backup
- Script: /Users/macbook/.openclaw/workspace/haru-demo/backup_gcs.sh
- Cron: mỗi giờ → log /tmp/haru-backup.log
5) Lệnh chuẩn
- Deploy Cloud Run: gcloud run deploy haru-wedding --source /Users/macbook/.openclaw/workspace/haru-demo --region asia-southeast1 --allow-unauthenticated
- Sync thủ công: chạy sync_haru.sh
- Backup tay: chạy backup_gcs.sh
6) Tài khoản
- Google account hiện dùng: haru.jpx@gmail.com
- Login app: admin haruwedding / Haru@12345
Hướng dẫn hệ thống (Chi tiết)
A. Thư mục & file chính
• App root: /Users/macbook/.openclaw/workspace/haru-demo/
• Trang chính: index.html
• Nhân sự: staff.html
• Giao dịch: transactions.html
• Lịch/nhắc: reminders.html
• Cài đặt: settings.html
• Lịch sử: history.html
• Thuế: tax.html
• Thùng rác: trash.html
• Sync: sync.html
B. File dữ liệu theo tháng
cards-*.html: thẻ job tháng
detail-*.json: chi tiết job + services
reminders-*.json: dữ liệu nhắc việc
C. Sync dữ liệu
• Script: sync_haru.sh
• Config: sync_config.json (sheet_id + months)
• API: sync_api.py (Flask) — update config + upload CSV
D. Transaction log
• Log file: bills/staff/transactions.jsonl
• Giao dịch nhập tay: localStorage.haru_manual_transactions
E. LocalStorage (trình duyệt)
haru_local_jobs, haru_hidden_jobs, haru_paid_roles
haru_job_status_photo, haru_job_status_video
haru_staff_profiles, haru_reminder_extras, haru_history
F. Cloud Run
• Service: haru-wedding
• Project: haru-wedding-app-2
• Region: asia-southeast1
• URL: https://haru-wedding-449309210483.asia-southeast1.run.app
G. Lệnh vận hành
• Deploy: gcloud run deploy haru-wedding --source /Users/macbook/.openclaw/workspace/haru-demo --region asia-southeast1 --allow-unauthenticated
• Sync: /Users/macbook/.openclaw/workspace/haru-demo/sync_haru.sh
• Backup: /Users/macbook/.openclaw/workspace/haru-demo/backup_gcs.sh
H. Backup GCS
• Bucket: gs://haru-wedding-backup
• Cron: 0 * * * * (mỗi giờ)
• Log: /tmp/haru-backup.log
I. Phiên bản hiện tại
• Version: V2.15
• Cloud Run revision: haru-demo-00118-5cm
• Service URL: https://haru-demo-449309210483.asia-southeast1.run.app
• Backup local: /Users/macbook/.openclaw/backups/haru-demo-20260214-234015-6bed32e.tar.gz
J. Bộ nhớ hệ thống
• Trang: /memory.html
• MEMORY.md: /Users/macbook/.openclaw/workspace/MEMORY.md
• Memory ngày: /Users/macbook/.openclaw/workspace/memory/
• Changelog app: /Users/macbook/.openclaw/workspace/haru-demo/changelog.json
• Lệnh bootstrap bộ nhớ: bash /Users/macbook/.openclaw/workspace/haru-demo/brain_bootstrap.sh
• File context sau bootstrap: /Users/macbook/.openclaw/workspace/memory/brain-context.txt
K. Login
• Trang login: /login.html
• Admin: haruwedding / Haru@12345
Phiên bản & Backup
Phiên bản: V2.15
Gói backup: haru-demo-20260214-234015-6bed32e.tar.gz
Vị trí backup local: /Users/macbook/.openclaw/backups/haru-demo-20260214-234015-6bed32e.tar.gz
Ngày cập nhật: 2026-02-15
Cloud Run revision: haru-demo-00115-tsx