Welcome

Choose an app to get started

Your apps

Loading company summary…

Welcome back

Loading…

● Ready to check in

--:--

My Workspace at a Glance

21

Days Present (Month)

1

Late Arrivals (Month)

168h

Hours This Month

12

Leave Days Remaining

My Analytics

Leave Balance — Day Summary 2026

Annual Leave

— / — days left

Sick Leave

— / — days left

Recent Attendance

Date	Check-in	Check-out	Status

My Leave Requests

12

Annual Leave Left

30

Sick Days Left

Recent Requests

Company Announcements Latest updates

Celebrations This Month

Upcoming Holidays

My Team

My Action Items

Global Offices

Learning & Development

My Performance

Opening Procurement…

Overview & stats

15 employees

Photo	ID	Employee	Gender	DOB	Position	Job Level	Department	Type	Onboard Date	Direct Manager	Phone	ID / Passport	Education	Family	Emergency Contact	Address	Status	Actions

System Integrations

Microsoft 365, approval email, SharePoint & the Procurement launcher. Admin only — these control where data is sent.

Microsoft Teams — Incoming Webhook URL (optional)

When set, approval notifications also post to your Teams channel. Teams → channel → Connectors → Incoming Webhook.

Finance SharePoint folder (URL)

Paste the SharePoint folder link where payment / claim / travel files should be stored. On submit the file uploads here and the SharePoint link is shown to the requester and approver (like the project document folders). Files are filed by the SERVER on submit into <Payments|Claims|Travel>/<year>/<month>/<reference>/, so it works whether or not anyone is signed in to Microsoft. Leave blank to keep files inside the portal.

HR SharePoint folder (URL)

Paste the SharePoint folder link for HR documents. Job Descriptions attached to a requisition are filed by the SERVER into JD/<year>/, so it works whether or not anyone is signed in to Microsoft. Leave blank and JDs stay inside the portal, and signed policy acknowledgements stay in the portal too.

Who is HR — who may publish company documents

Editor and Admin can already publish. Naming somebody here adds to that — use it for the HR officer who writes the policies, so she gets + Publish a document and the Edit / Re-issue / Archive controls without being promoted to Editor. Several addresses may be listed, separated by commas. A department manager still cannot publish: committing every employee to signing something is not something you inherit by running a department. Leave blank and it falls back to “Approver (Management) or above”.

Employment history

Reconstructs each employee's dated salary, grade, title and department history from the pay runs a Director has signed. Rows somebody recorded by hand are never touched — only the reconstruction is rebuilt, and what it removes is written to the audit trail. Safe to run more than once. Run this if the portal's employment history was ever built by an earlier version, which read the payslip total as salary.

Annual overtime ceiling (hours)

Labour Code Art. 107 allows 200 hours a year, and 300 only for the industries Art. 107(3) lists, after notifying the labour authority. Leave blank for 200 — the answer for any company that has not taken and recorded that decision. The daily (4h) and monthly (40h) limits are fixed by the article and are not editable. Approving beyond a limit is still possible, but only with a reason, and it is written into the audit trail under the approver's name.

Bank salary-file layout

Every Vietnamese bank publishes its own upload template. Set the columns your bank expects and in what order — changing bank is a setting here, not a new release. Download a sample file from your bank's portal (Techcombank F@st EBank: Payroll → Bulk transfer → Download template) and copy its headings exactly; the bank matches on the heading text. Leave it untouched to use the shipped layout.

Disbursement segregation of duties — a different person pays than approved

When on (recommended), the person who releases a payment must not be the one who gave final approval — and no one can pay their own request. This needs at least two authorised payers. Turn OFF only if your finance function is a single person; paying your own request stays blocked either way.

Authorised payers — who may mark a request paid

Releasing money is a named duty, not something everyone with an access level inherits. Only these people see Mark paid. Being listed is the grant, so a payer does not need Editor/Admin — but they do need access to the Finance page. Leave blank to fall back to “any Editor or Admin”. The rules above still apply on top: never your own request, and never one you approved.

Approval emails — branded, sent per department

Emails the reviewer, approver and requester at every step of the approval flow (submit → review → approve / reject / paid). Decisions are still made in the portal with an e‑signature — the email carries a secure “Review in portal” button, never a one‑click approve link. Requires Microsoft 365 Mail.Send application consent on the Humiley app.

HR sender · leave, PADR

Finance sender · claims, travel, payments

Procurement sender

Overdue reminders — nudge whoever must act

Remind after day(s) waiting, then once a day.

Escalate after day(s) overdue (0 = off) → CC on the nudge.

Weekly digest — summary email to managers & leadership

Once a week, each manager gets what’s awaiting their review; leadership gets a company‑wide roll‑up (pending · overdue · total value). Uses the same Mail.Send as above.

Send every · Leadership email

Monthly report pack — month-end summary to leadership

On the chosen day each month, emails leadership a branded summary of the closed month (payments, invoices & VAT, approvals, headcount) with a link to open & export the full pack in the portal.

Send on day · To

Timekeeping nudges — remind staff to check in / out

On working days, pushes a reminder to any active employee who hasn't checked in by the check-in time, and to anyone still checked in at the check-out time. Skips weekends, holidays & staff on leave. Uses Web Push (not email).

Check-in reminder at :00 · Check-out reminder at :00

Integrations & health

Verify each go‑live switch‑on actually worked — Microsoft 365, invoice sync, approval email, SharePoint, push.

Procurement app (URL)

Where the Procurement Portal is served — an app of this portal at portal.humiley.com/procurement. The sidebar entry opens it (no second login) for every employee an admin has granted the Procurement app in Access & Permissions. Leave blank to use the default (localhost:3000/procurement in development).

Welcome back

Loading…

Present Today

0

—

On Time

0

—

Late Arrivals

0

—

On Leave

0

—

HR at a Glance

Daily Attendance

On time · Late · Absent

Today's Activity

0 check-ins

Pending Approvals

Department Summary

Present today

--:--

Loading…

Not checked in

Today's Hours

0h 0m

Check In / Out

Where are you checking in from?

Select your location above — we'll check your GPS and record it with your punch. It never blocks your check-in.

Which job are you on today? (optional)

Naming the job is what makes labour cost per project a real figure instead of an estimate. It never affects your check-in — leave it blank and the day is simply not attributed.

Today's Record

—

Check In

—

Check Out

—

Total

—

Zone

—

Recent Check-In History

Last 8 days

Employee	Date	Check-In	Check-Out	Hours	GPS Zone	Status	Actions
No attendance records yet.

No records

Approved Geofence Zones

Location	Coordinates	Radius	Department
HQ — District 10, HCMC 200 3/2 Street · Primary office	10.7769°N 106.6985°E	200m	All Depts
Factory — Long An Province Manufacturing facility · 15,000m²	10.5427°N 106.4139°E	350m	Engineering, Field
WFH — Registered Addresses Per-employee home coordinates	Various	100m	Approved only

Schedule Name	Department	Check-In Window	Check-Out From	Work Days	Grace Period	Unpaid Break
Standard 08:00 – 17:00	All	07:30 – 08:30	17:00	Mon – Fri	30 min	1.5×
Morning Shift 06:00 – 14:00	Factory	05:45 – 06:15	14:00	Mon – Sat	15 min	1.5×
Evening Shift 14:00 – 22:00	Factory	13:45 – 14:15	22:00	Mon – Sat	15 min	1.5×
Flexible (Field Services)	Field Services	07:00 – 09:00	8h after in	Mon – Fri	30 min	1.5×
WFH Schedule	Approved only	08:00 – 09:00	17:00	Mon – Fri	30 min	—

How it works: The active schedule for each employee's department defines the valid check-in window, grace period and overtime rate used when their attendance is recorded.

4

Pending Approvals

4

Late Today

2

GPS Anomalies

4

On Leave

Approvals have moved to the Approval Inbox

Leave, travel, claims, requisitions and PADR reviews are now all approved in one place.

Employee	Department	Annual (Used/Total)	Sick (Used/Total)	Comp-off	Status	Actions

Avg On-Time Rate

—

All records

Total Hours Worked

0h

All records

Leave Days Taken

0d

All records

GPS Anomalies

0

All records

Attendance Rate — Daily Trend

On-time % vs Late %

Leave Type Distribution

Late Arrivals by Department

Top Insights

No insights yet — they appear once attendance data is recorded.

Employee	Department	Leave Type	From	To	Days	Reason	Status	Approved By
No leave records yet.

Azure AD Application

Not Configured

Register an app in Azure AD to enable Microsoft 365 single sign-on and SharePoint access.

Tenant ID *

Found in Azure Portal → Azure Active Directory → Overview

Client ID (Application ID) *

Found in Azure Portal → App Registrations → your app → Overview

Redirect URI

SharePoint Site

Not Configured

SharePoint Tenant URL *

Site URL (relative path) *

Full URL will be: [Tenant URL] + [Site URL]

Required SharePoint Lists:

Attendance_Records Leave_Requests Leave_Balances Approved_Locations Employees SP_Config

Google Maps API

● Active (Browser GPS)

Used for reverse geocoding (address lookup from GPS coordinates). The browser's native Geolocation API is used for GPS — no Maps API key required for that.

Google Maps API Key (Geocoding)

Enable: Geocoding API + Maps JavaScript API. Restrict to your domain.

Allowed Domain (API restriction)

Automated Notifications

Built in

Notifications and approval routing are built into the portal — leave, claim and payment requests notify the chosen approver automatically by web push and Microsoft 365 email, and reminders are handled server-side. No external Power Automate flows are required.

Zone Name	Coordinates	Radius	Department	Active	Actions
HQ — District 10, HCMC Head Office · Main building	10.7769°N 106.6985°E	200m	All
Factory — Long An Province Manufacturing facility	10.5427°N 106.4139°E	350m	Field Services

SP_CONFIG Status: Placeholders not filled in — Demo mode active

Fill in the 4 values in SP_CONFIG at the top of the <script> section to go live with SharePoint data.

1

Prerequisites — What you need before starting

1

Microsoft 365 Licences Required

Ensure you have: M365 Business Standard (includes SharePoint Online, Power Automate, Power Apps, Teams). Each employee needs at least an M365 Business Basic licence for SharePoint access.

2

Admin Roles Required

You need: SharePoint Admin (to create lists), Azure AD Admin (to register the app), Power Automate Maker (to build flows).

2

Step 1 — Create SharePoint Site & Lists

1

Create the Site

Go to admin.microsoft.com → SharePoint → Sites → Active sites → + Create → Team site

Site name:     HumileyHR
Site address:  humiley.sharepoint.com/sites/HumileyHR
Privacy:       Private
Owners:        HR Admin + IT Admin

2

Create 6 Lists (Site Contents → + New → List)

Attendance_Records  — CheckInTime, CheckOutTime, GPS coords, Status
Leave_Requests     — LeaveType, StartDate, EndDate, Status, Approvals
Employee_Profiles  — EmployeeID, Department, Manager, Schedule
Approved_Locations — Latitude, Longitude, RadiusMetres, IsActive
Leave_Balances     — AnnualUsed, SickUsed, CompOffEarned per employee/year
Notification_Log   — NotifType, RecipientEmail, Status, FlowRunID

3

Step 2 — Register Azure AD App (for Graph API)

1

Create App Registration

Go to portal.azure.com → Azure Active Directory → App registrations → + New registration

Name:          Humiley-Timekeeping-App
Account type:  Single tenant
Redirect URI:  SPA → https://humiley.sharepoint.com/sites/HumileyHR

After registering, copy the Application (client) ID and Directory (tenant) ID — these go into SP_CONFIG in the HTML script.

2

Add API Permissions & Grant Consent

Sites.ReadWrite.All    Delegated  → read/write SharePoint lists
User.Read             Delegated  → get current user profile
User.ReadBasic.All    Delegated  → look up employees

Click "Grant admin consent for Humiley" — all permissions must show a green tick.

4

Step 3 — Fill in SP_CONFIG (4 values)

1

Edit Humiley_Timekeeping_Platform.html

Open the HTML file in VS Code. Find SP_CONFIG near the top of the <script> section and replace these 4 placeholder strings:

const SP_CONFIG = {
  clientId:   'YOUR_CLIENT_ID',        ← Azure AD App → client ID
  tenantId:   'YOUR_TENANT_ID',        ← Azure AD → Directory ID
  siteId:     'YOUR_SHAREPOINT_SITE_ID', ← Graph Explorer lookup
  mapsKey:    'YOUR_GOOGLE_MAPS_API_KEY'  ← Google Cloud Console
};

To find your Site ID: open Graph Explorer (developer.microsoft.com/graph/graph-explorer) → sign in → call GET https://graph.microsoft.com/v1.0/sites/humiley.sharepoint.com:/sites/HumileyHR → copy the "id" value.

5

Step 4 — Host on SharePoint

1

Upload HTML to Site Assets

Go to humiley.sharepoint.com/sites/HumileyHR → Site contents → Site Assets → Upload. Upload Humiley_Timekeeping_Platform.html. Copy the direct URL.

2

Create a SharePoint Page with Embed Web Part

Site home → + New → Page → Embed web part → paste this iFrame:

<iframe
  src="https://humiley.sharepoint.com/sites/HumileyHR/SiteAssets/Humiley_Timekeeping_Platform.html"
  width="100%" height="900" frameborder="0" allowfullscreen>
</iframe>

6

Step 5 — Set Up Power Automate (8 Flows)

Flow 1 · Late Alert

Daily 09:30 · Query late records → Teams to manager

Flow 2 · Missed Check-In

Daily 10:00 · Find no check-in → Teams absent alert

Flow 3 · Leave Approval

On new leave item · Adaptive Card → Manager → HR

Flow 4 · Balance Reset

Jan 1 · Reset all leave balances to entitlement

Flow 5 · GPS Anomaly

On new attendance · If Out-of-Zone → Teams alert

Flow 6 · Monthly Report

1st of month · Generate Excel → email HR admin

Flow 7 · Checkout Reminder

Daily 17:30 · Find unchecked-out → Teams message

Flow 8 · Low Balance

On balance update · If ≤2 days → warn employee

The full DOCX guide (Humiley_SharePoint_Integration_Guide.docx) contains complete column definitions, flow configurations, code samples, and a 20-item go-live checklist.

Welcome to Humiley Group Inc.

Welcome

Executive Dashboard

Welcome back

Onboarding & Policies

My Devices

My Space

CRM

Pipeline

Leads

Sales Compliance

Retention

Billing & Cash

Contracts

Quotations

Companies

Contacts

Products

Annual Operating Plan (AOP)

Design Portfolio

Design Control

Production Board

AHU Register

Orders & Contracts

Production Standard

Quality Evidence

Capacity & Load

Estimates

Rate Library

My Profile

Human Resource

Employee Database

Recruitment

Onboarding

My Goals

My Training

Offboarding & Exit

Performance Management

Talent Management

Training & Development

Approval Inbox

Travel Expense (TR)

Payment Requests

Finance Control

Signature Governance

Access & Permissions

Payroll

Welcome back

Check In / Out

Attendance Records

GPS Locations

Work Schedules

Leave Management

Team Monitoring

Office Operation

Reports & Analytics

Settings & Configuration

SharePoint Integration Guide

Prerequisites — What you need before starting

Microsoft 365 Licences Required

Admin Roles Required

Step 1 — Create SharePoint Site & Lists

Create the Site

Create 6 Lists (Site Contents → + New → List)

Step 2 — Register Azure AD App (for Graph API)

Create App Registration

Add API Permissions & Grant Consent

Step 3 — Fill in SP_CONFIG (4 values)

Edit Humiley_Timekeeping_Platform.html

Step 4 — Host on SharePoint

Upload HTML to Site Assets

Create a SharePoint Page with Embed Web Part

Step 5 — Set Up Power Automate (8 Flows)