Merge branch 'v24' into patch-1

Author: MichaelK05-dev

.dockerignore

@@ -12,4 +12,4 @@ helm-charts
 .env
 .editorconfig
 .idea
-coverage*
+coverage*

.editorconfig

@@ -0,0 +1,12 @@
+# EditorConfig is awesome: https://EditorConfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+
+[*.sh]
+indent_size = 4

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ""
+labels: ""
+assignees: ""
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+
+- OS: [e.g. iOS]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+
+- Device: [e.g. iPhone6]
+- OS: [e.g. iOS8.1]
+- Browser [e.g. stock browser, safari]
+- Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/database_request.md

@@ -0,0 +1,67 @@
+---
+name: "📝 API/DB Feature Request"
+about: Suggest a new backend API or database feature
+title: "[Feature] <short description here>"
+labels: [feature, backend]
+assignees: ""
+---
+
+## ✨ API/Database Feature Request
+
+### Summary
+
+Describe the feature being requested. What functionality does it add to the backend or database? What problem does it solve?
+
+## 📘 Use Case
+
+Explain the use case behind this feature. Who is it for, and why is it needed now?
+
+## 📥 Example API Request
+
+```
+POST /api/example-endpoint
+Content-Type: application/json
+Authorization: Bearer <token>
+
+{
+  "exampleField": "value",
+  "anotherField": 123
+}
+```
+
+## 📤 Example API Response
+
+```
+// JSON response
+{
+  "id": "abc123",
+  "status": "success",
+  "data": {
+    "result": true,
+    "timestamp": "2025-04-30T18:00:00Z"
+  }
+}
+```
+
+## 📦 Database Considerations
+
+- **New Tables**: Yes/No
+  If yes, describe the schema or include a rough layout.
+
+- **Modified Tables**: Yes/No
+  Describe what changes are needed and why.
+
+- **Migrations Required**: Yes/No
+
+- **Indexes Required**: Yes/No
+  Include any thoughts on performance or query efficiency.
+
+## 🔐 Security & Access Control
+
+- Does the endpoint require authentication? Yes/No
+- Should it be limited to specific roles (e.g. admin, worker, user)?
+- Any sensitive data in the request or response?
+
+## 📎 Additional Context
+
+Add any screenshots, designs, relevant discussion links, or references to prior issues.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ""
+labels: ""
+assignees: ""
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/new-contribution-template-clean.md

@@ -0,0 +1,27 @@
+---
+name: New Contribution Template (Clean)
+about: "For new Contributions to be added to the Project Management Process, examples removed"
+title: ""
+labels: ""
+assignees: ""
+---
+
+## Purpose
+
+.
+
+---
+
+## Objectives
+
+- .
+
+---
+
+## Description
+
+.
+
+---
+
+[Discord Name if Different]

.github/ISSUE_TEMPLATE/new-contribution-template-examples.md

@@ -0,0 +1,76 @@
+---
+name: New Contribution Template
+about: "For new Contributions to be added to the Project Management Process "
+title: ""
+labels: ""
+assignees: ""
+---
+
+By the time the contribution is ready for final review, the main post of the Issue should be able to serve as the PR description, supplemented by the testing results/peer reviews.
+
+## Purpose
+
+Very brief statement as to what this contribution's purpose is. Examples:
+
+- Add new feature that allows users to create custom flags.
+- Fix bug: modals not closing on game start.
+- Add new Iceland map.
+
+---
+
+## Objectives
+
+Please provide a short list of objectives for the contribution, the number and level of specificity of the items will depend on the scope of the contribution. Is the means by which completion can be measured and success of the changes assessed. May be the starting point for the creation of sub-issues if collaboration is needed/desired. Examples:
+
+**For the Custom Flags Feature**
+
+- Create UI for Flag Customization.
+- Create customization features that provide a wide range of possibilities for users to express themselves.
+- Ensure some customization features are limited to users with certain traits.
+- Assess user traits related to limited customization against Discord roles.
+- Create method for customized flags to be displayed correctly on all connected clients.
+- Create means of restricting certain customization combinations to prevent hate symbols, or ensure it is not possible to create hate symbols with provided customizations.
+
+**For a Bug Fix**
+
+- Ensure all open modals except game start (and any other expected) modal close as expected when the game starts.
+- Ensure all modals still function as expected prior to game start.
+
+**For New Map**
+
+- Add New Map, Iceland to the game for use in Singleplayer and Custom lobbies.
+- Add map to lobby rotation.
+
+---
+
+## Description
+
+Please provide a more detailed description of what is being changed/added, how it is being changed/added, provide any additional detail related to the objectives which would be needed or useful in assessing the contribution overall.
+
+Examples of what info would be expected:
+
+**For the Custom Flags Feature**
+
+- Details about where the UI would be accessed from, mockups of a concept UI if they exist.
+- What kind of customizations will be available.
+- What traits will be provided limited customization features? (Patreons, Devs, Owner, etc.)
+- What kind of customizations will be limited.
+- Any high-level technical implementation details that may be useful in assessing viability, or which will require assistance from other contributors or the project owner (communication between the clients, use or access to a backend DB, discord integration, etc.)
+
+**For a Bug Fix**
+
+- Details about the bug's behavior
+- Details about the cause of the bug (once known)
+- Details about the fix
+- Any secondary effects of implementing the fix
+
+**For a New Map**
+
+- Size of the map
+- Number of Nation Bots
+- Images of the Map
+- Any interesting features of the map
+
+---
+
+[Discord Name if Different]

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Description:
+
+Describe the PR.
+
+## Please complete the following:
+
+- [ ] I have added screenshots for all UI updates
+- [ ] I process any text displayed to the user through translateText() and I've added it to the en.json file
+- [ ] I have added relevant tests to the test directory
+- [ ] I confirm I have thoroughly tested these changes and take full responsibility for any bugs introduced
+- [ ] I have read and accepted the CLA agreement (only required once).
+
+## Please put your Discord username so you can be contacted if a bug or regression is found:
+
+DISCORD_USERNAME

.github/workflows/ci.yml

@@ -1,22 +1,70 @@
-name: CI
-on: [push, pull_request]
+name: 🧪 CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions: {}
+
 jobs:
   build:
+    name: 🏗️ Build
     runs-on: ubuntu-latest
+    timeout-minutes: 30
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
           submodules: false
-      - name: Setup bun
-        uses: oven-sh/setup-bun@v2
+      - name: Setup node
+        uses: actions/setup-node@v4
         with:
-          bun-version: 1.2.4
-      - name: install packages
-        run: bun install
-      - name: Build
-        run: bun run build-prod
+          node-version: 20
+      - run: npm ci
+      - run: npm run build-prod
       - uses: actions/upload-artifact@v4
         with:
           path: out/index.html
           retention-days: 1
+  test:
+    name: 🔬 Test
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          submodules: false
+      - name: Setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm test
+
+  eslint:
+    name: 🔍 ESLint
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+      - run: npm ci
+      - run: npx eslint --format gha
+
+  prettier:
+    name: 🎨 Prettier
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+      - run: npm ci
+      - run: npx prettier --check .