Initial

2026-04-11 00:04:09 -05:00
commit 7a2fffd62e
110 changed files with 51809 additions and 0 deletions
@@ -0,0 +1,51 @@
+# Product Finder Application
+
+A Flask-based web application for finding products through an interactive quiz interface.
+
+## Quick Start
+
+### 🚀 Running the Application
+
+**Option 1: Using VS Code Tasks (Recommended)**
+- Press `Ctrl+Shift+P` → Type "Tasks: Run Task" → Select "Start Flask Server"
+- Open http://127.0.0.1:8080
+
+**Option 2: Command Line**
+```bash
+cd app
+python app.py
+```
+
+### 📊 Updating Product Data
+
+When you update `app/data/products.csv`:
+- Press `Ctrl+Shift+B` to process the data
+- All JSON files will be regenerated automatically
+
+## Project Structure
+
+```
+📁 app/              - All active project files (application code, assets, data)
+📁 information/      - Documentation and deprecated files
+```
+
+See [information/FOLDER_STRUCTURE.md](information/FOLDER_STRUCTURE.md) for detailed organization.
+
+## Documentation
+
+- **[FOLDER_STRUCTURE.md](information/FOLDER_STRUCTURE.md)** - Complete workspace organization
+- **[QUICKSTART.md](information/QUICKSTART.md)** - Getting started guide
+- **[BITWISE_USAGE_GUIDE.md](information/BITWISE_USAGE_GUIDE.md)** - Bitwise filtering documentation
+- **[START_HERE.md](information/START_HERE.md)** - Project overview
+
+## Development
+
+All development happens in the `app/` folder. The project uses:
+- **Flask** for the web server
+- **Python** for data processing
+- **Vanilla JavaScript** for the frontend
+
+---
+
+**Version:** 2.0  
+**Last Updated:** March 26, 2026