Add VISA backend foundation

2026-06-24 22:45:34 +08:00
parent f51f64f3bd
commit e1df743eb2
17 changed files with 1999 additions and 3 deletions
@@ -0,0 +1,82 @@
+# VISA Backend Foundation 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:** Add a VISA-native backend/database foundation while keeping the current frontend workflow model compatible through an adapter.
+
+**Architecture:** Define VISA T1-T8 as backend-oriented domain structures, add a canonical sample specification, and convert that specification into the existing `WorkflowModel` view model. Keep the database design in documentation for the next backend phase.
+
+**Tech Stack:** TypeScript, Node assert tests, Vite React, Markdown database design documentation.
+
+---
+
+### Task 1: Adapter Tests
+
+**Files:**
+- Create: `src/visaModel.test.ts`
+
+- [ ] **Step 1: Write tests for VISA-to-workflow conversion**
+
+Create tests that assert the adapter exposes VISA agents as frontend workflow nodes, internal functions as behavior sections, sensing records as observable rows, and model-level tables as schedule/data/I-O/validation rows.
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npx tsx src/visaModel.test.ts`
+Expected: FAIL because `visaModel` does not exist yet.
+
+### Task 2: VISA Domain Model
+
+**Files:**
+- Create: `src/visaModel.ts`
+
+- [ ] **Step 1: Define VISA T1-T8 TypeScript interfaces**
+
+Define backend-facing types for agents, variables, sensing relations, internal functions, associated data, inputs, outputs, schedule steps, termination conditions, validations, and consistency check results.
+
+- [ ] **Step 2: Add a canonical default VISA specification**
+
+Create `createDefaultVisaSpec()` using the existing segregation-style example but expressed as VISA T1-T8 rather than frontend tables.
+
+### Task 3: Workflow Adapter
+
+**Files:**
+- Modify: `src/visaModel.ts`
+
+- [ ] **Step 1: Implement `buildWorkflowFromVisaSpec`**
+
+Convert T1 agents into workflow nodes, selected T3/T4 relations into view edges and behavior sections, and T5-T8 records into the existing table rows.
+
+- [ ] **Step 2: Run adapter tests**
+
+Run: `npx tsx src/visaModel.test.ts`
+Expected: PASS.
+
+### Task 4: Database Design Documentation
+
+**Files:**
+- Create: `docs/visa-backend-database-design.md`
+
+- [ ] **Step 1: Document the database schema**
+
+Write the scheme as eight VISA semantic modules plus normalized helper tables for sensing/function references, model versions, and consistency check results.
+
+- [ ] **Step 2: Document frontend boundary**
+
+State that the frontend must not show the eight tables as raw database tables; it consumes view models derived from VISA data.
+
+### Task 5: Verification
+
+**Files:**
+- Modify as needed based on test results.
+
+- [ ] **Step 1: Run all model tests**
+
+Run: `npx tsx src/workflowModel.test.ts` and `npx tsx src/visaModel.test.ts`.
+
+- [ ] **Step 2: Run TypeScript lint**
+
+Run: `npm run lint`.
+
+- [ ] **Step 3: Report status**
+
+Summarize changed files, tests, and remaining backend work.