aiup-angular-jpa

aiup-angular-jpa is the AIUP 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 AIUP 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

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

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

Related documentation

• Getting started
• Workflow and artifacts
• aiup-core

License

Apache-2.0 · © Marc Affolter