from __future__ import annotations import shutil import unittest from pathlib import Path from uuid import uuid4 from backend.dto.common import ApiError, ErrorCode from backend.services.profile_service import ProfileService from backend.services.workflow_service import WorkflowService from core.audit_service import AuditService from core.event_bus import EventBus from core.identity import RequestContext from database.db_helper import Database, DatabaseSettings, SqliteSettings from database.repositories.profile_repository import ProfileRepository from database.repositories.workflow_repository import WorkflowRepository class WorkflowServiceTests(unittest.TestCase): def setUp(self): self.tmp_path = Path(".tmp") / f"test_workflow_service_{uuid4().hex}" self.tmp_path.mkdir(parents=True, exist_ok=False) db_path = self.tmp_path / "imagestudio.db" self.database = Database(DatabaseSettings(sqlite=SqliteSettings(path=str(db_path)))) self.database.initialize() self.audit_service = AuditService(self.database) self.profile_repository = ProfileRepository(self.database) self.workflow_repository = WorkflowRepository(self.database) self.profile_service = ProfileService( repository=self.profile_repository, audit_service=self.audit_service, ) self.workflow_service = WorkflowService( workflow_repository=self.workflow_repository, profile_repository=self.profile_repository, audit_service=self.audit_service, ) self.ctx = RequestContext.from_astrbot( username="admin", user_id="user_001", permissions={"can_write"}, ) self.profile = self.profile_service.create_profile({"name": "Nova"}, self.ctx) def tearDown(self): shutil.rmtree(self.tmp_path, ignore_errors=True) def test_create_single_image_workflow_creates_virtual_node(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "single_image", "display_name": "Single image 2026-07-04", "mode": "quick", }, self.ctx, ) self.assertTrue(detail.workflow.workflow_id.startswith("workflow_")) self.assertEqual(detail.workflow.workflow_type, "single_image") self.assertEqual(len(detail.nodes), 1) self.assertEqual(detail.nodes[0].node_key, "virtual_single_image") self.assertEqual(detail.nodes[0].node_type, "virtual_single_image") self.assertEqual(detail.workflow.current_node_id, detail.nodes[0].node_id) conn = self.database.connect() try: audit = conn.execute( """ SELECT action, target_type FROM audit_logs WHERE target_id = ? """, (detail.workflow.workflow_id,), ).fetchone() finally: conn.close() self.assertIsNotNone(audit) self.assertEqual(audit["action"], "create_workflow") self.assertEqual(audit["target_type"], "profile_workflow") def test_create_character_gradual_workflow_creates_eight_template_nodes(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_gradual", "display_name": "Character gradual", "mode": "professional", }, self.ctx, ) self.assertEqual(len(detail.nodes), 8) self.assertEqual(detail.nodes[0].node_key, "profile_brief") self.assertEqual(detail.nodes[-1].node_key, "final_pack") self.assertEqual(detail.workflow.current_node_id, detail.nodes[0].node_id) self.assertEqual( [node.sort_order for node in self.workflow_service.list_nodes(detail.workflow.workflow_id)], [10, 20, 30, 40, 50, 60, 70, 80], ) def test_create_fast_character_workflow_creates_fast_template_nodes(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_fast", "display_name": "Fast character", }, self.ctx, ) self.assertEqual([node.node_key for node in detail.nodes], ["fast_profile", "fast_candidates", "fast_final"]) self.assertEqual(detail.workflow.current_node_id, detail.nodes[0].node_id) def test_create_quick_profile_workflow_creates_profile_draft_nodes(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "quick_profile", "display_name": "Quick profile", }, self.ctx, ) self.assertEqual([node.node_key for node in detail.nodes], ["questionnaire", "preview"]) self.assertEqual(detail.nodes[0].node_type, "profile_draft") def test_create_branch_copies_nodes_and_switches_current_branch(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_fast", "display_name": "Fast character", }, self.ctx, ) branch = self.workflow_service.create_branch( detail.workflow.workflow_id, {"branch_name": "alt_pose", "copy_nodes": True}, self.ctx, ) self.assertEqual(branch.branch_name, "alt_pose") copied_nodes = self.workflow_repository.list_nodes(detail.workflow.workflow_id, branch_name="alt_pose") self.assertEqual(len(copied_nodes), 3) self.assertEqual([node.node_key for node in copied_nodes], ["fast_profile", "fast_candidates", "fast_final"]) self.assertTrue(copied_nodes[0].metadata["copied_from_node_id"].startswith("node_")) switched = self.workflow_service.switch_branch(detail.workflow.workflow_id, "alt_pose", self.ctx) self.assertEqual(switched.current_branch, "alt_pose") self.assertEqual(switched.current_node_id, copied_nodes[0].node_id) branches = self.workflow_service.list_branches(detail.workflow.workflow_id) self.assertEqual([item.branch_name for item in branches], ["alt_pose"]) def test_create_branch_from_base_node_preserves_ancestors_and_resets_cut(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_fast", "display_name": "Fast character", }, self.ctx, ) nodes = self.workflow_service.list_nodes(detail.workflow.workflow_id) first, second, third = nodes self.workflow_service.update_node( first.node_id, {"status": "completed", "selected_image_id": "img_first"}, self.ctx, ) self.workflow_service.update_node( second.node_id, {"status": "completed", "selected_image_id": "img_second"}, self.ctx, ) self.workflow_service.create_branch( detail.workflow.workflow_id, { "branch_name": "change_candidates", "base_node_id": second.node_id, "copy_nodes": True, }, self.ctx, ) copied_nodes = self.workflow_repository.list_nodes( detail.workflow.workflow_id, branch_name="change_candidates", ) copied_first, copied_second, copied_third = copied_nodes self.assertEqual(copied_first.status, "completed") self.assertEqual(copied_first.selected_image_id, "img_first") self.assertTrue(copied_first.metadata["branch_locked_ancestor"]) self.assertEqual(copied_second.status, "draft") self.assertIsNone(copied_second.selected_image_id) self.assertTrue(copied_second.metadata["branch_editable_from_cut"]) self.assertEqual(copied_second.metadata["copied_from_node_id"], second.node_id) self.assertEqual(copied_third.status, "draft") self.assertIsNone(copied_third.selected_image_id) self.assertEqual(copied_third.metadata["copied_from_node_id"], third.node_id) def test_create_branch_rejects_unknown_base_node_without_persisting_branch(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_fast", "display_name": "Fast character", }, self.ctx, ) with self.assertRaises(ApiError) as raised: self.workflow_service.create_branch( detail.workflow.workflow_id, { "branch_name": "bad_cut", "base_node_id": "node_missing", "copy_nodes": True, }, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) branch_names = [ branch.branch_name for branch in self.workflow_service.list_branches(detail.workflow.workflow_id) ] self.assertNotIn("bad_cut", branch_names) def test_create_and_list_nodes_ordered_by_sort_order(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_gradual", "display_name": "Manual character flow", "mode": "standard", "auto_create_nodes": False, }, self.ctx, ) second = self.workflow_service.create_node( detail.workflow.workflow_id, {"node_key": "full_body", "title": "Full body", "sort_order": 20}, self.ctx, ) first = self.workflow_service.create_node( detail.workflow.workflow_id, {"node_key": "portrait", "title": "Portrait", "sort_order": 10}, self.ctx, ) nodes = self.workflow_service.list_nodes(detail.workflow.workflow_id) self.assertEqual([node.node_id for node in nodes], [first.node_id, second.node_id]) def test_update_node_changes_status_and_writes_audit(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_gradual", "display_name": "Manual character flow", "auto_create_nodes": False, }, self.ctx, ) node = self.workflow_service.create_node( detail.workflow.workflow_id, {"node_key": "portrait", "title": "Portrait"}, self.ctx, ) updated = self.workflow_service.update_node( node.node_id, { "status": "completed", "prompt": "portrait, silver hair", }, self.ctx, ) self.assertEqual(updated.status, "completed") self.assertEqual(updated.prompt, "portrait, silver hair") conn = self.database.connect() try: count = conn.execute( """ SELECT COUNT(*) AS total FROM audit_logs WHERE target_id = ? AND action = 'update_node' """, (node.node_id,), ).fetchone()["total"] finally: conn.close() self.assertEqual(count, 1) def test_completed_node_rejects_mutating_update_until_branch_is_created(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_gradual", "display_name": "Manual character flow", "auto_create_nodes": False, }, self.ctx, ) node = self.workflow_service.create_node( detail.workflow.workflow_id, {"node_key": "portrait", "title": "Portrait"}, self.ctx, ) completed = self.workflow_service.update_node( node.node_id, {"status": "completed", "prompt": "portrait, silver hair"}, self.ctx, ) with self.assertRaises(ApiError) as raised: self.workflow_service.update_node( node.node_id, {"prompt": "portrait, black hair"}, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) self.assertEqual(raised.exception.details["suggested_action"], "create_branch") self.assertEqual(raised.exception.details["base_node_id"], completed.node_id) def test_workflow_service_publishes_status_events(self): event_bus = EventBus() workflow_service = WorkflowService( workflow_repository=self.workflow_repository, profile_repository=self.profile_repository, audit_service=self.audit_service, event_bus=event_bus, ) detail = workflow_service.create_workflow( self.profile.profile_id, {"workflow_type": "single_image", "display_name": "Evented"}, self.ctx, ) workflow_service.update_workflow(detail.workflow.workflow_id, {"status": "running"}, self.ctx) workflow_service.update_node(detail.nodes[0].node_id, {"status": "queued"}, self.ctx) self.assertEqual(event_bus.history("workflow.created")[0].payload["workflow_id"], detail.workflow.workflow_id) self.assertEqual(event_bus.history("workflow.status_changed")[0].payload["after_status"], "running") self.assertEqual(event_bus.history("workflow.node_status_changed")[0].payload["after_status"], "queued") def test_invalid_workflow_status_transition_is_rejected(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, {"workflow_type": "single_image", "display_name": "Archived"}, self.ctx, ) self.workflow_service.update_workflow(detail.workflow.workflow_id, {"status": "archived"}, self.ctx) with self.assertRaises(ApiError) as raised: self.workflow_service.update_workflow(detail.workflow.workflow_id, {"status": "running"}, self.ctx) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) def test_invalid_workflow_type_is_rejected(self): with self.assertRaises(ApiError) as raised: self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "unknown", "display_name": "Bad workflow", }, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) def test_invalid_node_status_is_rejected(self): detail = self.workflow_service.create_workflow( self.profile.profile_id, { "workflow_type": "character_gradual", "display_name": "Manual character flow", "auto_create_nodes": False, }, self.ctx, ) with self.assertRaises(ApiError) as raised: self.workflow_service.create_node( detail.workflow.workflow_id, { "node_key": "portrait", "title": "Portrait", "status": "mystery", }, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) def test_missing_profile_is_rejected(self): with self.assertRaises(ApiError) as raised: self.workflow_service.create_workflow( "profile_missing", { "workflow_type": "single_image", "display_name": "Orphan workflow", }, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.RESOURCE_NOT_FOUND) if __name__ == "__main__": unittest.main()