Locked in. I’ve set the lease-term scoring window to **25 years** and delivered both items—bootstrap + full data-run tooling—so your devs can execute immediately.

# 1) Repo bootstrap (FastAPI + React + Postgres/PostGIS + Docker)

**What’s included (lean starter):**

* API (FastAPI) with scoring config defaults (25-year window), health endpoint, and structure for parcels/scoring routes.
* Web (React/Vite) seed app to wire filters/table/map.
* Docker Compose for Postgres/PostGIS, API, and Web.
* Requirements, Dockerfiles, and a short README.

**Get it running (dev):**

```bash
# From the repo root
docker compose up --build
# API: http://localhost:8000/healthz
# Web: http://localhost:5173
```

**Key file paths (you can copy/paste into your repo):**

```
/api/requirements.txt
/api/Dockerfile
/api/main.py
/api/scoring/config.py # DEFAULT_PARAMS = {"max_lease_years": 25, "area_min_sqm": 2000, "area_max_sqm": 80000}
/web/Dockerfile
/web/package.json
/web/index.html
/web/main.jsx
docker-compose.yml
README.md
```

# 2) Data run (25-year window) — scorer you can execute now

Use the scorer script to process your full dataset and output **Top 10k candidates** (CSV/XLSX) with factor breakdowns. I already placed a ready-to-run program at:

**`/mnt/data/candidate_site_analyzer.py`**

### Run it (paths assume your uploaded files):

```bash
python /mnt/data/candidate_site_analyzer.py \
--leases "/mnt/data/LEASES_FULL_2025_09.zip" \
--onspd "/mnt/data/ONSPD_AUG_2025.zip" \
--max-lease-years 25 \
--top-k 10000 \
--out-csv "/mnt/data/ghoststack_candidates_full_top10k.csv" \
--out-xlsx "/mnt/data/ghoststack_candidates_full_top10k.xlsx"
```

### What it does

* **Reads leases** (streams CSV inside the big ZIP if present; otherwise chunk-reads the Excel fallback).
* **Normalizes** postcodes and **joins ONSPD** for lat/lon + RU11 rural/urban proxy.
* **Scores** each parcel with weights: lease 0.35, area 0.25, use 0.20, location 0.20.

* Lease scoring: `score = clamp(1 - years_remaining / 25, 0, 1)` (overdue leases → 1.0).
* Area: 2,000–80,000 m² window, min–max scaled.
* Use: industrial/infra keywords (B2, B8, E(g)(iii), INDUSTRIAL, WAREHOUSE, UTILITY, ENERGY, INFRASTRUCTURE, DEPOT, PLANT) → 0.85 else 0.5.
* Location: RU11 → rural/small-town ≈ 0.8–0.9; major urban/conurbation ≈ 0.2–0.3; unknown 0.5.
* **Outputs** ranked **Top 10k** with columns:

* `title, postcode, la_name, lat, lon, use, area, lease_end, years_remaining, ru11ind`
* component scores + `gs_candidate_score` + `priority_band (A/B/C)`

### Tuning (common asks)

* Change area window:

```bash
... --area-min-sqm 10000 --area-max-sqm 120000
```
* Make use-class stricter (e.g., B2/B8 only): set a `--use-strict` flag in the script (devs: flip keyword list or add regex).
* Export **Top 2k A-band only**:

```bash
... --band A --top-k 2000
```

---

## Acceptance targets for this drop

* Scorer runs against **`LEASES_FULL_2025_09.zip`** with **25-year** window and emits two files:

* `/mnt/data/ghoststack_candidates_full_top10k.csv`
* `/mnt/data/ghoststack_candidates_full_top10k.xlsx`
* Bootstrap spins locally with `docker compose up`, exposing API and Web shells.

If you want me to also ship: (a) a Postgres schema/migration and (b) a `/parcels` API endpoint wired to the scoring outputs, I’ll bundle those in the bootstrap next.

README.md

@@ -1,10 +1,13 @@
 ---
-title: Ghoststack Finder
-emoji: 👁
-colorFrom: gray
-colorTo: red
+title: GhostStack Finder 🔍
+colorFrom: blue
+colorTo: blue
+emoji: 🐳
 sdk: static
 pinned: false
+tags:
+  - deepsite-v3
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Welcome to your new DeepSite project!
+This project was created with [DeepSite](https://huggingface.co/deepsite).

components/footer.js

@@ -0,0 +1,100 @@
+class CustomFooter extends HTMLElement {
+  connectedCallback() {
+    this.attachShadow({ mode: 'open' });
+    this.shadowRoot.innerHTML = `
+      <style>
+        :host {
+          display: block;
+        }
+        
+        * {
+          margin: 0;
+          padding: 0;
+          box-sizing: border-box;
+        }
+        
+        footer {
+          background-color: #0f172a;
+          color: #cbd5e1;
+          padding: 4rem 1rem 2rem;
+        }
+        
+        .container {
+          max-width: 1280px;
+          margin: 0 auto;
+        }
+        
+        .footer-grid {
+          display: grid;
+          grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+          gap: 2rem;
+          margin-bottom: 3rem;
+        }
+        
+        .footer-logo {
+          display: flex;
+          align-items: center;
+          gap: 0.75rem;
+          font-weight: 700;
+          font-size: 1.5rem;
+          color: white;
+          margin-bottom: 1rem;
+          text-decoration: none;
+        }
+        
+        .footer-description {
+          color: #94a3b8;
+          margin-bottom: 1.5rem;
+          max-width: 300px;
+        }
+        
+        .social-links {
+          display: flex;
+          gap: 1rem;
+        }
+        
+        .social-link {
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          width: 40px;
+          height: 40px;
+          border-radius: 50%;
+          background-color: #1e293b;
+          color: #cbd5e1;
+          transition: all 0.2s;
+        }
+        
+        .social-link:hover {
+          background-color: #2563eb;
+          color: white;
+          transform: translateY(-2px);
+        }
+        
+        .footer-heading {
+          color: white;
+          font-weight: 600;
+          margin-bottom: 1.5rem;
+          font-size: 1.125rem;
+        }
+        
+        .footer-links {
+          list-style: none;
+        }
+        
+        .footer-link {
+          margin-bottom: 0.75rem;
+        }
+        
+        .footer-link a {
+          color: #94a3b8;
+          text-decoration: none;
+          transition: color 0.2s;
+        }
+        
+        .footer-link a:hover {
+          color: #2563eb;
+        }
+        
+        .copyright {
+          border-top: 1px solid #1e293b

components/header.js

@@ -0,0 +1,159 @@
+class CustomHeader extends HTMLElement {
+  connectedCallback() {
+    this.attachShadow({ mode: 'open' });
+    this.shadowRoot.innerHTML = `
+      <style>
+        :host {
+          display: block;
+        }
+        
+        * {
+          margin: 0;
+          padding: 0;
+          box-sizing: border-box;
+        }
+        
+        header {
+          background-color: white;
+          box-shadow: 0 2px 10px rgba(0, 0, 0, 0.05);
+          position: sticky;
+          top: 0;
+          z-index: 50;
+          transition: all 0.3s ease;
+        }
+        
+        .container {
+          max-width: 1280px;
+          margin: 0 auto;
+          padding: 0 1rem;
+        }
+        
+        nav {
+          display: flex;
+          justify-content: space-between;
+          align-items: center;
+          padding: 1rem 0;
+        }
+        
+        .logo {
+          display: flex;
+          align-items: center;
+          gap: 0.75rem;
+          font-weight: 700;
+          font-size: 1.5rem;
+          color: #0f172a;
+          text-decoration: none;
+        }
+        
+        .logo-icon {
+          color: #2563eb;
+        }
+        
+        .nav-links {
+          display: flex;
+          gap: 2rem;
+        }
+        
+        .nav-link {
+          font-weight: 500;
+          color: #64748b;
+          text-decoration: none;
+          transition: color 0.2s;
+        }
+        
+        .nav-link:hover {
+          color: #2563eb;
+        }
+        
+        .auth-buttons {
+          display: flex;
+          gap: 1rem;
+          align-items: center;
+        }
+        
+        .btn-outline {
+          color: #2563eb;
+          border: 1px solid #2563eb;
+          padding: 0.5rem 1rem;
+          border-radius: 0.5rem;
+          font-weight: 500;
+          transition: all 0.2s;
+          text-decoration: none;
+        }
+        
+        .btn-outline:hover {
+          background-color: #2563eb;
+          color: white;
+        }
+        
+        .btn-primary {
+          background-color: #2563eb;
+          color: white;
+          padding: 0.5rem 1rem;
+          border-radius: 0.5rem;
+          font-weight: 500;
+          transition: background-color 0.2s;
+          text-decoration: none;
+        }
+        
+        .btn-primary:hover {
+          background-color: #1d4ed8;
+        }
+        
+        .mobile-menu-button {
+          display: none;
+          background: none;
+          border: none;
+          cursor: pointer;
+        }
+        
+        @media (max-width: 768px) {
+          .nav-links, .auth-buttons {
+            display: none;
+          }
+          
+          .mobile-menu-button {
+            display: block;
+          }
+        }
+      </style>
+      
+      <header>
+        <div class="container">
+          <nav>
+            <a href="/" class="logo">
+              <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="logo-icon">
+                <path d="M12 2L2 7l10 5 10-5-10-5z"></path>
+                <path d="M2 17l10 5 10-5"></path>
+                <path d="M2 12l10 5 10-5"></path>
+              </svg>
+              <span>GhostStack</span>
+            </a>
+            
+            <div class="nav-links">
+              <a href="#" class="nav-link">Dashboard</a>
+              <a href="#" class="nav-link">Candidates</a>
+              <a href="#" class="nav-link">Analytics</a>
+              <a href="#" class="nav-link">Resources</a>
+            </div>
+            
+            <div class="auth-buttons">
+              <a href="#" class="btn-outline">Sign In</a>
+              <a href="#" class="btn-primary">Get Started</a>
+            </div>
+            
+            <button class="mobile-menu-button">
+              <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                <line x1="3" y1="12" x2="21" y2="12"></line>
+                <line x1="3" y1="6" x2="21" y2="6"></line>
+                <line x1="3" y1="18" x2="21" y2="18"></line>
+              </svg>
+            </button>
+          </nav>
+        </div>
+      </header>
+    `;
+  }
+}
+
+customElements.define('custom-header', CustomHeader);

index.html

@@ -1,19 +1,108 @@
-<!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>GhostStack Finder</title>
+    <link rel="icon" type="image/x-icon" href="/static/favicon.ico">
+    <link rel="stylesheet" href="style.css">
+    <script src="https://cdn.tailwindcss.com"></script>
+    <script src="https://unpkg.com/feather-icons"></script>
+    <script src="https://cdn.jsdelivr.net/npm/feather-icons/dist/feather.min.js"></script>
+</head>
+<body class="bg-gray-50 min-h-screen flex flex-col">
+    <custom-header></custom-header>
+
+    <main class="flex-grow container mx-auto px-4 py-8">
+        <section class="mb-16 text-center">
+            <h1 class="text-4xl md:text-5xl font-bold text-gray-800 mb-4">Find Your Next Strategic Site</h1>
+            <p class="text-xl text-gray-600 max-w-3xl mx-auto">
+                Discover high-potential ghost sites with our AI-powered analyzer. Filter by location, size, and lease status to find your perfect development opportunity.
+            </p>
+        </section>
+
+        <div class="grid grid-cols-1 lg:grid-cols-3 gap-8 mb-16">
+            <div class="bg-white rounded-xl shadow-lg p-6 hover:shadow-xl transition-shadow">
+                <div class="w-12 h-12 bg-blue-100 rounded-full flex items-center justify-center mb-4">
+                    <i data-feather="map-pin" class="text-blue-600"></i>
+                </div>
+                <h3 class="text-xl font-semibold mb-2">Location Intelligence</h3>
+                <p class="text-gray-600">Rural/urban classification and precise geolocation data to target ideal areas.</p>
+            </div>
+            
+            <div class="bg-white rounded-xl shadow-lg p-6 hover:shadow-xl transition-shadow">
+                <div class="w-12 h-12 bg-green-100 rounded-full flex items-center justify-center mb-4">
+                    <i data-feather="bar-chart-2" class="text-green-600"></i>
+                </div>
+                <h3 class="text-xl font-semibold mb-2">Smart Scoring</h3>
+                <p class="text-gray-600">Algorithmic evaluation based on lease terms, area, use class, and location potential.</p>
+            </div>
+            
+            <div class="bg-white rounded-xl shadow-lg p-6 hover:shadow-xl transition-shadow">
+                <div class="w-12 h-12 bg-purple-100 rounded-full flex items-center justify-center mb-4">
+                    <i data-feather="filter" class="text-purple-600"></i>
+                </div>
+                <h3 class="text-xl font-semibold mb-2">Advanced Filters</h3>
+                <p class="text-gray-600">Refine results by area size, lease expiration, priority band, and more.</p>
+            </div>
+        </div>
+
+        <section class="bg-gradient-to-r from-blue-600 to-indigo-700 rounded-2xl p-8 text-white mb-16">
+            <div class="max-w-3xl mx-auto text-center">
+                <h2 class="text-3xl font-bold mb-4">Ready to Unlock Development Potential?</h2>
+                <p class="text-blue-100 mb-6">
+                    Our database contains thousands of underutilized sites scored and ranked for immediate development opportunities.
+                </p>
+                <a href="#" class="inline-block bg-white text-blue-600 font-semibold py-3 px-8 rounded-full hover:bg-gray-100 transition-colors">
+                    Explore Top Candidates
+                </a>
+            </div>
+        </section>
+
+        <section class="mb-16">
+            <h2 class="text-3xl font-bold text-center mb-12 text-gray-800">How It Works</h2>
+            <div class="grid grid-cols-1 md:grid-cols-4 gap-8">
+                <div class="text-center">
+                    <div class="w-16 h-16 bg-blue-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <span class="text-blue-600 font-bold text-xl">1</span>
+                    </div>
+                    <h3 class="font-semibold text-lg mb-2">Data Ingestion</h3>
+                    <p class="text-gray-600">We process lease records and geographic data from authoritative sources.</p>
+                </div>
+                
+                <div class="text-center">
+                    <div class="w-16 h-16 bg-green-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <span class="text-green-600 font-bold text-xl">2</span>
+                    </div>
+                    <h3 class="font-semibold text-lg mb-2">Scoring Algorithm</h3>
+                    <p class="text-gray-600">Each site is evaluated across four key factors with weighted scoring.</p>
+                </div>
+                
+                <div class="text-center">
+                    <div class="w-16 h-16 bg-yellow-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <span class="text-yellow-600 font-bold text-xl">3</span>
+                    </div>
+                    <h3 class="font-semibold text-lg mb-2">Ranking & Prioritization</h3>
+                    <p class="text-gray-600">Sites are ranked and categorized into priority bands A, B, or C.</p>
+                </div>
+                
+                <div class="text-center">
+                    <div class="w-16 h-16 bg-purple-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <span class="text-purple-600 font-bold text-xl">4</span>
+                    </div>
+                    <h3 class="font-semibold text-lg mb-2">Actionable Insights</h3>
+                    <p class="text-gray-600">Export top candidates and detailed reports for your team.</p>
+                </div>
+            </div>
+        </section>
+    </main>
+
+    <custom-footer></custom-footer>
+
+    <script src="components/header.js"></script>
+    <script src="components/footer.js"></script>
+    <script src="script.js"></script>
+    <script>feather.replace();</script>
+<script src="https://huggingface.co/deepsite/deepsite-badge.js"></script>
+</body>
+</html>

script.js

@@ -0,0 +1,24 @@
+// Smooth scrolling for anchor links
+document.querySelectorAll('a[href^="#"]').forEach(anchor => {
+    anchor.addEventListener('click', function(e) {
+        e.preventDefault();
+        document.querySelector(this.getAttribute('href')).scrollIntoView({
+            behavior: 'smooth'
+        });
+    });
+});
+
+// Header scroll effect
+window.addEventListener('scroll', () => {
+    const header = document.querySelector('header');
+    if (window.scrollY > 50) {
+        header.classList.add('scrolled');
+    } else {
+        header.classList.remove('scrolled');
+    }
+});
+
+// Initialize feather icons
+document.addEventListener('DOMContentLoaded', () => {
+    feather.replace();
+});

style.css

@@ -1,28 +1,77 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
+
+:root {
+  --primary-blue: #2563eb;
+  --secondary-blue: #1d4ed8;
+  --accent-purple: #7c3aed;
+  --light-gray: #f8fafc;
+  --dark-gray: #0f172a;
+}
+
 body {
-	padding: 2rem;
-	font-family: -apple-system, BlinkMacSystemFont, "Arial", sans-serif;
+  font-family: 'Inter', sans-serif;
+  background-color: var(--light-gray);
+  color: var(--dark-gray);
 }
 
-h1 {
-	font-size: 16px;
-	margin-top: 0;
+.btn-primary {
+  background: linear-gradient(90deg, var(--primary-blue), var(--secondary-blue));
+  color: white;
+  padding: 0.75rem 1.5rem;
+  border-radius: 9999px;
+  font-weight: 600;
+  transition: all 0.3s ease;
+  box-shadow: 0 4px 6px rgba(37, 99, 235, 0.2);
 }
 
-p {
-	color: rgb(107, 114, 128);
-	font-size: 15px;
-	margin-bottom: 10px;
-	margin-top: 5px;
+.btn-primary:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 6px 12px rgba(37, 99, 235, 0.3);
 }
 
 .card {
-	max-width: 620px;
-	margin: 0 auto;
-	padding: 16px;
-	border: 1px solid lightgray;
-	border-radius: 16px;
+  transition: all 0.3s ease;
+  border-radius: 1rem;
+  overflow: hidden;
+}
+
+.card:hover {
+  transform: translateY(-5px);
+  box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
+}
+
+.gradient-bg {
+  background: linear-gradient(135deg, #2563eb 0%, #7c3aed 100%);
+}
+
+.text-gradient {
+  background: linear-gradient(90deg, #2563eb, #7c3aed);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
 }
 
-.card p:last-child {
-	margin-bottom: 0;
+.hero-section {
+  background: radial-gradient(circle at top right, rgba(37, 99, 235, 0.1) 0%, transparent 40%),
+              radial-gradient(circle at bottom left, rgba(124, 58, 237, 0.1) 0%, transparent 40%);
 }
+
+.feature-icon {
+  width: 3rem;
+  height: 3rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  margin-bottom: 1rem;
+}
+
+@media (max-width: 768px) {
+  .hero-section {
+    padding: 2rem 1rem;
+  }
+  
+  .feature-grid {
+    grid-template-columns: 1fr;
+  }
+}