Features — DEVB TC(W) No. 8/2025 Compliant DWSS

Component I — Workflow Management

Six Mandatory Site Supervision Modules

DWSS digitises all six workflow modules required by TC(W) 8/2025 § 7, with sequential approval routing, rejection/resubmission cycles, and statistical dashboards.

Approval Lifecycle (all 6 modules)

DRAFT → SUBMITTED → UNDER REVIEW → APPROVED / REJECTED → CLOSED

Every state transition writes an append-only ApprovalRecord with actor + timestamp.

RISC Form

Request for Inspection & Survey Check. Implements PAH 2024 Appendix 7.82A (GCC) and 7.82B (NEC) form references with three-part contractor/supervisor/acknowledgement workflow.

✓ SI / SUR / EM form types
✓ Photo with GPS + HK80 metadata
✓ Revision cycle — parent RISC linkage
✓ Pass/fail rate dashboard

TC(W) 8/2025 § 7.5.1.i

Site Diary

G.F. 536 Contractor Diary and Supervisor Site Record Book. Records daily progress, weather, plant/labour resources, site conditions, and occurrences.

✓ Contractor + Supervisor diaries
✓ Weather, rainfall AM/PM fields
✓ Cross-reference to Labour Return
✓ DRAFT → SUBMITTED → ENDORSED

TC(W) 8/2025 § 7.5.1.ii

Safety & Environmental Inspection

Weekly safety walk inspections and environmental inspections with structured checklists. Captures non-compliance items through a full correction cycle.

✓ Before/after photo evidence
✓ Non-compliance correction log
✓ Pass/fail rate & near-miss dashboard
✓ Air quality, noise, water monitoring

TC(W) 8/2025 § 7.5.1.iii

Cleansing Inspection

Daily Cleansing Inspection Checklist (DCI) and Weekly Cleansing Inspection Checklist (WCI). Tracks cleanliness compliance, offences, and non-compliance counts.

✓ Daily (DCI) + Weekly (WCI) forms
✓ Pre/post inspection photos
✓ Offence & non-compliance tracking
✓ Completion statistics dashboard

TC(W) 8/2025 § 7.5.1.iv

Labour Return

G.F. 527 monthly labour return — both the 2003 and 2017 revised formats. Auto-calculates project-specific fields and cross-references Site Diary labour data.

✓ G.F. 527 Rev 2003 & Rev 2017
✓ Auto-calculated dates & fields
✓ Site Diary labour cross-reference
✓ Wage rates & deployed labour stats

TC(W) 8/2025 § 7.5.1.v

NEC Contract Management

Full NEC contract administration: Compensation Events, Early Warnings, Project Manager's Instructions, Payment Certificates, Programme, and NEC Health Check per TC(W) 8/2025 § 6(b).

✓ CE, EW, PMI, PMC workflows
✓ Programme & Key Dates tracking
✓ NEC Health Check data model
✓ Financial status & completion dashboard

TC(W) 8/2025 § 7.5.1.vi

Workflow Management Dashboard Main Dashboard

Data Insights — DSR v1.2 § 3

Visual Representation of Statistical Data

Interactive, drill-down dashboards present statistical data collected from all six supervision modules — providing real-time project management insights to executives, as defined in the Data Standardisation Report (DSR) Version 1.2, December 2025 § 3.

DSR v1.2 § 3 — Baseline Visualisation Framework

The Data Standardisation Report v1.2 defines baseline dashboard requirements for all six workflow modules. DWSS dashboards are fully drill-down enabled — clicking any chart element surfaces the underlying project-level records, sorted by the selected metric. Daily, weekly, monthly and yearly views are available via mouse-wheel zoom.

RISC Dashboard

NC RISC distribution by works category (pie), failure rate of 1st inspection trend (bar), and outstanding RISC count (bar) — all filterable by quarter with drill-down to project level.

✓ Non-conformance pie chart by works category
✓ Failure rate of 1st inspection trend
✓ Top 4 outstanding RISC by category
✓ Drill-down to project-level detail

DSR v1.2 § 3.2

Site Diary Dashboard

Distribution of overdue Site Diary by responsible party, completed/in-completed/outstanding statistics, top 4 overdue projects ranking, and labour & plant deployment trends.

✓ Overdue diary distribution pie chart
✓ Completion status bar chart
✓ Top 4 overdue projects ranking
✓ Zoomable daily/weekly/monthly view

DSR v1.2 § 3.3

Safety Inspection Dashboard

NC and near-miss report counts, top 4 non-compliance trend lines, completed/in-completed statistics, and accident rate per 100,000 man-hours by project.

✓ NC / near-miss count trend bar chart
✓ Top 4 non-compliance projects trend line
✓ Accident rate / 100,000 man-hours bar
✓ Safety conviction count tracking

DSR v1.2 § 3.4

Cleansing Inspection Dashboard

Completed/in-completed/outstanding cleansing records distribution, top 4 NC cleansing inspection projects by count, and average elapsed time trends.

✓ DCI & WCI completion status bar chart
✓ Non-compliance count by project
✓ Average elapsed time tracking
✓ Quarter-on-quarter trend analysis

DSR v1.2 § 3.5

Labour Return Dashboard

Top 4 wage increase trends by labour type/trade, labour deployment by trade code, and group-by trade/trade-division view. Cross-referenced with Site Diary resource data.

✓ Top 4 wage increase trend chart
✓ Labour deployment by trade code
✓ Group-by trade / trade division view
✓ G.F. 527 Rev 2003 & 2017 stats

DSR v1.2 § 3.6

Contract Management Dashboard

Top 4 Early Warning count trends, contract key dates and completion date timeline, CE/PMI classification breakdown, and NEC Health Check performance indicators.

✓ Early Warning count trend by project
✓ Key dates & completion date timeline
✓ CE/PMI cost & time implication charts
✓ NEC Health Check performance KPIs

DSR v1.2 § 3.7

RISC Statistical Dashboard RISC Dashboard

Component II — Smart Construction Management

Real-Time IoT & Smart Site Safety Hub

DWSS acts as the mandatory SCM hub under TC(W) 8/2025 § 8, collecting and consolidating telemetry from all smart site applications and raising real-time alerts to responsible officers.

Mandatory SSSS Amalgamation — TC(W) 8/2025 Footnote

TC(W) 3/2023 permitted SSSS to be amalgamated into DWSS. TC(W) 8/2025 upgraded this to mandatory ("shall") for all contracts tendered on or after 1 April 2026. DWSS SCM is the designated hub — any SSSS vendor connects via the standard ingest API.

Smart Site Device Categories

Device Category	TC(W) 3/2023 Component
AI Safety Camera	AI Safety Monitoring (CCTV)
Smart Worker Wearable	Smart Worker Wearable
Access Control (E-lock)	E-lock Access Control
Mobile Plant Danger Zone	Mobile Plant Zone Alert
Tower Crane Lifting Zone	Tower Crane Zone Alert
Digital Permit-to-Work	PTW System
Plant / Tool Tracking	Plant & Tool Tracking
Confined Space Gas Monitor	Confined Space Monitor
Deformation / Settlement	Environmental / Deformation
SSSS CMP Gateway	Centralised Mgmt Platform

Alert Severity Engine

INFO

Telemetry within normal range. Logged for audit — no alert raised.

WARNING

Value exceeds threshold × 1.0. Alert raised. Assigned officer notified by in-app + email.

CRITICAL

Value exceeds threshold × 1.5 (AAA level). Supervisor + CRE also notified immediately.

Monitoring Categories

📷 Progress Monitoring

⚠️ Safety Monitoring

📐 Deformation Monitoring

🧱 Material Monitoring

🏗️ Machinery Monitoring

🌿 Environmental Monitoring

SCM Real-Time Dashboard SCM Dashboard

Component III — Smart Document Management

WBTC 19/93 Document Control & Workflow

Full lifecycle management of all formal project documentation — correspondence, submissions, drawings, reports — with OCR, version control, and external reviewer access.

WBTC No. 19/93 File Reference Hierarchy

L1

Cabinet

Project / Contract Identifier e.g. R9K/2003/09

L2

Drawer

File Division e.g. M30

L3

Folder

File Number / Extension e.g. 200/12

L4

Document (Folio)

Auto 5-digit folio e.g. 00001

Full ref: R9K/2003/09/M30/200/12/00001

Document Lifecycle

DRAFT → REGISTERED → IN DISTRIBUTION → ACKNOWLEDGED → CLOSED

1

OCR Auto-Extraction (§ 9.4.5)

Tesseract-powered OCR on every uploaded document. Extracted text stored for full-text PostgreSQL search. Image-based PDFs converted to searchable PDFs automatically.

2

External Reviewer OTP Portal (§ 9.7)

Non-DWSS reviewers receive a tokenised email invitation. They authenticate with a 6-digit OTP (15-min TTL) and get a 2-hour read-only session scoped to their assigned document only.

3

Version Control & Freezing (§ 9.8.9)

Every upload creates a new DocumentVersion with version number, uploader, and change note. Frozen documents reject new uploads until admin unfreezes.

4

Action Assignment & Threading (§ 9.6)

Distribute documents to multiple staff simultaneously. Recursive reassignment chain with remarks. Threaded replies. All events logged in the DocumentEvent audit timeline.

5

Cross-Component Linking (§ 9.9)

SDM documents link to any RISC form, Site Diary entry, SCM alert, or Contract record via Django's ContentType generic foreign key — maintaining full relational integrity.

SDM Cabinet / Drawer / Folder Tree SDM Cabinet Tree

Contract Management — DSR v1.2 § 4.8

NEC Contract Administration & Financial Control

Full NEC contract lifecycle management — real-time financial status, programme tracking, Early Warning register, and Compensation Event administration. All data standardised for iCWP reporting per DSR v1.2 § 4.8, including the new NEC Health Check data model added in v1.2.

A

Financial Status (DSR § 4.8 — A)

Tracks PWDD-to-forecast ratios, total of prices adjustments, and gain/pain share calculations. Key metrics: ratio of current PWDD to forecast final PWDD, ratio of changed total of prices to forecast total, and estimated gain/pain amount (pain/gain/N/A).

B

Programme Status (DSR § 4.8 — B)

Monitors time elapsed against contractual duration, planned vs. actual key dates, extension of time, and sectional completion status. Interactive timeline of all Contract Key Dates and Completion Dates — updated in real time as the programme progresses.

C

Early Warning Register (DSR § 4.8 — C)

Full register of Early Warnings initiated by Contractor and Project Manager. Tracks total count, open/closed status, average resolution time, and age analysis of unresolved warnings. In-app and email notifications triggered on each new EW submission.

D

Compensation Events & PMI (DSR § 4.8 — D)

End-to-end CE workflow: notification → quotation → assessment → implementation. Tracks CE sub-clause classification (NEC Clause 60.1), cost and time implications, and average durations at each stage. Ratio of implemented to notified CEs monitored continuously.

NEC Health Check New in DSR v1.2

First standardised in DSR Version 1.2 (December 2025), the NEC Health Check data model provides a structured six-dimension performance assessment transmitted to iCWP for portfolio-level governance across all NEC contracts.

Financial

Tender/contract prices, pain/gain share, expenditure %, CE cost impacts

Time Performance

Duration elapsed, key date achievements, EOT analysis, sectional completion

Programme

Submission/acceptance compliance, revision intervals, average processing times

Early Warnings

EW by source, closure rates, age analysis, average resolution timelines

Compensation Events

Notification stats, implementation rates, processing timelines, pending CE age

Contract Info

Department, NEC version/options, contractor, consultant, key personnel

Contract Management — CE & Early Warning Dashboard CE Dashboard

System Design — Data Standardisation Report v1.2, December 2025

Built to the DEVB Data Standardisation Report

DWSS is architected from the ground up against the DEVB Data Standardisation Report (DSR) Version 1.2, December 2025 — ensuring every data module, XML schema, file naming convention, and transport protocol meets the Government's standardisation requirements for iCWP integration across all capital works contracts.

Technical Architecture (DSR v1.2 § 4.1)

Format

XML via SFTP / JSON / SOAP

DSR § 4.1.1 — recommended data exchange format

Encoding

UTF-8 with HKSCS Support

DSR § 4.1.3 — ISO/IEC 10646 + HKSCS for Chinese characters

File Name

ProjectNo-ContractNo-DatasetID-Timestamp.xml

e.g. 461TH-HY_2014_09-DWSS-RISC-01-20260524T083210.xml

DSR § 4.1.2 — underscores replace forward slashes in contract numbers

Sync

Incremental export within 24 hours

DSR § 1.4 — all captured data exported to iCWP within 24 hours

8 Standardised Data Modules

§ 4.3 RISC Forms

§ 4.4 Site Diary

§ 4.5 Site Safety Inspection Records

§ 4.6 Cleansing Inspection Records

§ 4.7 Labour Return Statistics

§ 4.8 Contract Management (incl. NEC Health Check — new v1.2)

§ 4.10 Contractor's Submission ↑ New in v1.2

§ 4.11 Raw Document Metadata ↑ New in v1.2

v1.2 Additions (December 2025): Smart Document Management modules — Contractor's Submission (§ 4.10) and Raw Document Metadata (§ 4.11) — plus NEC Health Check data (§ 4.8 G) were formally standardised in v1.2, expanding the iCWP interface from 6 to 8 data modules.

Data Exchange

iCWP Integration & RESTful API

All five mandatory data modules are available via a DSR-compliant RESTful API. Data is automatically exportable to iCWP within 24 hours of capture.

Protocol

RESTful HTTPS API

TLS 1.2+, OAuth 2.0 Bearer Token or API Key authentication. JSON body, ISO 8601 timestamps in UTC+8.

Standard

DSR Version 1.2 (Dec 2025)

DEVB Data Standardisation Report. All five mandatory modules: RISC, SITE_DIARY, SAFETY_INSP, CLEAN_INSP, LABOUR_RETURN.

Export

iCWP XML within 24 hours

DSR-compliant XML builders with SFTP push transport. Incremental sync via last_sync_time parameter.

Endpoint	Method	Description
/api/v1/{module}/records	GET	Incremental sync — filter by contract, status, date range
/api/v1/attachments/{file_id}	GET	Pre-signed attachment URL (30-min expiry)
/scm/api/ingest/events/	POST	SSSS vendor telemetry ingest — token authenticated
/scm/api/events/	GET	Paginated telemetry event list for iCWP
/scm/api/alerts/	GET	Paginated safety alert list

Smart Construction, Smart Document, iCWP — All Compliant