Skip to content

DEPRECATION_SUMMARY.md

Latest commit

 

History

History
121 lines (94 loc) · 3.23 KB

DEPRECATION_SUMMARY.md

File metadata and controls

121 lines (94 loc) · 3.23 KB

WhoVoted v1.0 Deprecation Summary

Date: February 22, 2026
Commit: 55bf657

What Was Deprecated

The original single-page version of WhoVoted (v1.0) has been moved to deprecated-v1/ directory.

Deprecated Files:

  • index.html → deprecated-v1/index.html
  • data.js → deprecated-v1/data.js
  • config.js → deprecated-v1/config.js
  • styles.css → deprecated-v1/styles.css

New Architecture (v2.0)

Frontend

  • Location: public/ directory
  • Entry Point: public/index.html
  • Features:
    • Multi-dataset selector with year display
    • Party-based filtering (Democratic/Republican/All)
    • Improved map visualization
    • Real-time dataset switching

Backend

  • Location: backend/ directory
  • Framework: Flask + Python
  • Entry Point: backend/app.py
  • Features:
    • Admin dashboard at /admin
    • File upload and processing
    • Real-time job monitoring
    • Geocoding with caching
    • Multi-provider geocoding (AWS + Census + Photon + Nominatim)

Key Improvements

  1. Geocoding Performance

    • 77,000+ pre-cached addresses
    • 90%+ cache hit rate
    • Parallel processing with configurable workers
    • Two-color progress bar (green=cached, blue=new)

  2. Multi-Dataset Support

    • Upload multiple election datasets
    • Visual dataset selector
    • Year display preservation
    • Party-based filtering

  3. Admin Dashboard

    • Secure login (admin/admin2026!)
    • File upload interface
    • Real-time processing status
    • Job history and monitoring
    • Duplicate detection

  4. Better Architecture

    • Backend-driven data processing
    • Centralized data management
    • Improved error handling
    • Comprehensive logging

Migration Guide

For Users

  1. Access the new version at the same URL
  2. Use /admin for file uploads (credentials: admin/admin2026!)
  3. Select datasets using the new dataset selector

For Developers

  1. Frontend code is in public/
  2. Backend code is in backend/
  3. Run with: python backend/app.py
  4. Or use: ./start.sh (Linux/Mac) or start.bat (Windows)

GitHub Repository

Repository: https://github.com/Drew-CodeRGV/WhoVoted
Branch: main
Commit: 55bf657

Commit Message

feat: Modernize WhoVoted with backend architecture and deprecate v1

BREAKING CHANGES:
- Deprecated original single-page version (moved to deprecated-v1/)
- New Flask backend with admin dashboard
- Multi-dataset support with dataset selector
- Improved geocoding with caching system

Files Changed

  • 141 files changed
  • 8,455,677 insertions
  • 3,780,882 deletions

What's Next

The old version in deprecated-v1/ is kept for reference only. All future development will be on the new v2.0 architecture.

Recommended Actions:

  1. Update any bookmarks to use /admin for uploads
  2. Review the new admin dashboard features
  3. Test the multi-dataset selector
  4. Verify geocoding performance improvements

Support

For issues or questions:

  • Check DOCUMENTATION_INDEX.md for all documentation
  • Review QUICK_START_AWS.md for setup instructions
  • See ARCHITECTURE.md for technical details

Status: ✅ Successfully deprecated and pushed to GitHub
New Version: v2.0 (public/ + backend/)
Old Version: v1.0 (deprecated-v1/)