Harness in both subprojects, module docs aligned with the code, Markdown gate

.gitattributes

@@ -15,6 +15,9 @@
 *.yml text eol=lf
 *.yaml text eol=lf
 
+# PowerShell scripts keep Windows line endings
+*.ps1 text eol=crlf
+
 # Denote all files that are truly binary and should not be modified
 *.png binary
 *.jpg binary

.github/workflows/ci.yml

@@ -21,16 +21,13 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version-file: backend/.nvmrc
       - run: corepack enable
       - run: pnpm install --frozen-lockfile
       # tests/frontend loads pdf-lib from the frontend's node_modules
       - run: pnpm install --frozen-lockfile
         working-directory: frontend
-      - run: pnpm lint
-      - run: pnpm format:check
-      - run: pnpm typecheck
-      - run: pnpm test
+      - run: pnpm run verify
 
   frontend:
     runs-on: ubuntu-latest
@@ -41,9 +38,11 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version-file: frontend/.nvmrc
       - run: corepack enable
       - run: pnpm install --frozen-lockfile
-      - run: pnpm lint
-      - run: pnpm format:check
-      - run: pnpm typecheck
+      - run: pnpm run verify
+      # Every tracked Markdown file in the repo, each with its nearest .prettierrc
+      - name: Check Markdown format
+        working-directory: .
+        run: git ls-files -z '*.md' | xargs -0 frontend/node_modules/.bin/prettier --check --ignore-path .prettierignore --ignore-path frontend/.prettierignore

.gitignore

@@ -58,7 +58,6 @@ backend/scheduling-solver/venv/
 # Claude Code Templates & Skills
 # --------------------------------------------
 .claude/
-**/skills-lock.json
 
 # --------------------------------------------
 # Local Scripts

CLAUDE.md

@@ -1,3 +1,4 @@
-# CLAUDE.md
+@AGENTS.md
 
-This file has been migrated to `AGENTS.md`. Please refer to `AGENTS.md` for all project documentation.
+This file has been migrated to `AGENTS.md`. Please refer to `AGENTS.md` for all
+project documentation.

README.md

@@ -10,11 +10,11 @@ scheduler that solves the monthly roster with constraint programming.
 ![Four-Points dashboard](docs/images/dashboard.png)
 
 It complements the hotel's commercial PMS (Opera): logbook, parking,
-maintenance, groups, cashier, blacklist, staff scheduling, shift checklists,
-F&B revenue and invoice backoffice.
+maintenance, groups, cashier, blacklist, staff scheduling, shift checklists, F&B
+revenue and invoice backoffice.
 
-| Staff scheduling (OR-Tools) | Parking |
-| --- | --- |
+| Staff scheduling (OR-Tools)                                           | Parking                                      |
+| --------------------------------------------------------------------- | -------------------------------------------- |
 | ![Monthly roster generated by the solver](docs/images/scheduling.png) | ![Parking overview](docs/images/parking.png) |
 
 - **Frontend**: Next.js 16 (App Router), React 19, Tailwind CSS, NextUI.
@@ -36,19 +36,20 @@ Full documentation lives in [`docs/`](docs/general/README.md):
 - [Backoffice](docs/backoffice/README.md)
 - [Blacklist](docs/blacklist/README.md)
 - [Conciliation](docs/conciliation/README.md)
-- [Public demo](docs/demo/README.md) — how the demo account works and when it resets
+- [Public demo](docs/demo/README.md) — how the demo account works and when it
+  resets
 
 ## Try it
 
-A public demo runs on the project site: **Try our live demo** on the login
-page signs you in as an administrator, with fictitious data that resets every
-day. User management and settings are locked there. To see everything, run it
+A public demo runs on the project site: **Try our live demo** on the login page
+signs you in as an administrator, with fictitious data that resets every day.
+User management and settings are locked there. To see everything, run it
 locally.
 
 ## Run it locally
 
-You need Node ≥ 22.16, pnpm, Python 3.11+ (for the scheduling solver) and
-MySQL 8, either installed or through Docker. `frontend/` and `backend/` are
+You need Node ≥ 22.16, pnpm, Python 3.11+ (for the scheduling solver) and MySQL
+8, either installed or through Docker. `frontend/` and `backend/` are
 independent pnpm projects, each with its own lockfile.
 
 ```bash
@@ -76,15 +77,15 @@ pnpm dev:local                                  # backend/: API on :4000
 cd frontend && pnpm install && pnpm dev         # http://localhost:3000
 ```
 
-Sign in as **`admin`** / **`fourpoints-local`**: a full administrator,
-users, roles and settings included. The password is public on purpose:
-`setup:local` only runs against a local database, so this account never
-exists anywhere else. Change it in Profile if you like.
+Sign in as **`admin`** / **`fourpoints-local`**: a full administrator, users,
+roles and settings included. The password is public on purpose: `setup:local`
+only runs against a local database, so this account never exists anywhere else.
+Change it in Profile if you like.
 
-Uploading photos and PDFs needs a Cloudinary account in `backend/.env`.
-Without it everything else works, and an upload just says storage is not
-configured.
+Uploading photos and PDFs needs a Cloudinary account in `backend/.env`. Without
+it everything else works, and an upload just says storage is not configured.
 
 ## License
 
-This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file
+for details.

backend/.prettierrc

@@ -10,6 +10,7 @@
       "options": {
         "printWidth": 80,
         "proseWrap": "always",
+        "embeddedLanguageFormatting": "off",
         "tabWidth": 2
       }
     }