[Domain] Add two-floor evacuation demo map

Author: SilverSupplier

docs/demo/시연 평면 가이드.md

@@ -2,6 +2,7 @@
 
 Sprint 1 시연에서 사용할 도면 자산과 각 도면이 강조하는 결과 지표를 정리합니다.
 도면 파일은 [`assets/demo-layouts/`](../../assets/demo-layouts/) 에 있습니다.
+앱 시작 화면의 built-in 프로젝트에는 코드 fixture 기반의 `Two-floor Evacuation Demo`도 포함됩니다.
 
 ## 시연 흐름 요약
 
@@ -47,6 +48,16 @@ Sprint 1 시연에서 사용할 도면 자산과 각 도면이 강조하는 결
   - `DensitySummary.peakField` 의 피크 셀이 복도 중앙 또는 로비 출구 직전에 형성
 - **보여줄 화면**: 존별 완료 시간 표, 출구 사용 막대그래프, 복도/로비 영역의 밀도 히트맵, 리플레이로 군중이 복도를 통해 모이는 흐름
 
+### 4. 앱 내장 `Two-floor Evacuation Demo` — 2층 대피 시나리오 시연
+
+- **구조**: 2층의 서측 교육실, 중앙 브리핑룸, 동측 교육실에서 복도로 나온 뒤 양쪽 U자형 계단을 통해 1층 로비와 전실을 거쳐 서측/동측 출구로 대피하는 내장 layout.
+- **메시지**: "다층 평면에서 층 선택, 계단 전환, 출구 유도 시나리오가 앱에서 바로 실행되는가."
+- **강조 지표**:
+  - 2층 보행자가 계단 연결을 지나 1층 출구로 이동
+  - baseline과 우측 출구 유도 alternative를 같은 run 화면에서 실행 가능
+  - 결과 화면의 floor selector로 1층/2층 상태를 나누어 확인 가능
+- **보여줄 화면**: Project Navigator에서 `Two-floor Evacuation Demo` 열기, Run Workspace 실행, Result Summary의 층별 canvas와 출구 사용 지표
+
 ## 시연 셋업 권장값 (참고)
 
 | 항목 | 권장 |

src/application/MainWindow.cpp

@@ -35,12 +35,9 @@ void applySavedReviewState(const ProjectMetadata& metadata, safecrowd::domain::I
     ProjectPersistence::loadProjectReview(metadata, importResult);
 }
 
-safecrowd::domain::ImportResult makeDemoImportResult() {
-    safecrowd::domain::DemoFixtureService fixtureService;
-    const auto fixture = fixtureService.createSprint1DemoFixture();
-
+safecrowd::domain::ImportResult makeImportResultForDemoLayout(safecrowd::domain::FacilityLayout2D layout) {
     safecrowd::domain::ImportResult result;
-    result.layout = fixture.layout;
+    result.layout = std::move(layout);
 
     safecrowd::domain::ImportValidationService validator;
     result.issues = validator.validate(*result.layout);
@@ -50,6 +47,18 @@ safecrowd::domain::ImportResult makeDemoImportResult() {
     return result;
 }
 
+safecrowd::domain::ImportResult makeSprint1DemoImportResult() {
+    safecrowd::domain::DemoFixtureService fixtureService;
+    const auto fixture = fixtureService.createSprint1DemoFixture();
+    return makeImportResultForDemoLayout(fixture.layout);
+}
+
+safecrowd::domain::ImportResult makeTwoFloorEvacuationDemoImportResult() {
+    safecrowd::domain::DemoFixtureService fixtureService;
+    const auto fixture = fixtureService.createTwoFloorEvacuationDemoFixture();
+    return makeImportResultForDemoLayout(fixture.layout);
+}
+
 ProjectWorkspaceState makeEvacuationScenarioDemoWorkspace() {
     using namespace safecrowd::domain;
 
@@ -90,6 +99,35 @@ ProjectWorkspaceState makeEvacuationScenarioDemoWorkspace() {
     return workspace;
 }
 
+ProjectWorkspaceState makeTwoFloorEvacuationDemoWorkspace() {
+    using namespace safecrowd::domain;
+
+    safecrowd::domain::DemoFixtureService fixtureService;
+    auto fixture = fixtureService.createTwoFloorEvacuationDemoFixture();
+
+    SavedScenarioAuthoringState authoring;
+    authoring.scenarios.push_back({
+        .draft = fixture.baselineScenario,
+        .baseScenarioId = {},
+        .stagedForRun = true,
+    });
+    authoring.scenarios.push_back({
+        .draft = fixture.alternativeScenario,
+        .baseScenarioId = fixture.baselineScenario.scenarioId,
+        .stagedForRun = true,
+    });
+    authoring.currentScenarioIndex = 1;
+    authoring.navigationView = SavedNavigationView::Events;
+    authoring.rightPanelMode = SavedRightPanelMode::Scenario;
+
+    ProjectWorkspaceState workspace;
+    workspace.activeView = ProjectWorkspaceView::ScenarioRun;
+    workspace.authoring = std::move(authoring);
+    workspace.runningScenario = fixture.alternativeScenario;
+    workspace.runningScenarios = {fixture.baselineScenario, fixture.alternativeScenario};
+    return workspace;
+}
+
 safecrowd::domain::ImportResult makeBlankImportResult(const QString& projectName) {
     safecrowd::domain::ImportResult result;
     result.layout = safecrowd::domain::FacilityLayout2D{
@@ -111,8 +149,11 @@ safecrowd::domain::ImportResult makeBlankImportResult(const QString& projectName
 }
 
 safecrowd::domain::ImportResult importProjectLayout(const ProjectMetadata& metadata) {
-    if (metadata.isBuiltInDemo()) {
-        return makeDemoImportResult();
+    if (metadata.isBuiltInTwoFloorEvacuationDemo()) {
+        return makeTwoFloorEvacuationDemoImportResult();
+    }
+    if (metadata.layoutPath == builtInDemoLayoutPath() || metadata.isBuiltInEvacuationScenarioDemo()) {
+        return makeSprint1DemoImportResult();
     }
     if (metadata.isBlankLayoutProject()) {
         return makeBlankImportResult(metadata.name);
@@ -404,6 +445,8 @@ void MainWindow::openProject(const ProjectMetadata& metadata) {
     ProjectWorkspaceState workspace;
     if (metadata.isBuiltInEvacuationScenarioDemo()) {
         workspace = makeEvacuationScenarioDemoWorkspace();
+    } else if (metadata.isBuiltInTwoFloorEvacuationDemo()) {
+        workspace = makeTwoFloorEvacuationDemoWorkspace();
     } else if (!ProjectPersistence::loadProjectWorkspace(metadata, &workspace)) {
         showLayoutReview(metadata, std::move(importResult));
         return;

src/application/ProjectMetadata.h

@@ -12,20 +12,30 @@ inline QString builtInEvacuationScenarioDemoLayoutPath() {
     return QStringLiteral("safecrowd://demo/evacuation-scenario");
 }
 
+inline QString builtInTwoFloorEvacuationDemoLayoutPath() {
+    return QStringLiteral("safecrowd://demo/two-floor-evacuation");
+}
+
 struct ProjectMetadata {
     QString name{};
     QString folderPath{};
     QString layoutPath{};
     QString savedAt{};
 
     bool isBuiltInDemo() const noexcept {
-        return layoutPath == builtInDemoLayoutPath() || isBuiltInEvacuationScenarioDemo();
+        return layoutPath == builtInDemoLayoutPath()
+            || isBuiltInEvacuationScenarioDemo()
+            || isBuiltInTwoFloorEvacuationDemo();
     }
 
     bool isBuiltInEvacuationScenarioDemo() const noexcept {
         return layoutPath == builtInEvacuationScenarioDemoLayoutPath();
     }
 
+    bool isBuiltInTwoFloorEvacuationDemo() const noexcept {
+        return layoutPath == builtInTwoFloorEvacuationDemoLayoutPath();
+    }
+
     bool isBlankLayoutProject() const noexcept {
         return layoutPath.isEmpty();
     }
@@ -52,4 +62,11 @@ inline ProjectMetadata makeBuiltInEvacuationScenarioDemoProject() {
     };
 }
 
+inline ProjectMetadata makeBuiltInTwoFloorEvacuationDemoProject() {
+    return {
+        .name = QStringLiteral("Two-floor Evacuation Demo"),
+        .layoutPath = builtInTwoFloorEvacuationDemoLayoutPath(),
+    };
+}
+
 }  // namespace safecrowd::application

src/application/ProjectPersistence.cpp

@@ -1621,6 +1621,7 @@ QList<ProjectMetadata> ProjectPersistence::loadRecentProjects() {
     QList<ProjectMetadata> projects;
     projects.push_back(makeBuiltInDemoProject());
     projects.push_back(makeBuiltInEvacuationScenarioDemoProject());
+    projects.push_back(makeBuiltInTwoFloorEvacuationDemoProject());
 
     const auto document = readJsonDocument(recentProjectsPath());
     if (!document.isObject()) {

src/domain/DemoFixtureService.cpp

@@ -22,6 +22,28 @@ ScenarioDraft makeSprint1BlockedDoorAlternative(const ScenarioDraft& baseline) {
     return alternative;
 }
 
+ScenarioDraft makeTwoFloorEastExitGuidanceAlternative(const ScenarioDraft& baseline) {
+    using Ids = DemoLayouts::TwoFloorEvacuationIds;
+
+    auto alternative = duplicateScenarioDraft(
+        baseline,
+        "two-floor-guidance",
+        "East exit guidance alternative");
+    alternative.control.routeGuidances.push_back({
+        .id = "guidance-east-exit",
+        .startSeconds = 0.0,
+        .endSeconds = 180.0,
+        .periods = {{.startSeconds = 0.0, .endSeconds = 180.0}},
+        .guidedExitZoneId = Ids::EastExitZoneId,
+        .installConnectionId = Ids::UpperCorridorEastStairConnectionId,
+        .baseComplianceRate = 0.85,
+        .guidanceStrength = 0.85,
+        .maxDetourMeters = 30.0,
+    });
+    alternative.variationDiffKeys = computeScenarioDiffKeys(baseline, alternative);
+    return alternative;
+}
+
 DensityCellMetric densityCell(
     double centerX,
     double centerY,
@@ -779,6 +801,70 @@ DemoFixture DemoFixtureService::createSprint1DemoFixture() const {
     return fixture;
 }
 
+DemoAuthoringFixture DemoFixtureService::createTwoFloorEvacuationDemoFixture() const {
+    using Ids = DemoLayouts::TwoFloorEvacuationIds;
+
+    DemoAuthoringFixture fixture;
+    fixture.layout = DemoLayouts::twoFloorEvacuationFacility();
+
+    fixture.population.initialPlacements.push_back({
+        .id = "two-floor-west-training-crowd",
+        .zoneId = Ids::UpperWestTrainingZoneId,
+        .floorId = Ids::UpperFloorId,
+        .area = {
+            .outline = {
+                {2.0, 2.0},
+                {8.5, 2.0},
+                {8.5, 5.0},
+                {2.0, 5.0},
+            },
+        },
+        .targetAgentCount = 30,
+    });
+    fixture.population.initialPlacements.push_back({
+        .id = "two-floor-briefing-crowd",
+        .zoneId = Ids::UpperBriefingZoneId,
+        .floorId = Ids::UpperFloorId,
+        .area = {
+            .outline = {
+                {11.0, 2.0},
+                {17.0, 2.0},
+                {17.0, 5.0},
+                {11.0, 5.0},
+            },
+        },
+        .targetAgentCount = 20,
+    });
+    fixture.population.initialPlacements.push_back({
+        .id = "two-floor-east-training-crowd",
+        .zoneId = Ids::UpperEastTrainingZoneId,
+        .floorId = Ids::UpperFloorId,
+        .area = {
+            .outline = {
+                {19.5, 2.0},
+                {26.0, 2.0},
+                {26.0, 5.0},
+                {19.5, 5.0},
+            },
+        },
+        .targetAgentCount = 30,
+    });
+
+    fixture.baselineScenario.scenarioId = "two-floor-baseline";
+    fixture.baselineScenario.name = "Two-floor evacuation baseline";
+    fixture.baselineScenario.role = ScenarioRole::Baseline;
+    fixture.baselineScenario.population = fixture.population;
+    fixture.baselineScenario.execution.timeLimitSeconds = 600.0;
+    fixture.baselineScenario.execution.sampleIntervalSeconds = 1.0;
+    fixture.baselineScenario.execution.repeatCount = 1;
+    fixture.baselineScenario.execution.baseSeed = 42;
+    fixture.baselineScenario.sourceTemplateId = "two-floor-evacuation-baseline";
+
+    fixture.alternativeScenario = makeTwoFloorEastExitGuidanceAlternative(fixture.baselineScenario);
+
+    return fixture;
+}
+
 DemoScenarioResultFixture DemoFixtureService::createSprint1BlockedDoorResultFixture() const {
     const auto baselineFixture = createSprint1DemoFixture();
 

src/domain/DemoFixtureService.h

@@ -15,6 +15,13 @@ struct DemoFixture {
     ScenarioDraft baselineScenario{};
 };
 
+struct DemoAuthoringFixture {
+    FacilityLayout2D layout{};
+    PopulationSpec population{};
+    ScenarioDraft baselineScenario{};
+    ScenarioDraft alternativeScenario{};
+};
+
 struct DemoScenarioResultFixture {
     FacilityLayout2D layout{};
     PopulationSpec population{};
@@ -28,6 +35,7 @@ struct DemoScenarioResultFixture {
 class DemoFixtureService {
 public:
     DemoFixture createSprint1DemoFixture() const;
+    DemoAuthoringFixture createTwoFloorEvacuationDemoFixture() const;
     DemoScenarioResultFixture createSprint1BlockedDoorResultFixture() const;
 };