LCIS User Manual

1Getting Started

Login & Authentication

LCIS is partner-gated. Two sign-in methods are supported:

• Email + Password — enter your address and password, click Sign In
• Google SSO — click the Google button; uses your existing Google account

Your session is stored in browser localStorage. You stay logged in until you sign out via the 👤 Your Name button. Clearing browser data or using incognito requires re-login.

// Runs on every page load — blocks UI if not authenticated
const REQUIRE_LOGIN = true;
function checkAuth(){
  const name = localStorage.getItem('re_name');
  if(name){ document.getElementById('lbtn').textContent='👤 '+name.split(' ')[0]; return true; }
  if(REQUIRE_LOGIN){ document.getElementById('login-overlay').style.display='flex'; return false; }
  return true;
}
if(checkAuth()){ load(); initSavedSearches(); setTimeout(checkDeepLink,800); }

Navigation Overview

LCIS Home — sticky header navigation, live stats bar, Top Scored Deals, and quick-access feature tiles

2Home Dashboard

Stats Bar

Five live counters. Each is clickable and navigates to a pre-filtered listing view:

function updateStats(){
  document.getElementById('s-land').textContent = all.filter(l=>l.type==='land').length;
  document.getElementById('s-comm').textContent = all.filter(l=>l.type==='commercial').length;
  document.getElementById('s-new').textContent  = all.filter(l=>l.is_new).length;
  document.getElementById('s-drop').textContent = all.filter(l=>l.price_drop||false).length;
}

⭐ Top Scored Deals

Top 6 listings by investment score. Click View All → for the full sorted view. Click any mini-card to open the full detail modal.

function renderHomeDeals(){
  const top = [...all].sort((a,b)=>(b.score||0)-(a.score||0)).slice(0,6);
  // renders 6 mini cards: price, $/ac, location, grade badge, score ring
}

Recently Viewed Strip

Appears after you've clicked property detail modals. Stored in sessionStorage (clears when tab closes). Click Clear to reset.

3Land Listings

Land view — filter sidebar (left), market snapshot bar, county filter chips, and scored property cards with grade badges and score rings

Filter Panel

function applyF(){
  let list = all.filter(l=>l.type===ctype);
  if(ctype==='land'&&counties.length)
    list=list.filter(l=>counties.some(c=>(l.county||'').toLowerCase().includes(c)));
  const ma=+document.getElementById('f-acres').value||0;
  const mp=+document.getElementById('f-maxp-l').value||Infinity;
  const pp=+document.getElementById('f-ppa').value||Infinity;
  if(ma) list=list.filter(l=>(l.acres||0)>=ma);
  if(mp!l.price||l.price<=mp);
  if(pp{const v=l.acres&&l.price?l.price/l.acres:null;return !v||v<=pp;});
  filtered=list;
  renderCards(sortL());
  renderMarketSnap(filtered);
  updateFilterCount(filtered.length);
}

County Selection

Two collapsible sections. Click a header to expand/collapse:

• Rural VA (Land) — Clarke, Fauquier, Frederick, Rappahannock, Warren, Culpeper, Madison, Shenandoah. Each shows a live listing count.
• NoVA / DC (Commercial) — Northern Virginia / DC market counties.

Click All/None to toggle all counties. The county bar above cards lets you click a chip to isolate that county instantly. Click All ✕ to clear.

Sorting & Market Snapshot

Sort dropdown: Best Score · Price ↑/↓ · $/Acre ↑ · Newest

The Market Snapshot bar above cards shows: Median Price · Avg $/Acre · Avg Days on Market · New (30d) · Total Results. Updates live with every filter change.

function renderMarketSnap(list){
  const sorted=list.filter(l=>l.price>0).map(l=>l.price).sort((a,b)=>a-b);
  const med=sorted[Math.floor(sorted.length/2)];
  const ppas=list.filter(l=>l.acres&&l.price).map(l=>l.price/l.acres);
  const avgPPA=ppas.length?Math.round(ppas.reduce((a,b)=>a+b,0)/ppas.length):null;
  // renders: Median Price · Avg $/Acre · Avg DOM · New(30d) · Results
}

4Commercial Listings

Click 🏢 Commercial in the header or the tab above cards. The filter sidebar updates to commercial-specific fields.

// Applied inside applyF() when ctype === 'commercial'
const mn=+document.getElementById('f-minp-c').value||0;
const mx=+document.getElementById('f-maxp-c').value||Infinity;
const ms=+document.getElementById('f-sqft').value||0;
const ct=document.getElementById('f-ctype').value;
if(mn) list=list.filter(l=>!l.price||l.price>=mn);
if(mx!l.price||l.price<=mx);
if(ms) list=list.filter(l=>(l.sqft||0)>=ms);
if(ct) list=list.filter(l=>(l.property_type||'').toLowerCase().includes(ct.toLowerCase()));

5Property Cards

Each listing renders as a card designed to surface critical investment signals at a glance.

Score Ring & Grade Badge

Bottom-right: Score Ring — circular SVG arc (0–100). Bottom-left: Grade Badge:

• A  80–100 — Exceptional. Investigate immediately.
• B  60–79 — Strong deal, worth a closer look.
• C  40–59 — Average. Review carefully before pursuing.
• D  0–39 — Below average. Low priority.

function gradeLabel(sc){
  if(sc===null)return'';
  const g=sc>=80?'A':sc>=60?'B':sc>=40?'C':'D';
  return`<span class="grade-badge gr-${g.toLowerCase()}">${g}</span>`;
}
function scoreRing(sc){
  if(sc===null)return'';
  const r=15,circ=2*Math.PI*r,offset=circ-(sc/100)*circ;
  const tier=sc>=80?'a':sc>=60?'b':sc>=40?'c':'d';
  return`<div class="score-ring"><svg ...stroke-dashoffset arc...></svg>
         <div class="sr-val">${sc}</div></div>`;
}

PPA Hero & Percentile Badge

For land cards, Price Per Acre (PPA) is the primary value signal. The Percentile Badge compares to all current filtered land:

• Below avg $/ac — priced below the median PPA (buy signal)
• At avg $/ac — near the median
• Above avg $/ac — premium vs. comparable parcels

For commercial cards, a Cap Badge shows cap rate when available from Crexi data.

Card Action Buttons

Click anywhere on the card body to open the full Property Detail modal.

function renderCards(list){
  const g=document.getElementById('cg');
  g.innerHTML=list.map(l=>{
    const sc=l.score?Math.round(l.score*100):null;
    const isL=l.type==='land';
    const rawPPA=l.acres&&l.price?l.price/l.acres:null;
    const ppu=isL?(rawPPA?'$'+Math.round(rawPPA).toLocaleString()+'/ac':'')
                  :(l.sqft?'$'+Math.round(l.price/l.sqft)+'/sqft':'');
    return`<div class="lc" onclick="openDetail(${l.id})">
      ${ppu?`<div class="ppa-hero">${ppu} ${isL?pctBadge(rawPPA):capBadge(...)}</div>`:''}
      ${gradeLabel(sc)} ${scoreRing(sc)}
    </div>`;
  }).join('');
  observeCards(); // IntersectionObserver lazy-loads photos on scroll
}

6Property Detail

Property detail modal — hero photo, metrics grid, Quick Investment Calc, and action buttons (Watch / Map / Share / Print)

Click any property card to open a slide-up detail modal — your primary single-property due diligence view.

Metrics Grid

⚡ Quick Investment Calc

Auto-calculated for land listings:

• Price/Acre — restated $/ac for quick reference
• Est. 20-ac lots — how many 20-acre sub-lots, and retail value each at 2.5× markup
• Est. 5-ac lots — how many 5-acre sub-lots and retail value each
• Est. Annual Tax — rough estimate at 0.85% of purchase price per year

function openDetail(id){
  const l=all.find(x=>x.id===id);
  currentDetailId=id;
  trackView(id); // adds to Recently Viewed strip
  const ppa=l.price/l.acres;
  const lots20=Math.floor(l.acres/20);
  const lots5=Math.floor(l.acres/5);
  const val20=lots20*ppa*20*2.5; // 2.5× markup on raw land cost
  const val5=lots5*ppa*5*2.5;
  const taxEst=l.price*0.0085;   // 0.85% annual tax estimate
  document.getElementById('detail-modal').style.display='flex';
  document.getElementById('detail-backdrop').style.display='block';
}

Detail Action Buttons

Keyboard nav while modal is open: → next listing · ← previous · Esc close

7GIS Map View

GIS Map — listing markers (green = land, blue = commercial), county parcel overlays, and right-side layer control panel

Click 🗺️ Map to open the interactive GIS map (Leaflet). All loaded listings appear as clickable markers.

Basemap Options

• 🗺 Street — OpenStreetMap road view (default)
• 🛰 Satellite — aerial imagery — use for visual site assessment
• ⛰ Topo — topographic elevation — useful for evaluating terrain and drainage

Map Layers Panel

Draw Search Area

• ✏ Draw — draw a polygon on the map. A 🔍 Search this area button appears. Click it to filter listings to only those within your drawn boundary.
• 🗑 Clear — removes the boundary and restores all listings

Click any marker for a popup with key data and a Details button that opens the full property detail modal.

function initMap(){
  map=L.map('map').setView([38.8,-77.8],9);
  // basemap tiles, Leaflet.draw toolbar, zoom controls
}
async function togParcel(county,on){
  if(on){
    const geo=await fetch(`/api/re/parcels/${county}`).then(r=>r.json());
    parcelLayers[county]=L.geoJSON(geo).addTo(map);
  } else { parcelLayers[county]?.remove(); }
}
function applyDrawFilter(){
  const bounds=drawLayer.getBounds();
  filtered=all.filter(l=>l.lat&&l.lng&&bounds.contains([l.lat,l.lng]));
  renderCards(filtered);
}

8Watchlist

Click ★ Watchlist to view all starred properties. The badge counter shows how many you're tracking.

• Add: click ☆ on any card, or ★ Watch in the detail modal
• Remove: click the filled ★ again
• Clear all: Clear All on the Watchlist page
• Storage: localStorage key lcis-watch — persists across browser sessions

let watchlist=new Set(JSON.parse(localStorage.getItem('lcis-watch')||'[]'));
function toggleWatch(id,btn){
  const s=String(id);
  if(watchlist.has(s))watchlist.delete(s); else watchlist.add(s);
  localStorage.setItem('lcis-watch',JSON.stringify([...watchlist]));
  updateWatchCount();
  if(btn) btn.textContent=isWatched(id)?'★ Watching':'☆ Watch';
}

9Saved Searches & Analysis

LCIS has two tiers of search memory: Saved Searches (persistent forever) and Recent Searches (auto-expire after 30 days). Both are accessible from the 📊 Analysis page.

Pre-Loaded Searches

• 🌿 Rural Land — Land type, 50 ac min, Clarke + Fauquier + Frederick + Rappahannock + Warren
• 📋 Comm/NNN — Commercial type, all counties, $4M–$20M price range

Saving a New Search

1. Set your filters exactly as desired on the Land or Commercial page
2. Click 💾 Save in the filter sidebar
3. Name it when prompted — saved to the database and localStorage simultaneously

Managing Saved Searches

Navigate to 🔔 Alerts → Saved Searches panel:

Recent Searches (Auto-Log)

Every time you apply filters and results render, LCIS silently logs the search to the database with a 30-day expiry. No action needed — it happens automatically. You can revisit any recent search from the Analysis page by clicking it to instantly reload those filters.

📊 Analysis Page — Compare Two Searches

Click 📊 Analysis in the top nav to open the Analysis page. From here you can:

• Recent searches — click any row to reload that filter state instantly
• Saved searches — click any row to reload (same as loading from Alerts page)
• Compare A vs B — pick two searches from the dropdowns, click Compare ↗

The comparison table shows all listings from both searches side-by-side, color-coded: Both in both searches, A only exclusive to A, B only exclusive to B. Click any row to open the full listing detail.

// Save current filter state to DB + localStorage
async function saveSearchToDB(name,stateJson,type='both'){
  const res=await fetch('/api/re/saved-searches?user_id=1',{
    method:'POST',headers:{'Content-Type':'application/json'},
    body:JSON.stringify({name,type,state_json:stateJson})
  }).then(r=>r.json());
  const dbId=res.id; // stored for future delete/edit
}
function deleteSearch(name){
  const s=savedSearches.find(x=>x.name===name);
  fetch(`/api/re/saved-searches/${s.dbId}`,{method:'DELETE'});
  savedSearches=savedSearches.filter(x=>x.name!==name);
  localStorage.setItem('lcis-searches',JSON.stringify(savedSearches));
  renderSavedList();
}
function editSearch(oldName){
  const newName=prompt('New name:',oldName);
  // deletes old DB record by dbId, saves new record with newName
}

10Email Alerts

Click 🔔 Alerts to configure automated deal notifications.

Click Save Alerts. Alerts send daily at 8am when new matches are found.

Manual Controls

• ▶ Send Now — immediately dispatches alerts. Use after a manual data fetch to push fresh deals without waiting for the daily schedule.
• 📍 Geocode Listings — fills in lat/lng for listings missing map coordinates (~1/sec via Nominatim). Run after a fetch to ensure new listings appear on the map.

async function saveAlert(){
  await fetch('/api/re/alerts/subscribe',{method:'POST',
    headers:{'Content-Type':'application/json'},
    body:JSON.stringify({name,email,on_new,on_drop,on_weekly})});
}
async function triggerAlerts(){
  const d=await fetch('/api/re/alerts/send',{method:'POST'}).then(r=>r.json());
  alert(d.ok?'Alert dispatch queued — check logs in ~30s.':'Error: '+JSON.stringify(d));
}
async function triggerGeocode(){
  const d=await fetch('/api/re/geocode/run',{method:'POST'}).then(r=>r.json());
  alert(d.ok?`Geocoding ${d.queued} listings in background (~1/sec).`:'Error.');
}

11Data Sources & Fetching

LCIS aggregates listings from multiple data sources. The table below is the complete picture — what's running, what's blocked, what's available if you want to unlock it, and what it costs.

Active Pipelines — Running Now

Installed but Blocked — Need Subscription to Activate

🔜 Next Step — Unlock Non-MLS Land Sources

Planned — Not Yet Built

On-Demand County Search

You can search any county in VA, WV, MD, or DC right now — not just the configured daily counties. No data is stored — results are returned live from Redfin.

• Use the Admin panel on the map or listings page to trigger a county-specific fetch
• API: POST /api/re/search/county with {"county":"culpeper","state":"va","min_acres":50}
• List all counties for a state: GET /api/re/counties?state=wv

Manual Fetch (Admin Panel)

• Redfin Land Fetch — triggers immediate scrape across all configured counties. Results in ~60 seconds. Runs all 175 regions so takes 2–4 minutes total.
• Crexi Commercial Fetch — pulls VA commercial listings from Crexi. Auto-paginates up to 200 results per run.

12Investment Scoring System

Every listing gets an automated Investment Score (0–100) from scorer.py. This drives card ordering, Top Scored Deals, and grade badges.

Land Score Factors

• Price per Acre vs. County Median — below the county's median PPA scores higher
• Total Acreage — larger parcels score higher (more subdivision potential)
• Days on Market — newer listings score higher (less stale inventory)
• County Desirability — Fauquier, Frederick score higher than Shenandoah
• Data Completeness — listings with photos, full address, and verified acreage score higher

Commercial Score Factors

• Cap Rate — higher cap rate = higher score when available from Crexi
• Price per Sqft vs. Market — below-market $/sqft scores higher
• Property Type Demand — Industrial and NNN Retail score higher than Office

PPA Percentile Badge

Tells you where this listing sits in the $/acre distribution of your current filtered results. A listing in the 10th percentile is cheaper than 90% of comparable land — a strong signal.

let _allPPAs=[]; // sorted array of all land PPAs in current filtered set
function pctBadge(ppa){
  if(!ppa||!_allPPAs.length)return'';
  const rank=_allPPAs.filter(x=>x<=ppa).length;
  const pct=Math.round((rank/_allPPAs.length)*100);
  if(pct<=33)return`<span class="ppa-pct low">Below avg $/ac</span>`;
  if(pct<=66)return`<span class="ppa-pct mid">At avg $/ac</span>`;
  return`<span class="ppa-pct high">Above avg $/ac</span>`;
}

13Power Features

Keyboard Shortcuts

Deep Links

Every listing has a permanent shareable URL: /?listing=ID. Click the 🔗 button in the detail modal to copy it. When opened, the app loads and auto-opens the correct detail modal.

Property Comparison Tool

Check the ☐ checkbox on 2–4 listings. A comparison bar appears at the bottom. Click Compare for side-by-side metrics. Click ↓ CSV to export as a spreadsheet.

Print Property Sheet

Click 🖨 in the detail modal. The print stylesheet hides all navigation and renders a clean one-page property sheet with key data, photo, and investment calc — ideal for site visit packets or partner presentations.

Theme Cycling

Click 🌙 Dark to cycle: Dark → Light → System. Saved in localStorage and persists across sessions.

// Keyboard navigation inside detail modal
document.addEventListener('keydown',e=>{
  if(document.getElementById('detail-modal')?.style.display!=='none'){
    if(e.key==='Escape')return closeDetail();
    if(e.key==='ArrowRight'||e.key==='ArrowLeft'){
      const idx=filtered.findIndex(x=>x.id===currentDetailId);
      const next=e.key==='ArrowRight'?filtered[idx+1]:filtered[idx-1];
      if(next!=null)openDetail(next.id);
    }
  }
});
function checkDeepLink(){
  const lid=new URLSearchParams(window.location.search).get('listing');
  if(lid&&all.find(x=>String(x.id)===lid))setTimeout(()=>openDetail(+lid),400);
}
function shareDetail(){
  navigator.clipboard.writeText(window.location.origin+'/?listing='+currentDetailId);
}
function exportCompareCSV(){
  const items=[...compareSet].map(id=>all.find(x=>String(x.id)===id)).filter(Boolean);
  const rows=['Name,Price,Acres,PPA,County,Score,Source',
    ...items.map(l=>`"${l.address}",${l.price},${l.acres},`+
      `${Math.round(l.price/l.acres)},${l.county},`+
      `${Math.round((l.score||0)*100)},${l.source}`)];
  Object.assign(document.createElement('a'),{
    href:URL.createObjectURL(new Blob([rows.join('\n')],{type:'text/csv'})),
    download:'compare-listings.csv'
  }).click();
}

14Feature Roadmap

💸 Apify Spend Widget

A spend pill in the top navigation bar tracks your Apify API usage for the current day. It shows estimated cost and a fill bar that turns yellow (≥70%) and red (≥100%) as you approach the $10/day budget limit.

• The pill reads from localStorage — it resets at midnight
• Every Apify run call in the frontend calls logUsage(cost) which updates the pill
• No server round-trip needed for display — it's purely client-side

🖼️ View & Cache (Listing Images)

Every View ↗ button on listing cards and map popups now fires a background image pre-cache when clicked. The listing opens in a new tab immediately — the cache request runs silently in parallel.

• Backend endpoint /api/img/{id} checks disk cache first — if the image exists, zero outbound request
• If not cached: image is fetched via Apify proxy (never direct from India IP to CDN)
• Next time the listing card loads, the image is served from disk instantly

Built in 2026-05-02 Session

Still Pending

Features identified by comparing LCIS against Zillow, Redfin, LoopNet, LandWatch, LandAndFarm, and Realtor.com, filtered for investor-specific value and ranked by impact.