cesnimda/jobtrackingapp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(dev): align setup with current stack

Browse Source
This commit is contained in:
cesnimda
2026-08-30 11:32:00 +02:00
parent 16ef3b9463
commit 2d7a51c3fd
10 changed files with 104 additions and 78 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/verification/jt-018-developer-documentation.md
+30
View File
@@ -0,0 +1,30 @@
# JT-018 developer and operator documentation verification
## Implemented
- Replaced the obsolete Create React App frontend guide with the actual Next.js 16, React 19, TypeScript, Jest, ESLint and Playwright workflow.
- Corrected the root quickstart to use the committed npm and NuGet lock files (`npm ci` and `dotnet restore --locked-mode`).
- Documented the separate normal-development (`3000`) and isolated Playwright (`3300`) frontend ports.
- Removed the obsolete npm peer-dependency override and verified the current graph installs without it.
- Corrected the production provider matrix: SQLite and MariaDB/MySQL are implemented; PostgreSQL is not.
- Corrected the architecture inventory to React Router 7 and removed completed roadmap suggestions from the runtime README.
- Linked environment, architecture, deployment, audit and programme sources so historical phase notes are not mistaken for current setup instructions.
## Proof
- Clean `npm ci`: passed without the removed `.npmrc` override and without lockfile drift.
- Frontend lint: zero warnings.
- Frontend Jest: 64/64 suites, 272/272 tests.
- CV Builder autosave regression: 12/12 tests; timing-dependent manual-save assertions now verify the actual debounced autosave contract.
- Next.js production build and integrated TypeScript check: passed.
- API and test-project NuGet restore with `--locked-mode`: passed.
- Backend: 719/719 tests passed on SDK 9.0.317.
- Documentation stale-claim and referenced-path checks: passed; the only PostgreSQL mention explicitly states that it is unsupported.
## Environment note
SDK 9.0.317 is installed at the user-local `.dotnet` location. This workstation also has a runtime-only `C:\Program Files\dotnet` host earlier on `PATH`; verification therefore invoked the installed SDK host explicitly. The repository's `global.json` correctly rejects the runtime-only host instead of silently selecting a different SDK.
## Remaining external proof
A truly clean second machine and production operator rehearsal were not used. The documented install, lint, test, build and locked-restore commands were executed against a clean frontend dependency installation and the current repository checkout.