64 lines
3.2 KiB
Markdown
64 lines
3.2 KiB
Markdown
|
# 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.
|