QA → Main (Sawaka)

.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: Bond52
+ko_fi: bond52
+

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,21 +1,23 @@
 ---
-name: 🐛 Bug Report
-about: Signaler un bug dans Sawaka
+name: Bug report
+about: Report a bug
+title: "[BUG] "
+labels: ["bug"]
 ---
 
-# 🐛 Description du bug
-Décrivez clairement le problème rencontré.
+### Description
+What is the bug?
 
-## 🔁 Étapes pour reproduire
-1. …
-2. …
-3. …
+### Steps to Reproduce
+1. ...
+2. ...
 
-## ✔ Comportement attendu
-Décrivez ce qui aurait dû se produire.
+### Expected Behavior
+...
 
-## 🖥️ Environnement
-- OS :
-- Navigateur :
-- Version backend :
-- Version frontend :
+### Actual Behavior
+...
+
+### Definition of Done
+- [ ] Bug fixed
+- [ ] Regression tested

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/requirement-business.yml

@@ -0,0 +1,43 @@
+name: "Requirement — Business"
+description: "Define a business-level requirement"
+title: "BR — "
+labels: ["requirement", "business"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      placeholder: Describe the business need
+    validations:
+      required: true
+
+  - type: textarea
+    id: business_objective
+    attributes:
+      label: Business Objective
+      placeholder: What business goal does this support?
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_outcome
+    attributes:
+      label: Expected Outcome
+      placeholder: What value should be delivered?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      options:
+        - High
+        - Medium
+        - Low
+
+  - type: textarea
+    id: relationships
+    attributes:
+      label: Relationships
+      placeholder: Parent / Derived from / Related to

.github/ISSUE_TEMPLATE/requirement-functional.yml

@@ -0,0 +1,53 @@
+name: "Requirement — Functional"
+description: "Define a functional requirement"
+title: "FR — "
+labels: ["requirement", "functional"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      placeholder: Describe the feature behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: business_intent
+    attributes:
+      label: Business Intent
+      placeholder: Why is this needed?
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_outcome
+    attributes:
+      label: Expected Outcome
+      placeholder: What should happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance Criteria
+      placeholder: |
+        - [ ] Criteria 1
+        - [ ] Criteria 2
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      options:
+        - High
+        - Medium
+        - Low
+
+  - type: textarea
+    id: relationships
+    attributes:
+      label: Relationships
+      placeholder: Parent / Derived from / Related to

.github/ISSUE_TEMPLATE/requirement-nfr.yml

@@ -0,0 +1,43 @@
+name: "Requirement — Non-Functional"
+description: "Define a non-functional requirement (performance, security, reliability...)"
+title: "NFR - "
+labels: ["requirement", "nfr"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      placeholder: Describe the requirement clearly
+    validations:
+      required: true
+
+  - type: textarea
+    id: objective
+    attributes:
+      label: Objective
+      placeholder: What is the goal of this requirement?
+    validations:
+      required: true
+
+  - type: textarea
+    id: metric
+    attributes:
+      label: Success Metric
+      placeholder: Example: ≥ 95% delivery success rate
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      options:
+        - High
+        - Medium
+        - Low
+
+  - type: textarea
+    id: relationships
+    attributes:
+      label: Relationships
+      placeholder: Parent / Derived from / Related to

.github/ISSUE_TEMPLATE/task.md

@@ -0,0 +1,17 @@
+## Description
+What needs to be done and why.
+
+## Scope
+- [ ] Define scope item 1
+- [ ] Define scope item 2
+
+## Technical Notes
+Implementation details (UI / API / Backend / Infra)
+
+## Dependencies
+- Related issues / requirements / blockers
+
+## Definition of Done
+- [ ] Implementation completed
+- [ ] Code reviewed
+- [ ] Tested

.github/ISSUE_TEMPLATE/test-case.yml

@@ -0,0 +1,36 @@
+name: "Test Case"
+description: "Define a test case for validation"
+title: "TC - "
+labels: ["test-case"]
+
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      placeholder: Describe the test case clearly
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Test Steps
+      placeholder: Step-by-step execution
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Results
+
+  - type: textarea
+    id: test_data
+    attributes:
+      label: Test Data
+      placeholder: Input values used in the test
+
+  - type: textarea
+    id: notes
+    attributes:
+      label: Notes
+      placeholder: Optional remarks / edge cases

.github/ISSUE_TEMPLATE/user_story.md

@@ -0,0 +1,21 @@
+---
+name: User Story
+about: Create a user story
+title: "[US] "
+labels: ["user story"]
+assignees: ""
+---
+
+### User Story
+As a user, I want to ... so that ...
+
+### Acceptance Criteria
+- Given ...
+- When ...
+- Then ...
+
+### Definition of Done
+- [ ] Acceptance criteria met
+- [ ] Tested in QA
+- [ ] No critical bugs
+- [ ] Documentation updated (if needed)

.github/workflows/ci.yml

@@ -0,0 +1,92 @@
+name: Sawaka CI
+
+on:
+  push:
+    branches: [main, qa]
+  pull_request:
+    branches: [main, qa]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+
+    services:
+      mongo:
+        image: mongo:6
+        ports:
+          - 27017:27017
+        options: >-
+          --health-cmd "mongosh --eval 'db.runCommand({ ping: 1 })'"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    env:
+      NODE_ENV: test
+      CI: "true"
+      MONGO_URI: mongodb://localhost:27017/sawaka_test
+      JWT_SECRET: ci-dummy-secret-do-not-use-in-prod
+      FRONTEND_URL: http://localhost:3000
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+          cache: "npm"
+
+      - name: Install frontend dependencies
+        run: npm ci
+
+      # ==================================================
+      # Backend — Jest
+      # ==================================================
+      - name: Install backend dependencies
+        working-directory: backend-api
+        run: npm ci
+
+      - name: Run backend tests (Jest)
+        working-directory: backend-api
+        run: npm test
+
+      # ==================================================
+      # API — Newman (server must be running)
+      # ==================================================
+      - name: Start API, wait, then run Newman
+        run: |
+          (cd backend-api && node index.js) &
+          npx wait-on -t 30000 http://localhost:5000/
+          npx newman run tests/api/postman/sawaka.postman_collection.json \
+            -e tests/api/postman/sawaka.postman_environment.json \
+            --delay-request 100
+
+      # ==================================================
+      # Frontend — lint, build
+      # ==================================================
+      - name: Lint
+        run: npm run lint
+
+      - name: Build
+        run: npm run build
+
+      # ==================================================
+      # Frontend — Playwright (app must be running)
+      # ==================================================
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps
+
+      - name: Start Next.js, wait, then run Playwright
+        run: |
+          npm run start &
+          npx wait-on -t 60000 http://localhost:3000/
+          npx playwright test
+
+      # ==================================================
+      # Docs generation
+      # ==================================================
+      - name: Generate documentation
+        working-directory: backend-api
+        run: npm run docs:generate