Files
ai-teacher/CLAUDE.md
2026-04-10 13:41:26 +02:00

2.9 KiB

ai-teacher Development Guidelines

Auto-generated from all feature plans. Last updated: 2026-04-10

Active Technologies

  • Java 25 (backend), TypeScript / Node 20 (frontend) + Spring Boot 4.0.5, Spring AI 2.0.0-M4, OpenAI API (embeddings + chat), PDFBox (via Spring AI PDF reader dependency) (002-image-aware-embedding)

  • PostgreSQL (JPA + Flyway), pgvector (Spring AI VectorStore), local file system (extracted images — /uploads/figures/) (002-image-aware-embedding)

  • Java 25 (backend), TypeScript / Node 20 (frontend) + Spring Boot 4.0.5, Spring AI 2.0.0-M4, OpenAI API, PDFBox (rendering only), com.google.cloud:google-cloud-documentai (~2.40.x) (002-image-aware-embedding)

  • PostgreSQL (JPA + Flyway), pgvector (Spring AI VectorStore), S3 / local filesystem (figure images) (002-image-aware-embedding)

  • PostgreSQL (JPA + Flyway), pgvector (Spring AI VectorStore), S3-compatible (002-image-aware-embedding)

  • Java 21 (backend) / TypeScript + Node 20 (frontend) + Spring Boot 4.0.5, Spring Security (already included), Vue 3.4, Vue Router 4.3, Pinia 2.1, Axios 1.7 (003-basic-login)

  • No new storage — credentials held in browser sessionStorage (frontend only) (003-basic-login)

  • Java 21 (backend), TypeScript / Node 20 (frontend) + Spring Boot 4.0.5, Spring AI 2.0.0-M4, OpenAI API (chat + embeddings), pgvector, Vue 3.4, Pinia 2.1 (004-rag-retrieval-quality)

  • PostgreSQL (sections, figures, messages — unchanged). No new tables needed. (004-rag-retrieval-quality)

  • Java 21 (backend), TypeScript / Node 20 (frontend) + Spring Boot 4.0.5, Spring AI 2.0.0-M4, OpenAI API (chat + embeddings), Vue 3.4, Pinia 2.1, Axios 1.7 (004-rag-retrieval-quality)

  • PostgreSQL (JPA + Flyway), pgvector (VectorStore) (004-rag-retrieval-quality)

  • Java 25 (backend), TypeScript / Node 20 (frontend) + Spring Boot 4.0.5, Spring AI 2.0.0-M4, native-maven-plugin 0.10.6, (005-native-image-deployment)

  • PostgreSQL 16 + pgvector (unchanged) (005-native-image-deployment)

  • TypeScript / Node 20 (frontend only) + Vue 3.4, Vue Router 4.3, Pinia 2.1 — no changes (006-mobile-responsive-ui)

  • N/A (frontend-only change) (006-mobile-responsive-ui)

  • Java 21 (backend), TypeScript / Node 20 (frontend) (001-neuro-rag-learning)

Project Structure

src/
tests/

Commands

npm test && npm run lint

Code Style

Java 21 (backend), TypeScript / Node 20 (frontend): Follow standard conventions

Recent Changes

  • 006-mobile-responsive-ui: Added TypeScript / Node 20 (frontend only) + Vue 3.4, Vue Router 4.3, Pinia 2.1 — no changes
  • 005-native-image-deployment: Added Java 25 (backend), TypeScript / Node 20 (frontend) + Spring Boot 4.0.5, Spring AI 2.0.0-M4, native-maven-plugin 0.10.6,
  • 004-rag-retrieval-quality: Added Java 21 (backend), TypeScript / Node 20 (frontend) + Spring Boot 4.0.5, Spring AI 2.0.0-M4, OpenAI API (chat + embeddings), Vue 3.4, Pinia 2.1, Axios 1.7