yidaima/RuoYi-Vue/docs/superpowers/plans/2026-05-24-executable-business-blueprint.md

Executable Business Blueprint Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Generate runnable workflow, status, insert, update, and numeric inventory/amount business code from business blueprints.

Architecture: Extend the current safe DSL instead of letting AI write Java. The backend validates ruleChecks and expanded effects against saved schema, then Velocity templates render deterministic Java/Vue code.

Tech Stack: Java 8, Spring Boot, MyBatis, Fastjson2/Jackson, Velocity, JUnit 4, Mockito, Vue.

---

Task 1: Extend Blueprint DTO And AI Normalization

Files:

• Create: ruoyi-generator/src/main/java/com/ruoyi/generator/domain/front/dto/BusinessActionRuleDesign.java

• Modify: ruoyi-generator/src/main/java/com/ruoyi/generator/domain/front/dto/BusinessActionDesign.java

• Modify: ruoyi-generator/src/main/java/com/ruoyi/generator/domain/front/dto/BusinessActionEffectDesign.java

• Modify: ruoyi-generator/src/main/java/com/ruoyi/generator/service/front/AiGenerateServiceImpl.java

• Test: ruoyi-generator/src/test/java/com/ruoyi/generator/service/front/AiGenerateServiceImplTest.java

• Add a failing test proving ruleChecks, INSERT_ROW, and DECREASE_NUMBER parse and persist.

• Run mvn -pl ruoyi-generator -Dtest=AiGenerateServiceImplTest test and verify RED.

• Add DTO fields and normalization helpers.

• Re-run the targeted test and verify GREEN.

Task 2: Validate Executable DSL Safely

Files:

• Modify: ruoyi-generator/src/main/java/com/ruoyi/generator/service/front/AiBusinessBlueprintValidator.java

• Test: ruoyi-generator/src/test/java/com/ruoyi/generator/service/front/AiGenerateServiceImplTest.java

• Add tests for unknown rule/effect fields and unsafe values.

• Run the targeted test and verify RED.

• Validate action tables, rule tables/fields, effect tables/fields, map keys, placeholders, and numeric amounts.

• Re-run tests and verify GREEN.

Task 3: Render Full Runnable Workflow Helpers

Files:

• Modify: sql/business_blueprint_templates.sql

• Modify: sql/db.sql

• Test: ruoyi-generator/src/test/java/com/ruoyi/generator/service/GenProjectServiceImplTest.java

• Add a failing template test for assertExists, insertRow, updateFields, setStatus, increaseNumberField, and decreaseNumberField.

• Run the targeted test and verify RED.

• Extend the backend Velocity template to render rule checks and executable effects.

• Sync the template block into sql/db.sql.

• Re-run template tests and verify GREEN.

Task 4: Frontend Display Compatibility

Files:

• Modify: easycode-web/src/views/GenerateView.vue

• Render structured ruleChecks and expanded effect details without breaking old string rules.

• Run existing frontend tests if available.

Task 5: Full Verification

• Run mvn -pl ruoyi-generator -Dtest=AiGenerateServiceImplTest,GenProjectServiceImplTest test.
• Run any impacted frontend tests.
• Inspect generated template snippets for one sample action.