NBTCA Calendar

Calendar feeds for NBTCA, served from one Cloudflare Worker at ical.nbtca.space.

Routes

• / preserves the existing daily-affairs subscription during migration. Its content matches /events.ics.
• /events.ics proxies the association Google Calendar, NBTCA 计算机协会日历. Subscribe with webcal://ical.nbtca.space/events.ics.
• /school.ics is generated from the reviewed files in data/school/. Subscribe with webcal://ical.nbtca.space/school.ics.
• /project.ics is generated from NBTCA Project 5. An item uses its Start date and End date when either is set. Otherwise it uses its Iteration, from the iteration start through its duration. Closed issues and pull requests, and items whose Status is Pause, are left out. Subscribe with webcal://ical.nbtca.space/project.ics. The Worker needs a GITHUB_TOKEN secret with read:project. Each proxied or generated feed keeps its own last-good copy, so one source failing cannot replace another.

Birthday publication and access control are intentionally out of scope until a privacy policy is agreed.

Development

pnpm install
pnpm import:school
pnpm build
pnpm check
pnpm dev

The DTEND value in generated ICS is exclusive. Source data therefore uses the explicit field name endDateExclusive to avoid accidental off-by-one errors. The generated dist/school.ics is ignored by Git and is rebuilt from YAML for every check and every direct Wrangler operation through its configured build hook.

Deployment

The project manages the existing Cloudflare Worker named ical. Always deploy a preview and verify all routes before replacing the production deployment.

The production rollback baseline recorded before this migration is Worker version 1487e0c0-a969-454f-8bcb-55f7f01876fb.

Project schedule sync

sync/ is a second Worker, nbtca-project-calendar. Every 15 minutes it reads organization project 5 and mirrors the same dated items as /project.ics onto a separate Google Calendar. pnpm deploy does not publish this Worker, and it does not add a route to ical.nbtca.space.

A project end date is inclusive. Google Calendar's all-day end date is exclusive, matching endDateExclusive in the school calendar. An item with only one of the two dates becomes a one-day event. An iteration span ends after its duration. Items with neither dates nor an iteration, closed issues and pull requests, items whose Status is Pause, and items that leave the project, have the event created by this sync removed. Events on that calendar without this sync's private marker stay in place.

Credentials stay in Worker secrets:

wrangler secret put GITHUB_TOKEN -c sync/wrangler.jsonc
wrangler secret put GOOGLE_CLIENT_ID -c sync/wrangler.jsonc
wrangler secret put GOOGLE_CLIENT_SECRET -c sync/wrangler.jsonc
wrangler secret put GOOGLE_REFRESH_TOKEN -c sync/wrangler.jsonc
wrangler secret put GOOGLE_CALENDAR_ID -c sync/wrangler.jsonc
pnpm deploy:sync

GITHUB_TOKEN needs access to read the organization project. The Google refresh token is the one issued for scope https://www.googleapis.com/auth/calendar.app.created on the calendar that application created. A local run uses the same variables:

GITHUB_TOKEN=... GOOGLE_CLIENT_ID=... GOOGLE_CLIENT_SECRET=... GOOGLE_REFRESH_TOKEN=... GOOGLE_CALENDAR_ID=... pnpm sync