structure.txt

ValueMap/
│
├── backend/                           # Backend logic (Flask API and services)
│   ├── app.py                         # Main Flask application handling API endpoints and user requests
│   ├── config.py                      # Configuration settings (API keys, database URIs, etc.)
│   ├── models.py                      # SQLAlchemy database models (e.g., Users, Products, Shopping Lists)
│   ├── services/                      # External API services and scraping logic
│   │   ├── gas/                       # Folder for GasBuddy-related logic
│   │   │   ├── gas.py                 # GasBuddy API service to get gas prices
│   │   ├── target/                    # Folder for Target-related services
│   │   │   ├── target.py              # Target Selenium service for scraping product data
│   │   │   ├── target_pipeline.py     # Pipeline logic for Target-related data
│   │   │   ├── target_location.py     # Store location fetching logic for Target
│   │   ├── walmart/                   # Folder for Walmart-related services
│   │   │   ├── walmart.py             # Walmart Selenium service for scraping product data
│   │   ├── chromedriver.py            # Chromedriver setup for Selenium
│   │   ├── maps.py                    # OpenStreetMap integration for geolocation and maps
│   ├── database/                      # Database folder (Handles storage and interactions with the DB)
│   │   ├── user_schema.sql            # SQL schema for creating tables (users, user lists, etc.)
├── frontend/                          # Frontend logic (User interface)
│   ├── css/                           # CSS styles
│   │   └── styles.css                 # Main CSS file (dark/light mode support)
│   ├── js/                            # JavaScript logic for interactivity
│   │   └── app.js                     # Main JavaScript file (handling map, user input, AJAX calls)
│   ├── templates/                     # HTML templates for rendering pages
│   │   ├── index.html                 # Home page with map and shopping list features
│   │   ├── product_price.html         # Product price search and tracking page
│   │   ├── profile.html               # User Profile page (Name, Email, guest option max 10 items)
│   │   ├── login.html                 # Login page for user authentication
│   │   ├── list.html                  # Shopping list page for saved and historic lists
│   │   └── results.html               # Results page template for comparing prices and savings
│
├── .env                               # Environment variables (API keys, database credentials, etc.)
├── .gitignore                         # Git ignore file (for excluding sensitive files like .env, __pycache__, etc.)
├── docker-compose.yml                 # Docker Compose configuration (for containerized deployment)
├── Dockerfile                         # Docker configuration for building images
├── LICENSE                            # License file
├── requirements.txt                   # Python dependencies (Flask, SQLAlchemy, requests, etc.)
├── README.md                          # Project documentation and setup instructions
└── structure.txt                      # Project structure documentation (this file)