📁 Reorganize project structure: Move UI files to dedicated directory

- Move app.py, config_page.py, optimization_results.py to ui/ directory
- Create proper UI package structure with pages/ and components/ subdirectories
- Update all import paths to reflect new structure
- Add main.py as new project entry point
- Update README.md with new project structure documentation
- Preserve Git history using git mv for all file moves
- Maintain separation of concerns: UI logic in ui/, business logic in src/
- Improve project maintainability and scalability

README.md

@@ -5,10 +5,85 @@ colorFrom: blue
 colorTo: green
 sdk: streamlit
 sdk_version: "1.28.0"
-app_file: app.py
+app_file: ui/app.py
 pinned: false
 ---
 
 # Supply Roster Optimization
 
-This is a Streamlit application for optimizing supply roster management with improved code readability.
+A comprehensive Streamlit application for optimizing supply roster management using OR-Tools with improved code organization and readability.
+
+## 🚀 Quick Start
+
+### Option 1: Using Main Entry Point (Recommended)
+```bash
+python main.py
+```
+
+### Option 2: Direct Streamlit Command
+```bash
+streamlit run ui/app.py
+```
+
+## 📁 Project Structure
+
+```
+SD_roster_real/
+├── main.py                          # Main entry point
+├── README.md
+├── requirements.txt
+├── docker-compose.yaml
+├── setup.py
+│
+├── src/                             # Core business logic
+│   ├── config/                      # Configuration management
+│   │   ├── constants.py
+│   │   ├── optimization_config.py
+│   │   └── paths.yaml
+│   ├── models/                      # Optimization models
+│   │   └── optimizer_real.py
+│   ├── preprocess/                  # Data preprocessing
+│   │   ├── data_preprocess.py
+│   │   ├── extract.py
+│   │   ├── transform.py
+│   │   └── ...
+│   └── visualization/               # Chart generation
+│       ├── hierarchy_dashboard.py
+│       └── kit_relationships.py
+│
+├── ui/                              # Streamlit UI components
+│   ├── app.py                       # Main Streamlit app
+│   ├── pages/                       # Page components
+│   │   ├── config_page.py           # Settings page
+│   │   ├── optimization_results.py  # Results page
+│   │   └── __init__.py
+│   ├── components/                  # Reusable UI components
+│   │   └── __init__.py
+│   └── __init__.py
+│
+├── data/                            # Data files
+├── notebook/                        # Jupyter notebooks
+└── venv/                           # Virtual environment
+```
+
+## 🔧 Features
+
+- **Multi-page Interface**: Clean separation of settings, results, and validation
+- **Real-time Optimization**: OR-Tools powered workforce scheduling
+- **Data Validation**: Comprehensive demand data validation and visualization
+- **Cost Analysis**: Detailed cost breakdown and analysis
+- **Hierarchy Management**: Kit dependency tracking and visualization
+- **Flexible Configuration**: Extensive parameter customization
+
+## 📊 Usage
+
+1. **Settings Page**: Configure optimization parameters, workforce limits, and cost rates
+2. **Optimization Results**: View detailed results with charts and analysis
+3. **Demand Validation**: Validate input data and identify potential issues
+
+## 🛠️ Development
+
+The project follows a clean architecture with:
+- **Separation of Concerns**: UI logic separated from business logic
+- **Modular Design**: Reusable components and clear interfaces
+- **Git-friendly**: Proper file organization with preserved Git history

main.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+"""
+Supply Roster Optimization Tool - Main Entry Point
+Run this file to start the Streamlit application
+"""
+
+import sys
+import os
+import subprocess
+
+def main():
+    """Main entry point for the Supply Roster Optimization Tool"""
+    
+    # Get the directory where this script is located
+    project_root = os.path.dirname(os.path.abspath(__file__))
+    
+    # Add project root to Python path
+    sys.path.insert(0, project_root)
+    
+    # Path to the Streamlit app
+    app_path = os.path.join(project_root, 'ui', 'app.py')
+    
+    # Check if the app file exists
+    if not os.path.exists(app_path):
+        print(f"❌ Error: Could not find app.py at {app_path}")
+        print("Please ensure the project structure is correct.")
+        sys.exit(1)
+    
+    print("🚀 Starting Supply Roster Optimization Tool...")
+    print(f"📁 Project root: {project_root}")
+    print(f"🎯 App path: {app_path}")
+    print("🌐 Opening in browser...")
+    
+    # Run Streamlit
+    try:
+        subprocess.run([
+            sys.executable, '-m', 'streamlit', 'run', app_path,
+            '--server.headless', 'false',
+            '--server.address', 'localhost',
+            '--server.port', '8501'
+        ], cwd=project_root)
+    except KeyboardInterrupt:
+        print("\n👋 Application stopped by user")
+    except Exception as e:
+        print(f"❌ Error starting application: {e}")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

ui/__init__.py

@@ -0,0 +1,4 @@
+"""
+UI Package for Supply Roster Optimization Tool
+Contains all Streamlit interface components
+"""

app.py → ui/app.py

@@ -6,9 +6,11 @@ Simplified version with configuration and optimization results
 import streamlit as st
 import sys
 import os
-
+from ui.pages.config_page import render_config_page
+from ui.pages.optimization_results import display_optimization_results
+from src.demand_validation_viz import display_demand_validation
 # Add src directory to path for imports
-sys.path.append(os.path.join(os.path.dirname(__file__), 'src'))
+sys.path.append(os.path.join(os.path.dirname(__file__), '..', 'src'))
 
 # Set page config
 st.set_page_config(
@@ -32,16 +34,13 @@ page = st.sidebar.selectbox(
 # Main app content
 if page == "⚙️ Settings":
     # Import and render the config page
-    from config_page import render_config_page
-    
     st.title("📦 Supply Roster Optimization Tool")
     st.markdown("---")
-    
     render_config_page()
 
 elif page == "📊 Optimization Results":
     # Import and render the optimization results page
-    from optimization_results import display_optimization_results
+    
     
     # Check if we have results in session state
     if 'optimization_results' in st.session_state and st.session_state.optimization_results:
@@ -64,7 +63,7 @@ elif page == "📊 Optimization Results":
 elif page == "📋 Demand Validation":
     # Import and render the demand validation page
     try:
-        from src.demand_validation_viz import display_demand_validation
+        
         
         st.title("📋 Demand Data Validation")
         st.markdown("---")

ui/components/__init__.py

@@ -0,0 +1,4 @@
+"""
+UI Components Package
+Contains reusable UI components for the Streamlit app
+"""

ui/pages/__init__.py

@@ -0,0 +1,4 @@
+"""
+UI Pages Package
+Contains individual page components for the Streamlit app
+"""

config_page.py → ui/pages/config_page.py

@@ -11,7 +11,7 @@ from src.config import optimization_config
 from src.config.constants import ShiftType, LineType
 
 # Add src directory to path for imports
-sys.path.append(os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.append(os.path.join(os.path.dirname(__file__), '..', '..', 'src'))
 
 def render_config_page():
     """Render the configuration page with all user input controls"""
@@ -1174,5 +1174,5 @@ def check_critical_data_issues():
 
 def display_optimization_results(results):
     """Import and display optimization results"""
-    from optimization_results import display_optimization_results as display_results
+    from ui.pages.optimization_results import display_optimization_results as display_results
     display_results(results)