System Overview · 系統概覽

How the System Works

系統如何運作

An at-a-glance overview of the end-to-end Champions for Good Awards system — designed for HKCSS team, partners, and vendors to track progress and understand the full picture.

Section A — End-to-End Flow · 端對端流程

System Architecture

How applicants, judges, and the public move through the Champions for Good ecosystem. 申請人、評審及公眾如何在至善獎生態系統中參與。

🌐

Step 1

Public Portal

hkcss.recruitai.studio

Applicants discover the awards, read criteria, and access Award Force. The public explores awardees and the awards journey.

Next.js · Nginx · AWS EC2

📝

Step 2

Apply (Award Force)

Applicant Portal

Applicants register, complete structured entry forms in EN / zh-HK, upload documents, and track submission status.

Award Force SaaS

⚖️

Step 3

Round 1 Judging

Panel Scoring

Independent judges score all eligible entries against published criteria via Award Force. Shortlist is produced.

Award Force SaaS

🎤

Step 4

Round 2 Judging

Presentations & Q&A

Shortlisted finalists present to the panel. Judges send asynchronous questions; entrants reply. Structured feedback generated.

Award Force SaaS

🏆

Step 5

Gala Ceremony

24 Sep 2026

Winners announced at the annual Champions for Good Gala. Grand Prix and all category winners celebrated.

Physical Event

🗳️

Step 6

Public Voting

Oct – Nov 2026

All finalists go to public vote. HK residents vote via OTP-verified platform. Public Voting Award winner announced.

Separate Voting Platform (Phase 2)

🌐

Step 1

Public Portal

hkcss.recruitai.studio

Next.js · Nginx · AWS EC2

📝

Step 2

Apply (Award Force)

Applicant Portal

Award Force SaaS

⚖️

Step 3

Round 1 Judging

Panel Scoring

Award Force SaaS

🎤

Step 4

Round 2 Judging

Presentations & Q&A

Award Force SaaS

🏆

Step 5

Gala Ceremony

24 Sep 2026

Physical Event

🗳️

Step 6

Public Voting

Oct – Nov 2026

Separate Voting Platform (Phase 2)

Public PortalAward ForcePhysical / EventFuture Platform

Section B — Feature Status · 功能狀態

Feature Development Progress

All features grouped by module. Status is updated as development progresses. 所有功能按模組分類，狀態隨開發進度更新。Last updated: March 2026.

Status 狀態:Planned· 計劃中In Progress· 進行中In UAT· 測試中Live· 已上線On Hold· 暫緩

🌐

Public Portal

公眾入口網站

8/10 live

80%

Feature	Code	Owner	Status	Notes
Homepage with hero, mission pillars & CTAs 主頁（英雄區、使命要點及行動呼籲）	`PORTAL_HOME`	Vendor	Live	—
About / background & awards history page 關於頁面 ── 獎項背景及歷史	`PORTAL_ABOUT`	Vendor	Live	—
Award categories & eligibility page (12 categories) 獎項組別及申請資格頁面（12個組別）	`PORTAL_CATEGORIES`	Vendor	Live	—
Judging process, criteria & rubric page 評審流程、準則及評分標準頁面	`PORTAL_PROCESS`	Vendor	Live	—
2026 cycle timeline & key dates page 2026年度時間表及重要日期頁面	`PORTAL_TIMELINE`	Vendor	Live	—
Past awardees gallery with cycle filter 歷屆得獎機構展覽（可按年份篩選）	`PORTAL_AWARDEES`	Vendor	Live	—
FAQ & contact page 常見問題及聯絡頁面	`PORTAL_FAQ`	Vendor	Live	—
System flow & features progress page 系統流程及功能進度頁面	`PORTAL_SYSTEM`	Vendor	Live	This page — powered by backend feature tracking API in Phase 2
zh-HK / EN language switcher 繁體中文 / 英文語言切換	`PORTAL_LANG_SWITCH`	Vendor	Planned	Phase 2 — i18n with next-intl
Live content from CMS / backend API 從內容管理系統 / 後端 API 讀取即時內容	`PORTAL_CMS_INTEGRATION`	HKCSS_Vendor	Planned	Phase 2 — replaces static data files with API fetches

📋

Award Force

申請及評審平台

1/13 live

Feature	Code	Owner	Status	Notes
Round 1 applicant entry form (all 12 categories) 第一輪申請表（12個組別）	`AWF_APPLICANT_FORM_R1`	HKCSS_Vendor	In UAT	Bilingual fields; eligibility auto-score integrated
Round 2 form for shortlisted entries 入圍機構第二輪申請表	`AWF_APPLICANT_FORM_R2`	HKCSS_Vendor	Planned	Deeper outcomes, evaluation results, case stories
Eligibility auto-scoring & moderation rules 申請資格自動評分及審查規則	`AWF_ELIGIBILITY_AUTOSCORE`	HKCSS	In Progress	HKCSS membership, Chest/SWD status, previous award checks
Round 1 review workflow & stage transitions 第一輪審核流程及階段轉換	`AWF_WORKFLOW_R1`	HKCSS	In Progress	Submitted → Under Review → Shortlisted / Not Shortlisted
Round 2 review workflow & stage transitions 第二輪審核流程及階段轉換	`AWF_WORKFLOW_R2`	HKCSS	Planned	Invited → Under Review → Final Awarded / Not Awarded
Round 1 VIP judging panel & score set 第一輪評審委員會評分組	`AWF_ROUND1_JUDGING`	AwardForce	In Progress	Multi-criterion scoring; conflict-of-interest declaration
Round 2 VIP judging panel & score set 第二輪評審委員會評分組	`AWF_ROUND2_JUDGING`	AwardForce	Planned	Presentation + detailed rubric; requires R1 shortlist
Internal Popularity Award voting (Award Force) 內部最具人氣服務獎投票（Award Force）	`AWF_POPULARITY_VOTING`	AwardForce	Planned	Separate from public OTP voting — internal panel only
Automated email notification templates 自動電郵通知範本	`AWF_NOTIFICATIONS`	AwardForce	In UAT	Registration confirm, submission confirm, R2 invite, results, feedback
Judge–Entrant asynchronous Q&A comment system 評審與申請人異步問答系統	`AWF_JUDGE_QA`	AwardForce	Planned	Judge flags comment → email to entrant → structured reply → audit trail
Post-judging score & comment feedback to entrants 評審後向申請人分享評分及評語	`AWF_FEEDBACK_TO_ENTRANTS`	HKCSS	Planned	Selective criteria & comment visibility after results finalised
zh-HK bilingual form field support 繁體中文雙語表格欄位支援	`AWF_BILINGUAL_FORMS`	AwardForce	In Progress	All fields have EN + zh labels and help text
Reporting dashboard & CSV / Excel export 報告儀表板及 CSV / Excel 匯出	`AWF_REPORTING_EXPORT`	AwardForce	Live	Built-in Award Force analytics

🗳️

Public Voting Platform

公眾投票平台

0/6 live

Feature	Code	Owner	Status	Notes
SMS OTP verification for public voters (HK mobile) 公眾投票者短訊 OTP 驗證（香港手機號碼）	`VOTING_PUBLIC_OTP`	Vendor	Planned	One vote per unique HK number; bcrypt-stored OTP; Phase 2 Oct 2026
Finalist profile cards & category gallery 入圍機構簡介卡片及組別展覽	`VOTING_NOMINEE_GALLERY`	Vendor	Planned	Populated from backend nominees table
Vote submission & confirmation flow 投票提交及確認流程	`VOTING_SUBMISSION`	Vendor	Planned	UNIQUE DB constraint + transaction prevents duplicates
Admin real-time vote count dashboard 管理員即時投票統計儀表板	`VOTING_ADMIN_DASHBOARD`	Vendor	Planned	Uses vote_counts cache table (DB trigger updated)
Anti-fraud & duplicate vote detection 防止舞弊及重複投票偵測	`VOTING_ANTICHEAT`	Vendor	Planned	Per-phone rate limiting, IP throttling, attempt_count cap
Scheduled public results reveal 定時公布公眾投票結果	`VOTING_RESULTS_REVEAL`	HKCSS	Planned	Admin-toggled visibility after HKCSS sign-off; Nov 2026

⚙️

Backend / API

後端 / API

2/9 live

22%

Feature	Code	Owner	Status	Notes
AWS EC2 / Docker / Nginx hosting infrastructure AWS EC2 / Docker / Nginx 主機架構	`BACKEND_INFRA_EC2`	Vendor	Live	AWS EC2 + Nginx + Docker; Singapore region
CI/CD pipeline (GitHub Actions → ECR → EC2) 持續整合及部署流程（GitHub Actions → ECR → EC2）	`BACKEND_CICD`	Vendor	Live	Auto-deploy on push to main; separate portal + API images
Admin JWT authentication (httpOnly cookie + Bearer) 管理員 JWT 身份驗證（httpOnly cookie + Bearer）	`BACKEND_AUTH_ADMIN`	Vendor	In Progress	Dual-token: admin JWT + voter JWT with separate secrets
Content management REST API (categories, timeline, awardees, FAQs) 內容管理 REST API（組別、時間表、得獎者、常見問題）	`BACKEND_CONTENT_API`	Vendor	In Progress	Public GET + admin CRUD; NestJS ContentModule
Feature status tracking API 功能進度追蹤 API	`BACKEND_FEATURES_API`	Vendor	In Progress	Powers this page live in Phase 2; /api/v1/features/overview
Public voting REST API 公眾投票 REST API	`BACKEND_VOTING_API`	Vendor	Planned	Nominees, OTP request/verify, vote cast, vote stats
Twilio SMS OTP service Twilio 短訊 OTP 服務	`BACKEND_OTP_SMS`	Vendor	Planned	CSPRNG 6-digit; bcrypt hash only; never logs plaintext; Phase 2
Rate limiting, Helmet, CORS & security hardening 請求限速、Helmet、CORS 及安全加固	`BACKEND_SECURITY`	Vendor	In Progress	Global throttler; per-route OTP/vote overrides; OWASP top 10
Award Force REST API integration Award Force REST API 整合	`BACKEND_AF_INTEGRATION`	Vendor	Planned	Phase 2 — sync entries & results from Award Force to backend

Infrastructure

Technical Overview

☁️

Hosting

·AWS EC2 (Singapore region)
·Docker + Nginx
·ECR for container registry
·Deploy via GitHub Actions

📋

Award Force

·SaaS application management
·Entry forms, judging, Q&A
·Subdomain: hkcss.awardsplatform.com
·API integration: Phase 2

🗳️

Public Voting

·Separate platform (Phase 2)
·OTP verification (HK mobile)
·One vote per person
·Launches Oct 2026

For internal use · 供內部參考。 This page is publicly accessible but intended primarily for HKCSS staff, vendors, and close partners. Feature statuses are updated manually — contact the project lead to update any entry. 本頁公開瀏覽，主要供社聯員工、供應商及合作夥伴參考。功能狀態需人手更新，如需修改請聯絡項目負責人。 Last updated: March 2026.