aiup-angular-jpa

aiup-angular-jpa is the AI Unified Process construction plugin for an Angular frontend and a Spring Boot backend using JPA/Hibernate. It turns the artifacts produced by aiup-core into database migrations, a REST API, an Angular UI, and tests across both applications.

This plugin is designed to continue from the specifications produced by aiup-core. For the complete AI Unified Process workflow, use it alongside aiup-core and select one stack plugin.

Architecture support

The backend skills detect and follow either of these established project shapes:

Flat single module: entities, repositories, services, and controllers in one Spring Boot module.
Hexagonal multi-module: separate domain, business, persistence adapter, inbound adapter, and composition-root modules with ports and adapters enforced by Maven boundaries.

Existing asymmetric conventions are preserved instead of being rewritten into a textbook architecture. The shared detection rules are documented in skills/implement/references/module-layout.md.

Skills and workflow

Phase	Skill	Result
Construction	`/flyway-migration`	Flyway migrations placed in the detected persistence module
Construction	`/implement`	Spring Boot API and Angular UI following the existing architecture
Construction	`/spring-boot-test`	Backend integration tests using the project's detected convention
Construction	`/vitest-test`	Angular component tests with TestBed and HttpTestingController
Construction	`/playwright-test`	Browser-based end-to-end tests for the split application

Construction
──────────────────────────────────────────────────────
/flyway-migration  →  /implement  →  /spring-boot-test
                                  ↘  /vitest-test
                                  ↘  /playwright-test

The linked SKILL.md files are the authoritative reference for detailed inputs, outputs, and behavior.

Installation

Tessl

Initialize the project once:

tessl init --agent agents

agents is the vendor-neutral layout; use claude-code, cursor, gemini, codex, copilot, or copilot-vscode for a specific host. Then install the plugins:

tessl install ai-unified-process/aiup-core
tessl install ai-unified-process/aiup-angular-jpa

Depending on the configured agent, skills may be exposed as slash commands or invoked by intent, for example "implement UC-001".

Claude Code

/plugin marketplace add ai-unified-process/marketplace
/plugin install aiup-core
/plugin install aiup-angular-jpa

See the marketplace installation guides for other agents and manual adoption.

Prerequisites

aiup-core and reviewed docs/entity_model.md plus docs/use_cases/UC-*.md artifacts.
A Maven or Gradle backend with Spring Boot, Spring Data JPA, and Flyway.
An Angular frontend using standalone components.
Docker when the project's integration-test convention uses Testcontainers.
Optional MCP servers configured through rules/mcp-servers.md.

Inputs and generated artifacts

All construction skills consume the core artifacts under docs/. They write migrations and backend code into the detected Spring module, Angular pages and services into the existing frontend layout, and tests alongside their respective application.

Project structure

Flat backend

your-project/
├── docs/
├── backend/
│   └── src/
│       ├── main/java/                    # /implement
│       ├── main/resources/db/migration/  # /flyway-migration
│       └── test/java/                    # /spring-boot-test
└── frontend/
    ├── src/app/                          # /implement and /vitest-test
    └── tests/e2e/                        # /playwright-test

Hexagonal backend

backend/
├── <domain-module>/                      # pure domain types
├── <business-module>/                    # services, ports, and DTOs
├── <persistence-module>/                 # JPA adapter and Flyway migrations
├── <api-module>/                         # REST controllers
└── <app-module>/                         # composition root and integration tests

Module names and frontend locations are detected from the project; these trees illustrate responsibilities rather than prescribe exact names.

MCP servers

Server	Purpose
`JavaDocs`	Spring, Hibernate, RestAssured, Testcontainers, and classpath APIs
`playwright`	Browser automation

General npm package documentation is available through aiup-core's context7 server. See rules/mcp-servers.md for setup details.

License

See LICENSE and NOTICE. "AI Unified Process" identifies the original methodology; derived works must retain the NOTICE file and must not present themselves as the official AI Unified Process.