sap-community-activity-badges: Instructions file for GitHub Copilot

Copilot Instructions — SAP Community Activity Badges

Project Overview

A Node.js/Express service that generates SVG/PNG badge cards showcasing SAP Community member achievements and activity stats. Also hosts the Devtoberfest interactive gameboard and a SAPUI5 Fiori Launchpad with selfie, profile, and tags apps.

• Production URL: https://devrel-tools-prod-scn-badges-srv.cfapps.eu10.hana.ondemand.com/
• License: Apache-2.0 (REUSE-compliant — see REUSE.toml)
• Docs: README.md, srv/doc/README.md

Tech Stack

Layer	Technology
Runtime	Node.js ≥22.0.0
Framework	Express 5.x
Image rendering	SVG composition + Sharp (PNG)
Templates	EJS (Fiori Launchpad shell)
Frontend	SAPUI5/Fiori Launchpad v1.136.4
i18n	@sap/textbundle + .properties files
Logging	@sap/logging + debug
Deployment	SAP BTP Cloud Foundry (MTA)

Commands

# From srv/
npm run dev          # Start with nodemon (port 4000)
npm run start        # Production start
npm run types        # Regenerate TypeScript declarations from JSDoc

# From root
npm run build        # MTA build (mbt build → MTAR artifact)

There are no automated tests (npm test is a stub). Validate changes manually by hitting endpoints.

Project Structure

srv/                        # All server-side code lives here
├── index.js                # Entry point (CommonJS)
├── express-server.js       # Express app setup, dynamic route loading
├── server/                 # Middleware stack (health, security, CORS, swagger, overload protection)
├── routes/                 # Each file exports (app) => { app.get(...) }
├── util/                   # Shared helpers (khoros API client, SVG builders, i18n, error renderer)
├── _i18n/                  # Message bundles (*.properties, 8 locales)
├── app/flp/                # SAPUI5 Fiori Launchpad SPA (selfie, profile, tags apps)
├── images/                 # Static assets (Devtoberfest themes, CSS, fonts, avatars)
├── html/                   # HTML fragments
├── views/                  # EJS templates
├── types/                  # Auto-generated .d.ts files (do not edit by hand)
├── *.mjs                   # ES Module CLI utilities (badgeCheck, contest, scavengerHunt, trees)
└── package.json            # Runtime dependencies