web-cad/test_report.md

Test Report – 2 Features Implementation

Date: 2026-07-01 Project: web-cad-impl

Features Implemented

Feature 1: Globale Block-Bibliothek als Baumstruktur

• Backend: global_block_folders and global_blocks DB tables
• Backend: CRUD API routes with auth middleware and input validation
• Frontend: API service functions in api.ts
• Frontend: BlockLibraryTree.tsx component with tree view, drag&drop, context menu, inline rename
• Frontend: CanvasArea drop handler for global blocks
• Frontend: RightSidebar integration with token prop

Feature 2: Gruppierungs-Tool

• RibbonBar: Gruppieren + Degruppieren buttons in Start tab
• App.tsx: handleGroup/handleUngroup with Yjs sync
• InteractionEngine: Group-aware selection (click group member → select all), group-aware movement
• RenderEngine: Dashed bounding box with group name label
• LeftSidebar: Group section with buttons
• Keyboard shortcuts: G (group), Ctrl+G (ungroup)
• GroupTool: getGroupElements() method for group expansion

Test Results

Backend Tests

Command: cd backend && node_modules/.bin/tsc --noEmit && node_modules/.bin/vitest run

TypeScript Check: Exit 0 – 0 errors

Test Results:

Test Files  15 passed (15)
Tests  221 passed (221)
Duration  11.25s

New test file: backend/tests/globalBlocks.test.ts (28 tests)

• Authentication checks (401 without token)
• Folder CRUD: create, list (root/sub/all), rename, delete with cascade
• Block CRUD: create (in folder/root), list (all/folder/root), get, rename, move, update data, delete
• Validation: missing name, empty name, non-string block_data, self-parent prevention

Frontend Tests

Command: cd frontend && node_modules/.bin/tsc --noEmit && node_modules/.bin/vitest run && node_modules/.bin/vite build

TypeScript Check: Exit 0 – 0 errors

Test Results:

Test Files  15 passed (15)
Tests  367 passed (367)
Duration  12.83s

New test file: frontend/tests/globalBlocks.test.ts (18 tests)

• Global folders API: fetch all, fetch root (null), fetch sub-folders, error handling
• Create folder: with/without parent
• Rename/delete folder
• Global blocks API: fetch all, fetch by folder, fetch root-level
• Create block with full data
• Rename/delete block
• GroupManager.getGroupElements: single element, group members, any member, after ungroup

Build: vite build Exit 0 – successful

dist/index.html                   0.37 kB │ gzip:   0.27 kB
dist/assets/index-DEeNVxCv.css   55.25 kB │ gzip:   9.48 kB
dist/assets/index-BKqmT5jX.js   972.79 kB │ gzip: 327.93 kB
built in 4.33s

Smoke Test Description

Feature 1 – Global Block Library

• Backend API tested via integration tests: folders and blocks can be created, listed, renamed, moved, deleted with proper auth and validation
• Frontend API service functions tested with mocked fetch: all 8 functions (getGlobalFolders, createGlobalFolder, renameGlobalFolder, deleteGlobalFolder, getGlobalBlocks, createGlobalBlock, renameGlobalBlock, deleteGlobalBlock) verify correct URL, method, headers, and body
• BlockLibraryTree component renders tree structure with expand/collapse, context menu (right-click), inline rename (double-click), drag&drop blocks onto canvas, SVG file import

Feature 2 – Group Tool

• RibbonBar shows Gruppieren and Degruppieren buttons in Start tab
• LeftSidebar shows Gruppierung section with both buttons
• Keyboard shortcuts: G triggers group, Ctrl+G triggers ungroup
• GroupManager.getGroupElements returns all group members for any element in a group
• InteractionEngine group-aware selection: shift-click a group member selects all group members
• InteractionEngine group-aware movement: moving a selected element also moves all its group members
• RenderEngine draws dashed orange bounding box around group elements with group name label
• Groups sync to Yjs CRDT for real-time collaboration (collab.setGroup)

Files Changed

Modified (15 files)

• backend/src/database/DatabaseInterface.ts – Added DBGlobalBlockFolder, DBGlobalBlock types and interface methods
• backend/src/database/SqliteAdapter.ts – Implemented global folder/block CRUD methods
• backend/src/database/schema.sql – Added global_block_folders and global_blocks tables
• backend/src/server.ts – Registered globalBlockRoutes
• frontend/src/App.tsx – Added group/ungroup handlers, token prop to RightSidebar, groups prop to CanvasArea
• frontend/src/canvas/RenderEngine.ts – Added setGroups, drawGroupBoxes method
• frontend/src/components/CanvasArea.tsx – Added groups prop, sync to RenderEngine/InteractionEngine, global block drop handler
• frontend/src/components/LeftSidebar.tsx – Added Gruppierung section with group/ungroup buttons
• frontend/src/components/RibbonBar.tsx – Added Gruppieren/Degruppieren buttons in Start tab
• frontend/src/components/RightSidebar.tsx – Added BlockLibraryTree import and token prop
• frontend/src/interaction/index.ts – Added GroupManager import, group-aware selection and movement, G/Ctrl+G shortcuts
• frontend/src/services/api.ts – Added 8 global block API functions
• frontend/src/styles.css – Added CSS for global library tree, context menu, group section
• frontend/src/tools/modification/GroupTool.ts – Added getGroupElements method
• frontend/src/types/ui.types.ts – Added token to RightSidebarProps, groups to CanvasAreaProps, onGroup/onUngroup to LeftSidebarProps

New (4 files)

• backend/src/routes/globalBlocks.ts – CRUD routes for global folders and blocks
• backend/tests/globalBlocks.test.ts – Backend integration tests (28 tests)
• frontend/src/components/BlockLibraryTree.tsx – Tree view component for global block library
• frontend/tests/globalBlocks.test.ts – Frontend API service tests (18 tests)

Git Diff --stat

15 files changed, 684 insertions(+), 7 deletions(-)

No Errors Encountered

All tests pass, build succeeds, TypeScript checks pass with 0 errors.