yidaima/RuoYi-Vue/docs/superpowers/plans/2026-07-07-paper-draft-streaming.md

Paper Draft Streaming 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: Stream paper draft markdown into the paper draft page as it is generated, then save the completed draft.

Architecture: Add a dedicated streaming paper draft endpoint that reuses the existing prompt builder and forwards DeepSeek streaming deltas to the browser. The frontend uses fetch with ReadableStream so authorization headers and JSON request bodies continue to work.

Tech Stack: Spring Boot 2.5, StreamingResponseBody, DeepSeek chat completions streaming, Vue 3, fetch streams, existing paper persistence API.

---

Task 1: Backend Streaming Contract

Files:

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

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

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

• Add a StreamHandler callback contract to IDeepSeekClient.

• Write a failing test that feeds SSE lines with choices[0].delta.content and verifies chunks are emitted in order.

• Implement DeepSeek stream: true parsing for data: lines and [DONE].

• Keep the existing non-streaming chat behavior unchanged.

Task 2: Paper Draft Stream Service And Controller

Files:

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

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

• Modify: ruoyi-admin/src/main/java/com/ruoyi/web/controller/front/FrontProjectController.java

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

• Add streamPaperDraft(userId, projectId, request, handler) to the AI service.

• Write a failing test proving streamPaperDraft reuses the paper draft prompt and emits sanitized chunks.

• Add POST /front/project/{projectId}/paper-draft/stream returning text/plain;charset=UTF-8 as a streaming response.

• Ensure exceptions are propagated so the frontend can show failure instead of saving partial text as completed output.

Task 3: Frontend Stream Consumption

Files:

• Modify: easycode-web/src/api/project.js

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

• Test: easycode-web/src/views/paperDraftView.test.mjs

• Add streamPaperDraft(projectId, data, handlers) using fetch, Authorization, and ReadableStream.

• Update handleGenerateDraft to clear old text, stream chunks into draftMarkdown, keep the preview tab active, then call savePaperDraft({ silent: true }).

• Add an abort controller and show a Stop button while streaming.

• Add source-level tests checking the stream API is imported, the stop action exists, and the old synchronous generatePaperDraft path is no longer used by the page.

Task 4: Verification

Files:

• Test commands only.

• Run node --test easycode-web/src/views/paperDraftView.test.mjs easycode-web/src/utils/markdown.test.mjs.

• Run mvn -pl ruoyi-generator "-Dtest=AiGenerateServiceImplTest#generatePaper*,HttpDeepSeekClientTest" test.

• Report any unrelated existing red tests separately from the focused streaming checks.