TIF_E41253317/README.md

65 lines
1.9 KiB
Markdown

# Sistem Peramalan Permintaan Produk - UD Aan Jaya Toko
Aplikasi web untuk memperkirakan permintaan lima produk (minyak, gula, tepung,
telur, dan Sedap Goreng) menggunakan metode **Prophet**. Dibangun dengan
**Streamlit** dan **Python**.
## Fitur
- **Login** dengan dua jenis akses: admin dan pemilik toko
- **Beranda**: pilih periode peramalan, ringkasan permintaan, event/hari libur
terdekat, dan kartu grafik mini per produk
- **Detail Peramalan** per produk
- Tab Peramalan: grafik, ringkasan insight, tabel harian (unduh CSV)
- Tab Dekomposisi: tren, pola mingguan, pola tahunan, efek hari libur,
dan rekomendasi aksi bisnis
- Unduh laporan PDF
- **Manajemen User** (khusus admin): tambah, ubah, dan hapus akun
- **Edit Profil**: ubah username, nama tampilan, dan password
## Cara Menjalankan
Pastikan Python 3.11 sudah terpasang.
```bash
# 1. (opsional) buat virtual environment
python -m venv venv
venv\Scripts\activate # Windows
# source venv/bin/activate # Linux / macOS
# 2. pasang dependensi
pip install -r requirements.txt
# 3. jalankan aplikasi
streamlit run app.py
```
Aplikasi dapat dibuka di `http://localhost:8501`.
## Akun Bawaan
File `data/users.json` tidak disertakan di repository karena berisi data
akun. File ini dibuat otomatis saat aplikasi pertama kali dijalankan, dengan
akun bawaan:
| Username | Password | Role |
|----------|-------------|---------|
| admin | admin123 | admin |
| pemilik | pemilik123 | pemilik |
> Segera ganti password bawaan lewat menu **Edit Profil** setelah login pertama.
## Struktur Proyek
```
.
├── app.py # entry point & navigasi
├── requirements.txt
├── .streamlit/
│ └── config.toml # tema & konfigurasi server
├── data/
│ └── all_results.pkl # model Prophet & data historis 5 produk
├── views/ # halaman aplikasi
└── utils/ # autentikasi, peramalan, insight, laporan PDF
```