Management Hub sitemap

Input

username, password, remember-me

Reads

hub_users + roles (Postgres, care_auth)

Output

Signed session cookie; redirect to Tổng quan

Input

Signed invite token from the email link; new password twice

Reads

Token (HMAC, expiring)

Output

User password set (hub_users)

Public, token-authed. Reached from the invite email sent by Quản trị > Tài khoản.

Input

-

Reads

-

Output

Notice page when a user opens an area their role does not grant

Input

-

Reads

readyz: each configured data mount (hub_reads.readiness)

Output

JSON ok / not-ready (Cloud Run probes)

Input

-

Reads

Media registry + bundle STATUS.md files + Dashboard Sheet rows (content); care counts; finance counts

Output

Counts + links: bundles awaiting approval, activities waiting for photos, care alerts, finance items

Input

-

Reads

Dashboard Sheet rows + media registry (hub_reads.trip_ledger); the user's own unsent drafts (registry.activity_draft)

Output

Every activity with its state (cho-upload / dang-xu-ly / cho-duyet / ...) and unsent drafts

Input

Brief fields (date, name, place, programme, activity type, participants from care.person, direction), optional photos/videos

Reads

Own draft (registry.activity_draft); care.person search for participants

Output

Drive 1_Hoat-dong-truyen-thong/vao/<YYYY-MM-DD>__<slug>/{photos,videos}/ + brief.yaml; Dashboard row (state cho-upload); uploads routed by MIME into photos/ or videos/; draft deleted

Input

event_slug

Reads

brief.yaml (hub_reads.brief_view); Drive photos/ listing + cached thumbs; comment thread

Output

Brief panel, photo set, 'Yêu cầu viết bài' (request story) button, góp ý thread

Input

-

Reads

registry.post rows (hub_reads.presence_summary)

Output

Published-post counts and cadence; zeros until posts exist (no invented numbers)

Input

-

Reads

Postgres survey.candidate (hub_reads.survey_candidates)

Output

Candidates by state: cho-xet-chon / da-chon / tu-choi

Input

Phiếu khảo sát fields: child name, DOB (dd/mm/yyyy), school, carer, family members, circumstances, ghi chú

Reads

Existing cases (duplicate check)

Output

Case id ung-vien-NNNN; Drive 2_Hoc-sinh/Khao-sat/<date>__ung-vien-NNNN/anh/ + phieu-khao-sat.yaml; survey.candidate row (cho-xet-chon); care.person for the child + matched-or-created carer relation

Input

Excel/CSV, one row per child (template downloadable)

Reads

Existing cases

Output

One candidate per row via the same create_survey_folder path

Input

case_id

Reads

Postgres survey.candidate + edit log; Drive Khao-sat/<case>/anh/ media; care.person family context + match suggestions; comments

Output

Full phiếu, photos, 'family already surveyed' banner, decision buttons

Input

Same fields as new

Reads

Current phiếu + ghi chú entries

Output

survey.candidate updated + candidate_edit_log row per change

Input

Photos/videos from the phone camera, optional description

Reads

Candidate summary

Output

Files PUT straight from the browser to the private GCS relay bucket; on finalize the survey-media-commit Job converts and files them

Input

q, school, status, programme, grade, group, page

Reads

Postgres care.* (child, enrolment, school, programme); needs-review count

Output

Filtered roster, grouped; sidebar sub-links per programme

Input

Selected student codes + action (graduate / transfer / pause / withdraw / new class) and its fields

Reads

Current child rows

Output

Preview of who changes and who is skipped; apply writes all in one transaction: child update, ghi_danh enrolment, one dated profile_entry per student

Input

student_code

Reads

Postgres care.*: child, enrolment milestones, benefits, profile_entry journal, school_report transcript, source_doc; care.person family + match suggestions; registry Hành trình posts featuring the student; survey photos

Output

Dossier, newest-first history lists (latest 3 open), action forms

Input

doc_type (hoc-ba, so-diem, chuyen-can, hop-phu-huynh, ...) + PDF

Reads

PDF, Opus extraction engine

Output

Review form pre-filled with the extraction; on commit: school_report row + Block-3 note (confirmed_by = the coordinator)

Input

School + doc_type + many PDFs

Reads

School roster for name matching

Output

Batch with each PDF name-matched; background extraction; per-item review then commit to the chosen student

Input

Photos/videos

Reads

Child row

Output

Browser PUTs to the GCS relay; finalize triggers survey-media-commit with the student code: WebP re-encode (EXIF/GPS strip), named <code>__anh__<năm-học>__<NNN>, filed in Ho-so/.../Tai-lieu-goc/, catalogued as source_doc

Input

nam_hoc; builder fields; photo picks or uploads; action save / AI draft / render

Reads

Child record digest for the year, petal counts, media

Output

annual_report_store config; AI draft (Opus); render queued as report_index kind=annual (HTML + PDF)

Input

-

Reads

Postgres care.* (GPA, petals, benefits by school/year) + finance ledger read-only (received by year)

Output

Programme-wide charts and tables

Input

School + năm học / programme + cohort year / năm học

Reads

care.report_index (status list)

Output

Queues a report; list shows dang-tao then a link when da-xong (or loi)

Input

-

Reads

Open watchlist items raised by the watchlist Jobs

Output

Items to review; close / escalate with a note

Input

Triggered from the dossier or nightly by care-handbook-refresh

Reads

Whole care record for one student

Output

Branded native Google Doc in the student folder (identity, enrolment, transcript, benefits, journal, Tài liệu gốc index, update log)

Input

-

Reads

Pending source_file_review rows

Output

Approve / reject per row, bulk approve for backlog

Input

-

Reads

content-plan.yaml (directions, 12-month roadmap, 3-month board) + registry.post coverage flags (petal gaps, 80/20, observances, orphan trips)

Output

Board with read-time flags

Input

-

Reads

Bundles bucket posts/<slug>/STATUS.md

Output

Bundles grouped by state, attention-first (awaiting-approval, in-review, revising)

Input

slug

Reads

STATUS.md gate findings, copy/facebook.md, renditions

Output

Caption editor + photos + decision form

Input

-

Reads

Finance registry totals by entity

Output

Summary tiles

Input

province, opt_in, returning, entity

Reads

donor table

Output

Filtered donor list; GET /finance/donors/{id} for one donor's history

Input

entity

Reads

contribution table

Output

Contributions with thank-you status

Input

entity

Reads

in-kind table

Output

In-kind gifts list

Input

-

Reads

Statements directory on the mount

Output

Evidence files for preview / download (GET /finance/sao-ke/file)

Input

month, kind, entity

Reads

Finance registry for the month

Output

Monthly transparency report view

Input

list_slug

Reads

Finance registry lists

Output

One list

Input

display name, partner flag, province, level, notes

Reads

care school table + usage counts (students, survey cases)

Output

School rows used by roster, survey, reports, score cards

Input

display name, code, active, requires partner school, notes

Reads

care programme table

Output

Programme rows used by admission, benefits, reports, sidebar filters

Input

Thresholds + per-signal toggles

Reads

care.alert_config

Output

Rules read by the watchlist Jobs and the per-school report

Input

q; add form: full name, DOB, address, contact, note

Reads

care.person + relations; match suggestions

Output

Two-step add (check for matches, then confirm); person detail with gallery (survey + student + direct photos), portrait, relations

Input

-

Reads

-

Output

Points to /finance/donors (donor master still lives in the finance registry)

Input

username, display name, email, role, modules, invite or password

Reads

hub_users, roles, audit

Output

Account created; invite email with a set-password link

Input

role key, label, right codes

Reads

roles + role_rights

Output

Which sidebar areas and actions each role can use

Input

entity; overview + profile text; board members; documents (file or URL)

Reads

Legal store (registry DB), governance index

Output

Per-entity profile, board list, registration documents (uploaded to 5_Quan-tri-thuong-hieu/Quan-tri/Dang-ky-va-giay-phep/<entity>/)

Input

-

Reads

tools/INDEX.md; survey-sanitise sweep state

Output

Tool index; buttons for on-demand Jobs

Input

-

Reads

Live Postgres schema + column descriptions

Output

Every schema / table / column with type and meaning

Input

Session toggle GET /debug-tools/on | /off

Reads

Varies

Output

Orphaned-comment purge; people backfill (dry run then apply, triage file); university-enrolment split; family-relations backfill (Opus draft, per-case review, apply via care-family-relations-backfill Job); student purge

Input

section, title, description, URL, group

Reads

Help items (registry DB)

Output

Grouped link list with view / make-a-copy URLs

Input

JSON bodies

Reads

Same stores as the matching page

Output

JSON