admin Tested: December 28, 2025

States Management

Complete US state and territory management with semantic search fields for intelligent matching of military family relocation queries.

adminstatessemantic-searchterritoriesgeographic-data
States Management

Overview

The States Management page provides comprehensive administration of all 52 US states and territories, including rich semantic search fields that power intelligent natural language queries for military family relocations.

Key Features

State Statistics Dashboard

  • 52 Total States: All US states plus DC and Puerto Rico
  • 3,222 Total Counties: Complete county coverage across all states
  • 62 Avg Counties/State: Quick reference for geographic distribution

State Listing Table

  • Abbreviation Badge: Two-letter state codes for quick identification
  • State Name: Full state name with click-to-view counties
  • County Count: Number of counties in each state
  • Edit Action: Direct link to state edit page

Semantic Search Fields (Edit Page)

Each state includes rich data fields that power intelligent search matching:

Geographic & Climate

  • Region: Geographic region (Northeast, Southeast, Midwest, Southwest, West, Pacific)
  • Has Coastline: Coastal state indicator for beach/waterfront queries
  • Climate Description: Weather patterns and seasonal characteristics

Military Presence

  • Major Military Bases: Comma-separated list of installations (critical for HURE’s military family focus)

Economic Factors

  • Income Tax Type: None, Flat, Progressive, or other tax structures
  • Cost of Living Index: Relative to national average (100 = average)
  • Median Home Price: Current median home values

Semantic Content

  • Description: Rich paragraph for vector embedding search
  • Highlights: Keywords and phrases for search matching

Add State Functionality

  • Create new states/territories with all semantic fields
  • Automatic abbreviation validation
  • Territory flag for non-state entities

Search Integration

State semantic fields power the natural language search system:

  • “warm coastal state with military bases and no income tax” → Florida, Texas
  • “affordable midwest state with low cost of living” → Kansas, Iowa, Nebraska
  • Vector embeddings generated from description and highlights fields
  • Reindex from Search page after updating semantic content

Edit State View

State Edit Screen

The state edit screen provides comprehensive semantic search configuration:

Basic Information

  • State Name: Full state name
  • Abbreviation: Two-letter postal code
  • Territory Toggle: Mark as territory (DC, Puerto Rico) vs state

Geographic & Climate

  • Region Dropdown: Northeast, Southeast, Midwest, Southwest, West, Pacific
  • Has Coastline Toggle: Coastal state indicator for beach queries
  • Climate Description: Weather patterns and seasonal characteristics

Military Presence

  • Major Military Bases: Comma-separated list of installations
  • Critical for HURE’s military family relocation matching

Economic Factors

  • Income Tax Type: None, Flat, Progressive brackets
  • Cost of Living Index: Relative to national average (100 = baseline)
  • Median Home Price: Current median home value in dollars

Semantic Search Content

  • Description: Rich paragraph for vector embedding search
  • Highlights: Keywords and phrases for search matching
  • State status with region and coastal badges
  • Quick stats (Cost of Living, Median Home Price)
  • Counties link with count
  • Reminder to reindex after semantic field updates

Testing Results

  • ✅ All 52 states display correctly with county counts
  • ✅ State edit page loads all semantic fields
  • ✅ Semantic search returns relevant results for natural language queries
  • ✅ Add State creates new entries with all fields
  • ✅ County counts match database records
  • ✅ Edit links navigate to correct state pages
  • ✅ Edit form saves all field changes correctly
  • ✅ Economic factors update Quick Stats sidebar
  • ✅ Toggle switches work for coastline and territory