# Workspace Folder Structure

This workspace is organized into clean, logical folders:

## 📁 Root Directory

```
├── .env.example          # Environment configuration template
├── .gitignore           # Git ignore rules
├── .vscode/             # VS Code settings and tasks
├── app/                 # 🚀 Active project files (MAIN APPLICATION)
└── information/         # 📚 Documentation and deprecated files
```

## 🚀 app/ - Active Project Files

**All working application code and assets**

- **app.py** - Main Flask application
- **config.py** - Application configuration
- **wsgi.py** / **passenger_wsgi.py** - Production WSGI servers
- **requirements.txt** - Python dependencies
- **parse_csv_to_json.py** - CSV to JSON data processor
- **generate_bitwise_helper.py** - Bitwise filtering data generator
- **css/** - Stylesheets
- **js/** - JavaScript files
- **templates/** - HTML templates
- **data/** - JSON data files
- **images/** - Image assets

## 📚 information/ - Documentation

**All project documentation and guides**

- AI_PARSING_INSTRUCTIONS.md
- BITWISE_USAGE_GUIDE.md
- QUICKSTART.md
- README.md
- REQUIRED_CODE_CHANGES.md
- START_HERE.md
- URL_EXAMPLES.md
- URL_IMPLEMENTATION_SUMMARY.md
- URL_STATE_MANAGEMENT.md

### information/deprecated/ - Old Files

**Deprecated files kept for reference**

- index.html / index2.html (replaced by templates/)
- codes.text (old data)
- run.bat (old batch file)
- Procfile (old deployment config)
- temp/ (temporary files)

---

## Working with the Project

### Running Tasks

All VS Code tasks are configured to work with the new structure:

- **Ctrl+Shift+B** - Process All Data (updates JSON from CSV)
- **Ctrl+Shift+P** → "Tasks: Run Task" → "Start Flask Server"

### Updating Data

When you update `app/data/products.csv`:
1. Press **Ctrl+Shift+B** to run "Process All Data"
2. This generates fresh JSON files in `app/data/`

### Starting the Server

1. Press **Ctrl+Shift+P**
2. Type "Tasks: Run Task"
3. Select "Start Flask Server"
4. Open http://127.0.0.1:8080

---

**Last Updated:** March 26, 2026