test: add stable leaderboard regression coverage

package.json

@@ -29,7 +29,8 @@
     "start": "npm run build && NODE_ENV=development webpack-dev-server --host 0.0.0.0 --open --hot --config build/webpack.config.js",
     "build": "npm --prefix admin run build && NODE_ENV=production webpack --config build/webpack.config.js",
     "serve": "cd src/server && NODE_ENV=development node app.js",
-    "lint": "eslint ."
+    "lint": "eslint .",
+    "test": "node --test \"test/**/*.test.js\""
   },
   "husky": {
     "hooks": {

src/server/app.js

@@ -10,19 +10,33 @@ const app = express()
 const proxy = require('http-proxy-middleware')
 const path = require('path')
 
-const configPath = './config.json'
-const admindataPath = './admindata.json'
-const dataPath = '../assets/data/data.json'
-const logPath = '../assets/data/log.json'
-const port = jsonfile.readFileSync(configPath).serverPort
-const configBackupPath = '../../configBackup.json'
+function resolvePathFromEnv(envName, defaultRelativeToCwd) {
+    if (process.env[envName]) {
+        return path.resolve(process.env[envName])
+    }
+    return path.resolve(process.cwd(), defaultRelativeToCwd)
+}
+
+const configPath = resolvePathFromEnv('LEADERBOARD_CONFIG_PATH', 'config.json')
+const admindataPath = resolvePathFromEnv('LEADERBOARD_ADMINDATA_PATH', 'admindata.json')
+const dataPath = resolvePathFromEnv('LEADERBOARD_DATA_PATH', '../assets/data/data.json')
+const logPath = resolvePathFromEnv('LEADERBOARD_LOG_PATH', '../assets/data/log.json')
+const configBackupPath = process.env.LEADERBOARD_CONFIG_BACKUP_PATH
+    ? path.resolve(process.env.LEADERBOARD_CONFIG_BACKUP_PATH)
+    : path.resolve(process.cwd(), '../../configBackup.json')
+
+const httpPort =
+    process.env.LEADERBOARD_PORT !== undefined && process.env.LEADERBOARD_PORT !== ''
+        ? Number(process.env.LEADERBOARD_PORT)
+        : Number(jsonfile.readFileSync(configPath).serverPort)
+
 const proxyOption = {
-    target: 'http://localhost:' + port + '/',
+    target: 'http://localhost:' + httpPort + '/',
     pathRewrite: { '^/api': '' },
     changeOrigin: true,
 }
 const websocketProxyOption = {
-    target: 'http://localhost:' + port + '/',
+    target: 'http://localhost:' + httpPort + '/',
     changeOrigin: true,
 }
 
@@ -54,17 +68,17 @@ if (!fs.existsSync(admindataPath)) {
     jsonfile.writeFileSync(admindataPath, [])
 }
 
-// spawn - `node refresh.js`
-const refresh = spawn('node', ['refresh.js'], {
-    shell: true,
-    stdio: 'inherit',
-})
-process.on('exit', () => {
-    refresh.kill() // kill it when exit
-})
+if (process.env.LEADERBOARD_SKIP_REFRESH !== '1') {
+    const refresh = spawn('node', ['refresh.js'], {
+        shell: true,
+        stdio: 'inherit',
+    })
+    process.on('exit', () => {
+        refresh.kill()
+    })
+}
 
-const server = http
-    .createServer((req, res) => {
+const server = http.createServer((req, res) => {
         const route = url.parse(req.url).pathname
         const { adminPassword } = jsonfile.readFileSync(configPath)
 
@@ -109,7 +123,7 @@ const server = http
                 if (token === adminPassword) {
                     await Promise.all(
                         contributors.map(async (contributor) => {
-                            const admindata = jsonfile.readFileSync('./admindata.json')
+                            const admindata = jsonfile.readFileSync(admindataPath)
                             const existContributor = findContributor(
                                 contributor,
                                 admindata
@@ -408,7 +422,6 @@ const server = http
             break
         }
     })
-    .listen(port)
 
 const io = require('socket.io')(server)
 io.on('connection', (socket) => {
@@ -423,6 +436,10 @@ io.on('connection', (socket) => {
     })
 })
 
+server.listen(httpPort)
+
+module.exports = { server }
+
 function findContributor(contributorName, admindata) {
     let result = null
 

src/server/util/API.js

@@ -1,6 +1,12 @@
 const axios = require('axios')
-const Config = require('../config.json')
 const chalk = require('chalk')
+const path = require('path')
+
+const Config = require(
+    process.env.LEADERBOARD_CONFIG_PATH
+        ? path.resolve(process.env.LEADERBOARD_CONFIG_PATH)
+        : path.resolve(__dirname, '../config.json')
+)
 
 const BASEURL = 'https://github.com'
 const APIHOST = 'https://api.github.com'

test/README.md

@@ -0,0 +1,16 @@
+# Regression tests
+
+This directory holds automated regression tests for stable leaderboard behavior.
+
+`leaderboard-e2e.test.js` starts the current server code against a fixed Rocket.Chat snapshot and verifies that `/stats`, `/rank`, and selected `/contributor` and `/rank?username=` responses still match the checked-in expected output.
+
+Fixtures:
+
+- `../contrib/rocketchat/gsoc/2025/gsoc2025final.json` is the canonical snapshot used as the fixed leaderboard input.
+- `fixtures/gsoc2025final.expected.json` is the checked-in golden output generated from the current stable ranking logic and used for regression comparisons.
+
+Run from the repo root:
+
+```bash
+npm test
+```

test/fixtures/gsoc2025final.config.json

@@ -0,0 +1,12 @@
+{
+    "organization": "RocketChat",
+    "organizationHomepage": "https://rocket.chat/",
+    "organizationGithubUrl": "https://github.com/RocketChat",
+    "authToken": "",
+    "adminPassword": "123456",
+    "delay": "10",
+    "serverPort": "62050",
+    "contributors": [],
+    "startDate": "2024-12-01",
+    "includedRepositories": []
+}