wvp-platform/AGENTS.md

`# Repository Guidelines

Project Structure & Module Organization

• src/main/java: Spring Boot backend source.
• src/main/resources: application config and resources (e.g., application.yml, application-*.yml).
• src/test/java: backend tests (currently minimal; example: JT1078ServerTest.java).
• web/: Vue 2 frontend app (Element UI, Vue CLI).
• docker/: Docker Compose files and environment configuration (docker/.env).
• docs/ and doc/: project documentation and media assets.
• libs/, tools/, 数据库/: local dependencies, tooling, and database assets.

Build, Test, and Development Commands

Backend (local dev):

• mvn clean package -Dmaven.test.skip=true: build backend jar quickly.
• java -jar target/wvp-pro-2.7.4-*.jar --spring.profiles.active=dev: run with dev profile.
• mvn -DskipTests=false test: run backend tests (tests are skipped by default in pom.xml).

Frontend (from web/):

• npm run dev: local dev server.
• npm run build:prod: production build.
• npm run lint: lint Vue/JS code.
• npm run test:unit: run Jest unit tests.

Docker (from docker/):

• docker compose build: build images.
• docker compose up -d: start full stack.
• docker compose logs -f polaris-wvp: tail backend logs.

Coding Style & Naming Conventions

• Java: follow existing Spring Boot style in src/main/java (4-space indentation, standard Java naming).
• Vue/JS: follow ESLint rules in web/ (npm run lint).
• Config files: use application-<profile>.yml naming for Spring profiles.

Testing Guidelines

• Backend: tests live under src/test/java and typically use *Test class suffix.
• Frontend: Jest via npm run test:unit.
• There is no enforced coverage gate in the repo; keep tests focused on new behavior.

Commit & Pull Request Guidelines

• Commit messages follow Conventional Commit-style prefixes: feat, fix, chore, refactor, optionally with scopes (e.g., feat(aiot): ...).
• PRs should include: a concise summary, relevant config changes (application-*.yml, docker/.env), and screenshots for UI changes in web/.

Configuration Tips

• Local dev settings live in src/main/resources/application-dev.yml.
• Docker configuration lives in docker/.env (ports, SIP settings, IPs). Update these when changing network topology.