Resident Council platform model

The Resident Council uses small, independently deployed services rather than one application. Residents usually start at the Resident Council website.

Resident Council documentation covers:

  • the Resident Council website, the public directory and information hub;
  • Resident voting, which manages invitations, ballots, and published results;
  • IHNYC Games, which publishes events, signup links, rosters, results, and standings;
  • the RC Console, which manages the council roster, positions, terms, handover, and public-member publishing;
  • the in-development mobile app shell and the decommissioned Gallery as lifecycle records.

House Desk and Pub remain discoverable from the Resident Council website, but they are separate products with their own repositories, access, permissions, releases, and documentation.

Separate product boundary

RC Console does not authorize House Desk or Pub operators. Affective Technologies publishes their canonical documentation at docs.ihnyc.affectivetech.com.

Public and protected surfaces

SurfaceAccess modelRole
Resident Council websitePublic, with protected data toolsCouncil information and service directory
Resident votingInvitation or magic-link token; protected administrationElections, ballots, and approved results
IHNYC GamesPublic site; protected administrationEvents, signups, results, and standings
RC ConsoleProtected council accessCouncil roster, terms, handover, and publishing

Service map

flowchart LR
  RESIDENT["Residents and guests"] --> SITE["Resident Council website"]
  SITE --> VOTE["Voting"]
  SITE --> GAMES["IHNYC Games"]

  COUNCIL["Authorized council operators"] --> CONSOLE["RC Console"]
  CONSOLE -->|"public member feed"| SITE
  CONSOLE -.->|"role-owner feed only"| CASEWORK["Council casework"]

  SITE -.->|"external product"| DESK["House Desk"]
  SITE -.->|"external product"| PUB["Pub"]

The dotted product links show discovery, not shared administration or runtime dependence.

Common Resident Council patterns

  • Public information remains available without administrator credentials.
  • Protected areas use edge access controls and application checks appropriate to each service.
  • Secrets are deployment configuration and never belong in documentation.
  • Structured operational data is commonly stored in D1; files and generated artifacts may use R2.
  • Public APIs use explicit response and error contracts documented in API contracts.

See Security model for trust boundaries and Naming conventions for exact RC vocabulary. For House Desk and Pub architecture, use the IHNYC Service Docs.