CUVETSMO Docs

What is CUVETSMO?

CUVETSMO — สโมสรนิสิตคณะสัตวแพทยศาสตร์ จุฬาฯ — เป็น student union ของคณะสัตวแพทย์ จุฬาฯ. WebCUVETSMO is the open-source web platform built by Palm (Vet 86) for the union — it handles the official 16-state project approval workflow, the 22 student clubs, the 12-month event calendar, AI chat, a marketplace, and more.

This site is the developer wiki + ecosystem governance hub: how the system is built, how to run it locally, how to ship your first PR, how to hand it off — and the Ecosystem Map of every sibling repo and subdomain so nothing gets rebuilt twice. ไม่ใช่ user manual ของ end-user — สำหรับเรื่องนั้นไป cuvetsmo.com

Ecosystem Map Every repo, subdomain, and its locked canonical role — the no-duplication map for the whole CUVETSMO ecosystem. Read this before building anything new.

Architecture Deep technical reference — system overview, data model, RLS, edge functions, storage, 16-state workflow. The single source of truth for schema and system shape.

SSO Design Design draft for cross-app identity linking VetMock + Hanong + CUVETSMO. Options, milestones, risks, decisions log.

Developer Onboarding From zero to first PR merged in about 60 minutes. Pre-requisites, clone-and-run, first-feature exercise, pre-push checklist.

Successor Guide Annual handover playbook — assets to inherit, mentorship cadence, critical decisions not to undo, break-glass recovery steps.

Built for handover

WebCUVETSMO is intentionally documented so the next IT lead can take it over fully — not just keep it running, but extend it without Palm in the loop. Every page in this docs site is sourced from the docs/ folder of the WebCUVETSMO repo so docs and code stay in sync.

Found something outdated? Use the Edit page link at the bottom of any page to open a PR.

Open source

MIT-licensed. Anyone can fork, contribute, or self-host. Source code at palmzamak2547/WebCUVETSMO.

Modern stack

React 19, Vite 6, TypeScript, Tailwind CSS 3, Supabase (Postgres + Auth + Storage + Edge Functions), React Router 6, PWA-ready.

Production grade

Row-level security on every table, 16-state approval workflow, audit log, web push, Sentry error monitoring, automated CI on every PR.

Made for students

Built by Vet 86, for Vet 87, 88, 89 — and beyond. Annual handover ritual in May–June keeps the lights on across cohorts.

Quick links

• Production app — cuvetsmo.com
• Source code — github.com/palmzamak2547/WebCUVETSMO
• Docs source — github.com/cuvetsmo/docs
• Parent org — Faculty of Veterinary Science, Chulalongkorn University (vet.chula.ac.th)

---

Maintained by the SMO IT lead. Current keeper: Palm Anuthin (Vet 86). Handover happens every May–June.