Prerequisites
Install and verify all of the following before starting a session.
info
This playbook assumes a Windows host: the hook scripts are PowerShell and paths use Windows separators. Adapt the paths below for macOS or Linux.
| Requirement | Version | Why |
|---|---|---|
| Node.js | v20 LTS or higher | Required for frontend (Next.js) and backend (NestJS) |
| Java JDK | 21 (LTS) | Required for Spring Boot option and PlantUML diagram rendering |
| PostgreSQL | 16 | Default database; Flyway migrations auto-applied |
| Redis | 7 | Session cache, rate limiting, token blacklisting |
| Python | 3.13.6 | C:\Program Files\Python313\python.exe — python-docx 1.2.0 must be installed |
| PlantUML | plantuml.jar | Place at tools\plantuml.jar; renders diagrams via java -jar |
| Claude Code | Latest | All interactions happen through the Claude Code CLI or IDE extension |
| Apache Tomcat | Local instance | CI/CD deployment target (local, not cloud or Docker) |
warning
Never use Docker or docker-compose anywhere in this application — not at startup, not for deployment. Deploy exclusively to local Apache Tomcat.