Upload 5 files

.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+data/votes.xlsx
+.env

README.md

@@ -1,11 +1,49 @@
----
-title: BOU 2026
-emoji: 🦀
-colorFrom: gray
-colorTo: red
-sdk: static
-pinned: false
-short_description: This Page is for Voting Purpose
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# BOU 2026 — Best Project voting app
+
+A small self-hosted voting app for the 7 BOU 2026 projects. Every vote is written
+as a row (Name, UID, Email, Project, Timestamp) into an Excel file on the server —
+no external database needed.
+
+## What's included
+- `server.js` — Node/Express backend. Handles voting and keeps `data/votes.xlsx` up to date.
+- `public/index.html` — the page voters use.
+- `public/admin.html` — organizer-only results page (tallies + Excel download), protected by an admin key.
+- `data/votes.xlsx` — created automatically on the first vote. **Not included** — don't commit it, it contains personal data (names/UIDs/emails).
+
+## Requirements
+This needs a **Node.js host with persistent disk storage** — it writes to a real
+file, so it won't work on static hosting (GitHub Pages, S3, etc.) or on
+serverless platforms whose filesystem resets between requests (e.g. Vercel/Netlify
+functions). It runs fine on a VPS, an internal company server, Render/Railway
+"web service" (not "static site"), or any machine you control. Node.js 18+ is recommended.
+
+## Setup
+```bash
+npm install
+ADMIN_KEY="pick-a-real-secret" npm start
+```
+The app listens on port 3000 by default (override with `PORT=xxxx`).
+
+- Voters go to: `http://your-host:3000/`
+- You (organizer) go to: `http://your-host:3000/admin.html` and enter the `ADMIN_KEY`
+  you set above to see live results and download the Excel file.
+
+**Set a real `ADMIN_KEY`** before sharing the link with anyone — anyone who knows
+the key can see all voters' names/UIDs/emails and the current tally. Without it set,
+the server starts with a placeholder key and prints a warning.
+
+## How voting works
+- A voter fills in Name, UID, and Email, then picks one project and submits.
+- Votes are matched by UID: if the same UID votes again, their row is **updated**
+  (their vote changes) rather than duplicated — so one person can't stack votes.
+- Writes are queued in the server so two people voting at the same instant can't
+  corrupt the Excel file.
+
+## Changing the project list
+Edit the `PROJECTS` array near the top of `server.js` (and nowhere else — the
+voting page loads the list from the server automatically).
+
+## Privacy note
+The Excel file holds personal data (name, UID, email) for every voter. Store it
+somewhere access-controlled, delete it once the vote is over if you don't need
+to retain it, and don't commit it to a public repo.

package.json

@@ -0,0 +1,14 @@
+{
+  "name": "bou2026-vote",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Standalone team voting app for Best Project - BOU 2026. Logs Name, UID and Email to an Excel file.",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js"
+  },
+  "dependencies": {
+    "express": "^4.19.2",
+    "exceljs": "^4.4.0"
+  }
+}

server.js

@@ -0,0 +1,152 @@
+// BOU 2026 - Best Project voting app
+// Serves the voting page and logs every vote (Name, UID, Email, Project, Timestamp)
+// into an Excel file on disk, one row per voter (re-voting updates their row).
+
+const path = require("path");
+const fs = require("fs");
+const express = require("express");
+const ExcelJS = require("exceljs");
+
+const PORT = process.env.PORT || 3000;
+const ADMIN_KEY = process.env.ADMIN_KEY || "change-me"; // set a real secret before deploying
+const VOTES_FILE = path.join(__dirname, "data", "votes.xlsx");
+
+const PROJECTS = [
+  { id: "1", name: "Global Account – DAS (Adecco)", who: "Sathiaseelan Arumugam" },
+  { id: "2", name: "PCB & IC Package Team", who: "Syam" },
+  { id: "3", name: "Product Engineering / Embedded", who: "Munajat Abdul Hadi" },
+  { id: "4", name: "CIS", who: "Shunmuganainar Chockalingam" },
+  { id: "5", name: "ATE", who: "Kother" },
+  { id: "6", name: "Manufacturing POD", who: "Rohan Chowdhary" },
+  { id: "7", name: "Manufacturing", who: "Hasrul Hasni" },
+];
+const PROJECT_IDS = new Set(PROJECTS.map((p) => p.id));
+
+const HEADERS = ["Name", "UID", "Email", "Project ID", "Project Name", "Timestamp"];
+
+// --- tiny write queue so concurrent votes never corrupt the Excel file ---
+let writeQueue = Promise.resolve();
+function withWriteLock(fn) {
+  const result = writeQueue.then(fn, fn);
+  writeQueue = result.catch(() => {});
+  return result;
+}
+
+async function loadWorkbook() {
+  const wb = new ExcelJS.Workbook();
+  if (fs.existsSync(VOTES_FILE)) {
+    await wb.xlsx.readFile(VOTES_FILE);
+  } else {
+    fs.mkdirSync(path.dirname(VOTES_FILE), { recursive: true });
+    const ws = wb.addWorksheet("Votes");
+    ws.addRow(HEADERS);
+    ws.getRow(1).font = { bold: true };
+  }
+  const ws = wb.getWorksheet("Votes") || wb.addWorksheet("Votes");
+  if (ws.rowCount === 0) {
+    ws.addRow(HEADERS);
+    ws.getRow(1).font = { bold: true };
+  }
+  return { wb, ws };
+}
+
+async function recordVote({ name, uid, email, projectId }) {
+  return withWriteLock(async () => {
+    const { wb, ws } = await loadWorkbook();
+    const project = PROJECTS.find((p) => p.id === projectId);
+
+    // find an existing row for this UID (column 2) so re-voting updates it
+    let existingRow = null;
+    ws.eachRow((row, rowNumber) => {
+      if (rowNumber === 1) return;
+      if (String(row.getCell(2).value) === String(uid)) existingRow = row;
+    });
+
+    const values = [name, uid, email, project.id, project.name, new Date().toISOString()];
+    if (existingRow) {
+      existingRow.values = [, ...values]; // keep 1-based column alignment
+    } else {
+      ws.addRow(values);
+    }
+
+    await wb.xlsx.writeFile(VOTES_FILE);
+  });
+}
+
+async function tallyResults() {
+  const { ws } = await loadWorkbook();
+  const counts = {};
+  let total = 0;
+  const voters = [];
+  ws.eachRow((row, rowNumber) => {
+    if (rowNumber === 1) return;
+    const projectId = String(row.getCell(4).value || "");
+    if (!projectId) return;
+    counts[projectId] = (counts[projectId] || 0) + 1;
+    total += 1;
+    voters.push({
+      name: row.getCell(1).value,
+      uid: row.getCell(2).value,
+      email: row.getCell(3).value,
+      projectId,
+    });
+  });
+  return { counts, total, voters };
+}
+
+// --- app ---
+const app = express();
+app.use(express.json());
+app.use(express.static(path.join(__dirname, "public")));
+
+app.get("/api/projects", (req, res) => res.json(PROJECTS));
+
+app.post("/api/vote", async (req, res) => {
+  const { name, uid, email, projectId } = req.body || {};
+  if (!name || !uid || !email || !projectId) {
+    return res.status(400).json({ ok: false, error: "Name, UID, email and a project choice are all required." });
+  }
+  if (!/^\S+@\S+\.\S+$/.test(email)) {
+    return res.status(400).json({ ok: false, error: "That email address doesn't look valid." });
+  }
+  if (!PROJECT_IDS.has(String(projectId))) {
+    return res.status(400).json({ ok: false, error: "Unknown project." });
+  }
+  try {
+    await recordVote({ name: String(name).trim(), uid: String(uid).trim(), email: String(email).trim(), projectId: String(projectId) });
+    res.json({ ok: true });
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ ok: false, error: "Could not save your vote. Please try again." });
+  }
+});
+
+function requireAdmin(req, res, next) {
+  const key = req.query.key || req.headers["x-admin-key"];
+  if (key !== ADMIN_KEY) return res.status(401).json({ ok: false, error: "Invalid admin key." });
+  next();
+}
+
+app.get("/api/results", requireAdmin, async (req, res) => {
+  try {
+    const { counts, total } = await tallyResults();
+    res.json({ ok: true, projects: PROJECTS, counts, total });
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ ok: false, error: "Could not load results." });
+  }
+});
+
+app.get("/api/export", requireAdmin, async (req, res) => {
+  if (!fs.existsSync(VOTES_FILE)) {
+    return res.status(404).json({ ok: false, error: "No votes recorded yet." });
+  }
+  res.download(VOTES_FILE, "bou2026-votes.xlsx");
+});
+
+app.listen(PORT, () => {
+  console.log(`BOU 2026 voting app listening on port ${PORT}`);
+  if (ADMIN_KEY === "change-me") {
+    console.warn("WARNING: set a real ADMIN_KEY environment variable before sharing this app.");
+  }
+});