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
Application internals
Projects application internalsProjects collection routes and searchProjects data and details

Services

API serviceGitHub App serviceMailer service

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
Application internalsProjects internals

Runtime map of project discovery paths, canonical filters, published data, detail rendering, and related-project ranking.

Projects application internals

apps/projects is a public showcase, not an editor. It turns published project records into stable path-based browse, type, category, topic, search, and detail routes. Portal owns changes to those records.

The server route validates path shape and builds metadata; interactive directories and detail views fetch their published data in the browser. Read Collection routes and search before changing URLs or filters, and Data and details before changing fetching, validation, record presentation, or related projects.

People profile interpretation

How staff and student fields become labelled profile sections, how directory context differs from academics, and how project roles are shown.

Projects collection routes and search

Canonical path grammar, project types, categories, topics, search matching, pagination, metadata, and retired query state.

On this page

Projects application internals