University of Peradeniya crestSCS Documentation
University of Peradeniya crestSCS Documentation
Department website

Start here

Repository handbookRepository overviewDevelopment

System design

ArchitectureAuthentication and authorizationPublic dataAPI contractsSchemas
UI system

Applications

Department Web applicationPeople applicationProjects applicationPortal application

Services

API serviceGitHub App serviceMailer service
Service internals

Shared packages

Schemas packageUI packageTypeScript configuration packageESLint configuration package

Development workflow

Testing and verificationDependency managementDocumentation authoringUI quality assurance

Operations

Continuous integrationEnvironment variablesOperationsSecurityTroubleshooting

Reference

Route referenceGlossary
Service internals

Code-derived guides to the API, GitHub App automation, and Mailer runtimes and their boundaries.

Service internals

The three backend services form a trust chain, but each remains independently deployable and owns a different kind of state.

ServicePublic trust boundaryState it ownsMain downstream dependency
APIauthenticated Portal requestsBetter Auth, permissions, proxy settingsGitHub App and Mailer
GitHub Appinternal API requests onlydurable operation records and resource leasesGitHub repositories
Mailerinternal bearer-authenticated requestsno application databaseSMTP provider

The API contracts page is the canonical transport reference, Environment variables is the configuration inventory, and Operations owns deployment and recovery procedures. These service guides explain how the implementation joins those pieces together.

Mailer service

Authenticated send route, React Email templates, validation, SMTP configuration, and verification.

API internals

Source map, responsibilities, dependencies, and verification boundaries for the browser-facing API Worker.

On this page

Service internals