Polish submission workflow and board preview

app.py

@@ -50,7 +50,23 @@ def read_asset(name: str) -> str:
 
 def image_preview_html(path: str | None) -> str:
     if not path:
-        return "<div class='board-preview-empty'>Generate an analysis to create the presentation board preview.</div>"
+        return """
+        <div class="board-preview-empty board-preview-waiting">
+          <div class="empty-board-grid">
+            <div class="empty-board-title">
+              <span>Waiting for selected land</span>
+              <b>Presentation board will appear here</b>
+              <small>Draw a site boundary, drop a pin radius, or upload CAD/KML/GeoJSON. Optional project fields can stay blank.</small>
+            </div>
+            <div class="empty-board-card"><b>01</b><span>Boundary metrics</span></div>
+            <div class="empty-board-card"><b>02</b><span>Climate + sun/wind</span></div>
+            <div class="empty-board-card"><b>03</b><span>OSM context</span></div>
+            <div class="empty-board-card"><b>04</b><span>Terrain + soil caution</span></div>
+            <div class="empty-board-card"><b>05</b><span>Site-visit checklist</span></div>
+            <div class="empty-board-card"><b>06</b><span>Evidence table</span></div>
+          </div>
+        </div>
+        """
     try:
         source = validate_upload(
             path,
@@ -104,6 +120,15 @@ MAP_HTML = """
 </div>
 """
 
+DELIVERABLES_HTML = """
+<div class="deliverables-strip">
+  <div><b>Board PNG/PDF</b><span>sheet-style artifact</span></div>
+  <div><b>6 diagrams</b><span>climate, context, edge, matrix</span></div>
+  <div><b>Evidence</b><span>source / limit / verification</span></div>
+  <div><b>Report</b><span>editable workbook text</span></div>
+</div>
+"""
+
 SAMPLE_MAP_STATE = json.dumps(
     {
         "mode": "polygon",
@@ -714,6 +739,13 @@ def build_app() -> gr.Blocks:
                   <span>Climate, terrain, soil, OSM, and AI text are labelled by source, confidence, and verification need.</span>
                 </div>
               </div>
+              <div class="studio-proof-row">
+                <div><b>For students</b><span>faster studio sheets</span></div>
+                <div><b>For reviewers</b><span>sources and limits visible</span></div>
+                <div><b>For safety</b><span>no final foundation or legal claims</span></div>
+                <div><b>For demo</b><span>works from polygon only</span></div>
+              </div>
+              """ + DELIVERABLES_HTML + """
             </div>
             """
         )
@@ -770,6 +802,7 @@ def build_app() -> gr.Blocks:
                     </div>
                     """
                 )
+                map_generate_btn = gr.Button("Generate from selected site", variant="primary", elem_classes=["map-generate-button"])
                 gr.HTML(MAP_HTML)
                 map_state = gr.Textbox(label="Map state", elem_id="map_state", lines=4)
                 gr.HTML(
@@ -878,9 +911,7 @@ def build_app() -> gr.Blocks:
                 map_state,
             ],
         )
-        generate_btn.click(
-            fn=generate_site_analysis,
-            inputs=[
+        analysis_inputs = [
                 project_name,
                 site_name,
                 project_type,
@@ -895,8 +926,8 @@ def build_app() -> gr.Blocks:
                 geojson_file,
                 kml_file,
                 pdf_file,
-            ],
-            outputs=[
+            ]
+        analysis_outputs = [
                 board_preview,
                 board_png_file,
                 board_pdf_file,
@@ -911,7 +942,16 @@ def build_app() -> gr.Blocks:
                 evidence_table,
                 warnings_output,
                 assistant_output,
-            ],
+            ]
+        generate_btn.click(
+            fn=generate_site_analysis,
+            inputs=analysis_inputs,
+            outputs=analysis_outputs,
+        )
+        map_generate_btn.click(
+            fn=generate_site_analysis,
+            inputs=analysis_inputs,
+            outputs=analysis_outputs,
         )
         if "js" not in block_parameters:
             demo.load(fn=None, js=map_js_callback)

assets/style.css

@@ -341,9 +341,42 @@ body {
   line-height: 1.42;
 }
 
+.studio-proof-row {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  border-top: 1px solid var(--rule);
+  background: #f3f8f6;
+}
+
+.studio-proof-row div {
+  min-height: 68px;
+  padding: 13px 18px;
+  border-right: 1px solid var(--line);
+}
+
+.studio-proof-row div:last-child {
+  border-right: 0;
+}
+
+.studio-proof-row b {
+  display: block;
+  color: var(--survey-green-dark);
+  font-family: var(--font-display);
+  font-size: 13px;
+  font-weight: 900;
+  text-transform: uppercase;
+}
+
+.studio-proof-row span {
+  display: block;
+  margin-top: 4px;
+  color: var(--ink-soft) !important;
+  font-size: 13px;
+}
+
 .studio-workbench {
   display: grid !important;
-  grid-template-columns: minmax(260px, 0.82fr) minmax(560px, 1.7fr) minmax(280px, 0.9fr);
+  grid-template-columns: minmax(230px, 0.68fr) minmax(660px, 1.9fr) minmax(270px, 0.78fr);
   gap: 16px !important;
   align-items: start !important;
   margin-top: 16px;
@@ -517,6 +550,47 @@ body {
   line-height: 1.4;
 }
 
+.deliverables-strip {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 0;
+  margin: 12px 0;
+  border: 1px solid var(--rule);
+  border-radius: var(--radius);
+  overflow: hidden;
+  background: #ffffff;
+  box-shadow: var(--shadow-flat);
+}
+
+.deliverables-strip div {
+  min-height: 72px;
+  padding: 13px 14px;
+  border-right: 1px solid var(--line);
+  background:
+    linear-gradient(180deg, rgba(15, 118, 110, 0.07), transparent 65%),
+    #ffffff;
+}
+
+.deliverables-strip div:last-child {
+  border-right: 0;
+}
+
+.deliverables-strip b {
+  display: block;
+  color: var(--ink);
+  font-family: var(--font-display);
+  font-size: 15px;
+  font-weight: 900;
+}
+
+.deliverables-strip span {
+  display: block;
+  margin-top: 5px;
+  color: var(--ink-soft) !important;
+  font-size: 12px;
+  line-height: 1.35;
+}
+
 .review-header {
   margin: 22px 0 12px;
   border: 1px solid var(--rule);
@@ -846,6 +920,7 @@ body {
 }
 
 .generate-button button,
+.map-generate-button button,
 button.primary {
   min-height: 54px !important;
   background: linear-gradient(90deg, var(--survey-green), #0b5f57) !important;
@@ -860,11 +935,18 @@ button.primary {
 }
 
 .generate-button button:hover,
+.map-generate-button button:hover,
 button.primary:hover {
   background: linear-gradient(90deg, var(--cad-blue), var(--survey-green-dark)) !important;
   transform: translate(-1px, -1px);
 }
 
+.map-generate-button button {
+  width: 100% !important;
+  min-height: 58px !important;
+  font-size: 17px !important;
+}
+
 .tabs {
   margin-top: 20px !important;
 }
@@ -932,6 +1014,96 @@ button.primary:hover {
   background-size: 32px 32px, 32px 32px, auto;
 }
 
+.board-preview-waiting {
+  min-height: 560px;
+  padding: 28px;
+  place-items: stretch;
+}
+
+.empty-board-grid {
+  display: grid;
+  height: 100%;
+  min-height: 500px;
+  grid-template-columns: 1.55fr repeat(2, minmax(0, 1fr));
+  grid-auto-rows: minmax(130px, auto);
+  gap: 14px;
+}
+
+.empty-board-title {
+  grid-row: span 2;
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-end;
+  border: 1px solid var(--rule);
+  border-radius: var(--radius);
+  padding: 24px;
+  background:
+    linear-gradient(90deg, rgba(255, 255, 255, 0.06) 1px, transparent 1px),
+    linear-gradient(rgba(255, 255, 255, 0.055) 1px, transparent 1px),
+    #101716;
+  background-size: 32px 32px, 32px 32px, auto;
+  color: #ffffff;
+}
+
+.empty-board-title span {
+  color: #8ce6dc !important;
+  font-family: var(--font-mono);
+  font-size: 12px;
+  font-weight: 850;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.empty-board-title b {
+  display: block;
+  max-width: 540px;
+  margin-top: 12px;
+  color: #ffffff;
+  font-family: var(--font-display);
+  font-size: clamp(31px, 3vw, 54px);
+  font-weight: 900;
+  line-height: 0.98;
+}
+
+.empty-board-title small {
+  display: block;
+  max-width: 560px;
+  margin-top: 14px;
+  color: #d5e0dd !important;
+  font-size: 15px;
+  line-height: 1.45;
+}
+
+.empty-board-card {
+  border: 1px solid var(--line-strong);
+  border-radius: var(--radius);
+  padding: 18px;
+  background: #ffffff;
+  color: var(--ink);
+  box-shadow: 4px 4px 0 rgba(17, 22, 20, 0.08);
+}
+
+.empty-board-card b {
+  display: grid;
+  width: 36px;
+  height: 36px;
+  place-items: center;
+  margin-bottom: 20px;
+  background: var(--ink);
+  color: #ffffff;
+  font-family: var(--font-mono);
+  font-size: 12px;
+}
+
+.empty-board-card span {
+  display: block;
+  color: var(--ink);
+  font-family: var(--font-display);
+  font-size: 19px;
+  font-weight: 900;
+  line-height: 1.12;
+}
+
 .board-preview-frame img {
   display: block;
   width: 100%;
@@ -1256,16 +1428,28 @@ footer {
   }
 
   .studio-briefing,
+  .studio-proof-row,
   .studio-workbench {
     grid-template-columns: 1fr !important;
   }
 
-  .studio-briefing div {
+  .studio-shell > .deliverables-strip,
+  .studio-proof-row {
+    display: none;
+  }
+
+  .studio-briefing div:nth-child(n + 2) {
+    display: none;
+  }
+
+  .studio-briefing div,
+  .studio-proof-row div {
     border-right: 0;
     border-bottom: 1px solid var(--line);
   }
 
-  .studio-briefing div:last-child {
+  .studio-briefing div:last-child,
+  .studio-proof-row div:last-child {
     border-bottom: 0;
   }
 
@@ -1343,6 +1527,37 @@ footer {
     max-width: 128px;
   }
 
+  .deliverables-strip {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+
+  .deliverables-strip div:nth-child(2n) {
+    border-right: 0;
+  }
+
+  .deliverables-strip div {
+    border-bottom: 1px solid var(--line);
+  }
+
+  .deliverables-strip div:nth-last-child(-n + 2) {
+    border-bottom: 0;
+  }
+
+  .empty-board-grid {
+    grid-template-columns: 1fr;
+    min-height: auto;
+  }
+
+  .empty-board-title {
+    grid-row: auto;
+    min-height: 260px;
+  }
+
+  .board-preview-waiting {
+    min-height: auto;
+    padding: 14px;
+  }
+
   .control-panel {
     margin-top: 16px !important;
   }

src/board_export.py

@@ -363,13 +363,24 @@ def _context_caption(osm_context: dict[str, Any], selection: SiteSelection) -> s
 
 
 def _sun_caption(sun_summary: dict[str, str]) -> str:
-    pieces = [
-        sun_summary.get("orientation_note", ""),
-        sun_summary.get("east_west_note", ""),
-        sun_summary.get("wind_note", ""),
-        "No surrounding-building shadow simulation.",
-    ]
-    return " ".join(piece for piece in pieces if piece)
+    orientation = sun_summary.get("orientation_note", "")
+    if "southern" in orientation.lower():
+        orientation = "Sun cue: generally southern sky at this latitude."
+    elif orientation:
+        orientation = "Sun cue: use latitude-based solar orientation."
+    else:
+        orientation = "Sun cue unavailable; verify with sun-path study."
+    wind = sun_summary.get("wind_note", "")
+    if wind:
+        wind = wind.replace("Available climate data suggests dominant wind around", "Wind cue:")
+        wind = wind.replace("Treat this as regional context and verify on site.", "Verify on site.")
+        wind = _clip(wind, 62)
+    else:
+        wind = "Wind: regional/modelled cue only; verify comfort and ventilation on site."
+    return (
+        f"{orientation} West/east edges need glare and heat checks. "
+        f"{wind} No shadow sim."
+    )
 
 
 def _design_cues(