Staff Planner App

An interactive workforce planning application built with Python and Streamlit. This app compares staffing models (Model A & Model B) and provides tools to analyze staff needs, overtime costs, and breakeven points.

---

🛠️ Features

• Dynamic Input Parameters: Modify costs, ratios, overtime, and more in real-time.
• Model Comparisons: Analyze and compare total costs and staffing needs for Model A and Model B.
• Graphs and Visualizations:
  • Cost comparison between models.
  • Breakeven analysis as unit_census changes.

---

📦 Folder Structure

staff-planner-app/ │ ├── app/ │ ├── init.py # Marks the app as a Python package (optional, can be empty). │ ├── planner.py # Contains your shared final StaffPlanner class. │ ├── main.py # The main Streamlit app. │ ├── styles.css # Custom styles for the app. │ ├── requirements.txt # Streamlit and other dependencies. ├── README.md # Documentation about the app.

---

🚀 How to Run the App

1. Clone this Repository:

   git clone https://github.com/your-username/staff-planner-app.git
   cd staff-planner-app
   

2. Install Dependencies: Use the provided requirements.txt file to install dependencies:

   pip install -r requirements.txt

3. Start the Streamlit App: Run the app using the streamlit CLI tool:

   streamlit run app/main.py

4. Open Your Browser:

   Visit http://localhost:8501 to interact with the app

---

🖌️ Customize Styles

The app includes a styles.css file for custom styles (e.g., sidebar colors, font sizes). Update this file under app/styles.css to change the UI.

---

🛡️ Testing

Unit tests for planner.py can be added to tests/test_planner.py. Use the unittest module to ensure all calculations work as expected:

python -m unittest discover -s tests

---

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.