SweetCostManager - 甜點成本管理系統

簡介

本系統是一個簡單易用的甜點成本管理工具，旨在幫助用戶有效管理甜點製作過程中的成本、利潤及建議售價。通過模組化設計，您可以輕鬆操作以下功能：

1. 食材管理：新增、更新、刪除食材資訊。
2. 品項管理：管理甜點品項及其所需食材。
3. 時間成本管理：設定製作過程的時間成本並計算建議售價。
4. 建議售價與利潤計算：快速計算利潤並保存結果。

功能特色

• 支援 .csv 文件作為數據儲存格式，可與 Microsoft Excel 完美相容，用戶可通過 Excel 編輯數據。
• 基於 Streamlit 框架開發，具有直觀且美觀的網頁操作介面。
• 預設生成必要數據文件，輕鬆快速上手。

使用技術

• Python 版本：3.10 及以上
• 主要套件：
  • streamlit：用於構建網頁應用。
  • pandas：用於數據操作與處理。

安裝與運行

1. 環境準備

請先安裝 Python 3.10 及以上版本。

2. 使用 setup.bat

運行 setup.bat 以自動安裝所有必要的依賴並完成環境配置。

3. 運行系統

運行以下指令啟動應用：

streamlit run main.py

或直接運行 start.bat。

啟動後，系統將自動在您的默認瀏覽器中打開網頁介面。

4. 文件生成與編輯

首次運行時，系統會自動生成以下 .csv 文件：

• 食材清單.csv
• 品項清單.csv
• 時間成本清單.csv
• 基本時薪.csv
• 可用單位.csv
• 建議售價與利潤結果.csv

這些文件可直接用 Microsoft Excel 打開並編輯，保存後即可自動應用於系統。

系統模組詳解

1. 食材管理

   • 新增、更新或刪除食材。
   • 設定食材名稱、單位及單價。

2. 品項管理

   • 定義甜點品項及所需食材及其用量。
   • 自動計算單行成本。

3. 時間成本管理

   • 設定基本時薪。
   • 管理每個品項的製作時間並自動生成建議售價。

4. 建議售價與利潤計算

   • 根據選擇的品項和數量，計算總成本、建議售價與利潤。
   • 支援結果保存。

文件結構

• main.py：主程式，包含所有功能模組的實現。
• requirements.txt：所需 Python 套件列表。
• setup.bat：環境配置腳本。
• start.bat：快速啟動腳本。

貢獻

歡迎對此專案提出建議或提交 Pull Request。感謝您的支持與參與！