feat: restructure dHive knowledge into OKF layout

2026-07-25 15:18:58 +02:00
parent 2ad85ddf86
commit 4c7d48ae6d
24 changed files with 0 additions and 0 deletions
@@ -0,0 +1,16 @@
+# Component: Jury-Voting
+
+## Description
+Real-time jury voting app for UNIKAT Ideenwettbewerb events (React + Express + SSE)
+
+## Metadata
+- **Deployment Target:** vps-docker
+- **Upstream URL:** https://github.com/DoctoDre/Jury-Voting
+- **Status:** active
+
+## Interconnections
+- (to be documented)
+
+## Notes
+- Part of dhive context in the Orchestrator monorepo
+
@@ -0,0 +1,48 @@
+# Deployment
+
+## How It Works
+
+1. Push to `main` → GitHub Actions builds frontend + deploys to VPS (217.160.174.2)
+2. App runs as systemd service `jury-voting` on port 3002
+3. Caddy (managed via NoteGraph/Caddyfile) proxies `unikat.andreknie.de` → `localhost:3002`
+4. Score data persists in `/opt/jury-voting/server/data/session.json`
+
+## DNS Setup (one-time)
+
+Add an A record: `unikat.andreknie.de` → `217.160.174.2`
+
+Caddy handles HTTPS automatically via Let's Encrypt.
+
+## GitHub Secret
+
+- `DEPLOY_SSH_KEY` — SSH key for root@217.160.174.2 (already configured)
+
+## URLs
+
+- **Login:** `https://unikat.andreknie.de/?token=UNIKAT_jury`
+- **Results (beamer):** `https://unikat.andreknie.de/results`
+- **Admin:** `https://unikat.andreknie.de/admin`
+- **Password:** `UNIKAT_jury`
+
+## Future: Move to d-hive.de
+
+When ready to move to `unikat.d-hive.de`:
+1. Add DNS A record for `unikat.d-hive.de` → VPS IP
+2. Add `unikat.d-hive.de` block to Caddyfile (same as `unikat.andreknie.de`)
+
+## Manual Operations (on VPS)
+
+```bash
+# Check service status
+systemctl status jury-voting
+
+# View logs
+journalctl -u jury-voting -f
+
+# Restart
+systemctl restart jury-voting
+
+# Reset all scores (start fresh)
+rm /opt/jury-voting/server/data/session.json
+systemctl restart jury-voting
+```
@@ -0,0 +1,29 @@
+# Jury-Voting
+
+Real-time jury voting application for the UNIKAT Ideenwettbewerb.
+
+## Stack
+
+- Frontend: React 19 + Vite
+- Backend: Express.js
+- Persistence: JSON file-based
+- Real-time: Server-Sent Events (SSE)
+
+## URLs
+
+- Production: https://unikat.andreknie.de
+- Admin: /admin
+- Results/Beamer: /results
+
+## Development
+
+```bash
+npm install
+npm run dev
+```
+
+## Deployment
+
+Push to main triggers GitHub Actions -> SSH to VPS -> systemd restart.
+Port 3002 on VPS, Caddy reverse proxy.
+