add testing suite

README.md

@@ -79,6 +79,19 @@ Optional: update the map path in `index.js` if you have a local dungeon map.
 
 ---
 
+## Project structure
+
+- **`index.js`** – Entry point: loads env, initializes the Ollama model, runs dungeon generation, image generation, and PDF output.
+- **`src/`** – Application modules:
+  - `dungeonGenerator.js` – LLM-backed dungeon content generation and validation.
+  - `dungeonTemplate.js` – HTML template and layout for the PDF.
+  - `ollamaClient.js` – Ollama/Open WebUI API client and text cleaning.
+  - `imageGenerator.js` – Map image generation (Ollama + optional ComfyUI).
+  - `generatePDF.js` – Puppeteer-based PDF generation from the template.
+- **`test/`** – Unit tests (`test/unit/`) and integration tests (`test/integration/`).
+
+---
+
 ## Example Output
 
 * `the-tomb-of-shadows.pdf`