InactiveImmortal/gov-odoo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
61 commits 1 branch 0 tags 253 KiB
Find a file
Exact
InactiveImmortal bbcf78acc6 Final loader refinement to explicitly include loading=async attribute
2026-01-30 05:50:41 -06:00
__pycache__ init 2026-01-30 00:19:26 -06:00
controllers Add /precinct-finder/embed route for simple iframe integration 2026-01-30 02:48:07 -06:00
models Finalize multi-county suggestion logic 2026-01-30 05:08:44 -06:00
sample_data Enhance street matching logic and add import guide with samples 2026-01-30 00:59:13 -06:00
security init 2026-01-30 00:19:26 -06:00
views Final loader refinement to explicitly include loading=async attribute 2026-01-30 05:50:41 -06:00
__init__.py init 2026-01-30 00:19:26 -06:00
__manifest__.py Revert to standalone page version with inlined JS for maximum reliability 2026-01-30 03:04:24 -06:00
CHANGELOG_TODAY.md Add changelog documenting today's extensive improvements 2026-01-30 04:46:35 -06:00
clean_hunt_data.py Fix street name concatenation and improve data validation in cleanup script 2026-01-30 05:18:10 -06:00
COMPLETE_SETUP_GUIDE.md Finalize setup guide with CAD workflow and advanced Odoo mapping tips 2026-01-30 05:19:12 -06:00
DATA_IMPORT.md Add unique constraint to precinct name and update import guide 2026-01-30 03:18:05 -06:00
DEPLOYMENT.md fix 2026-01-30 00:34:54 -06:00
README.md init 2026-01-30 00:19:26 -06:00

README.md

Website Precinct Finder

Version: 1.0
Odoo Version: 19.0 (Community Edition)
License: LGPL-3

Overview

The Website Precinct Finder is a local Odoo module designed to help voters locate their election precinct and polling place. It maps user addresses to specific precincts using a locally stored database of street segments and address ranges.

This module works completely offline relative to external map APIs, ensuring privacy and speed by hosting the data directly within your Odoo instance.

Features

  • Public Lookup Page: A built-in, mobile-responsive webpage available at /precinct-finder where users can enter their address details.
  • Backend Data Management: Easy-to-use interfaces for Election Administrators to manage Precincts and Address Maps.
  • Search & Filtering: Advanced search views in the Odoo backend to quickly locate and update address ranges.
  • JSON API: Exposes a /voter/lookup endpoint for custom integrations if needed.

Installation & Update Instructions (Odoo 19 CE)

If this module is already installed and you have pulled the latest code changes (such as the new frontend page), follow these steps to update it in Odoo 19 Community Edition:

1. Enable Developer Mode

  1. Log in to your Odoo instance as an Administrator.
  2. Go to Settings.
  3. Scroll to the bottom of the page.
  4. Click Activate the developer mode.

2. Update the App List

  1. Go to the Apps main menu.
  2. In the top menu bar, click Update Apps List.
  3. Click Update in the confirmation dialog.
    • Note: This ensures Odoo sees the newly added files and XML views.

3. Upgrade the Module

  1. In the Apps search bar, search for Website Precinct Finder.
    • Tip: Remove the default "Apps" filter if you don't see it immediately.
  2. Click the three dots (⋮) on the module card or click into the module details.
  3. Click the Upgrade button.

Usage

Frontend (Public User)

  • Navigate to http://your-odoo-site.com/precinct-finder.
  • Enter the House Number, Street Name, and Zip Code.
  • Click Search to see the assigned Precinct and Polling Location.

Backend (Administrator)

  • Go to the Election app in the main dashboard.
  • Precincts: Define the names and physical addresses of polling places.
  • Address Mappings: Define ranges of addresses (e.g., "100-200 Main St, Even side") and link them to a Precinct.
    • Use the search bar to filter by Zip Code or Precinct to audit your data.