📦 Sistem Penjualan Part Komputer

Aplikasi manajemen penjualan part komputer berbasis Python dengan GUI PyQt5 dan database MySQL. Sistem ini memudahkan Anda untuk mengelola data part komputer termasuk nama, kategori, harga, dan stok dengan interface yang user-friendly.

📸 Screenshot Sistem

Main Window - Tampilan Utama

Dialog Tambah Part

Dialog Edit Part

Konfirmasi Hapus

✨ Fitur Utama

✅ GUI Modern dengan PyQt5 - Interface yang user-friendly dan responsif
✅ Tabel Data Part - Menampilkan semua part dalam format tabel yang rapi
✅ Tambah Part Baru - Dialog form untuk menambah part dengan berbagai kategori
✅ Edit Part - Pilih row dan edit data part dengan mudah
✅ Hapus Part - Hapus part dengan konfirmasi sebelumnya
✅ Database MySQL - Penyimpanan data yang aman dan terstruktur
✅ Input Validation - Validasi input untuk memastikan data valid
✅ Kategori Dropdown - 13 kategori part komputer yang sudah tersedia

🛠️ Teknologi yang Digunakan

Teknologi	Versi	Deskripsi
Python	3.8+	Bahasa pemrograman utama
PyQt5	5.15+	Framework GUI modern
MySQL	8.0+	Database management system
mysql-connector-python	-	Library untuk koneksi MySQL

📋 Prasyarat

Sebelum menjalankan aplikasi, pastikan Anda sudah memiliki:

Python 3.8+ - Download Python
MySQL Server - Download MySQL
pip - Package manager Python (biasanya sudah tersedia)

📦 Instalasi

1. Clone atau Download Project

# Jika menggunakan git
git clone <repository-url>
cd UAS

# Atau extract folder jika sudah di-download
cd /path/to/UAS

2. Buat Virtual Environment (Opsional tapi Disarankan)

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/Mac
python3 -m venv venv
source venv/bin/activate

3. Install Dependencies

pip install mysql-connector-python PyQt5

4. Setup Database MySQL

Buka MySQL Command Line atau MySQL Workbench dan jalankan query berikut:

-- Buat database
CREATE DATABASE penjualan_pc;

-- Gunakan database
USE penjualan_pc;

-- Buat tabel part
CREATE TABLE part (
    id_part INT AUTO_INCREMENT PRIMARY KEY,
    nama_part VARCHAR(100) NOT NULL,
    kategori VARCHAR(50) NOT NULL,
    harga INT NOT NULL,
    stok INT NOT NULL
);

-- Insert data sample (opsional)
INSERT INTO part (nama_part, kategori, harga, stok) VALUES
('Intel Core i7', 'Processor', 3500000, 10),
('RTX 3080', 'Graphics Card', 8000000, 5),
('RAM 16GB', 'Memory', 800000, 20),
('SSD 1TB', 'Storage', 1200000, 15);

5. Konfigurasi Database

Edit file database/database.py dan sesuaikan konfigurasi:

def get_db_connection():  
    return mysql.connector.connect(
        host="127.0.0.1",          # Alamat server MySQL
        user="root",                # Username MySQL
        password="YOUR_PASSWORD",   # Password MySQL
        database="penjualan_pc",    # Nama database
        auth_plugin="mysql_native_password"
    )

🚀 Cara Penggunaan

Menjalankan Aplikasi

python main.py

Aplikasi akan langsung membuka GUI window dengan tabel part dan tombol-tombol fitur.

📖 Panduan Penggunaan Fitur GUI

1️⃣ Tambah Part (Tombol ➕ Tambah)

Langkah-langkah:

Klik tombol ➕ Tambah Part
Dialog akan terbuka, isi form:
- Nama Part: Masukkan nama part (mis: RTX 4080)
- Kategori: Pilih kategori dari dropdown (Processor, Graphics Card, Memory, dll)
- Harga: Masukkan harga part
- Stok: Masukkan jumlah stok
Klik Simpan untuk menyimpan atau Batal untuk membatalkan

Kategori yang Tersedia:

Processor
Graphics Card
Memory (RAM)
Storage (SSD/HDD)
Motherboard
Power Supply
Cooling
Case
Monitor
Keyboard
Mouse
Headset
Other

2️⃣ Lihat Semua Part

Data part akan langsung ditampilkan di tabel utama dengan informasi:

ID - ID unik part
Nama Part - Nama part
Kategori - Kategori part
Harga - Harga dalam format Rp (contoh: Rp 3.500.000)
Stok - Jumlah stok tersedia

3️⃣ Edit Part (Tombol ✏️ Edit)

Langkah-langkah:

Pilih/klik row part yang ingin diubah di tabel
Klik tombol ✏️ Edit Part
Dialog edit akan terbuka dengan data part yang sudah terisi
Ubah data sesuai kebutuhan
Klik Simpan untuk menyimpan perubahan

4️⃣ Hapus Part (Tombol 🗑️ Hapus)

Langkah-langkah:

Pilih/klik row part yang ingin dihapus di tabel
Klik tombol 🗑️ Hapus Part
Konfirmasi akan muncul, klik Yes untuk menghapus atau No untuk membatalkan
Part akan dihapus dari database

5️⃣ Refresh Data (Tombol 🔄 Refresh)

Klik tombol 🔄 Refresh untuk merefresh/memperbarui data dari database. Berguna jika ada perubahan dari sumber lain.

6️⃣ Keluar (Tombol ❌ Keluar)

Klik tombol ❌ Keluar untuk menutup aplikasi.

📝 Catatan Penggunaan

✅ Nama Part tidak boleh kosong - Validasi akan mengingatkan jika nama kosong
✅ Harga dan Stok numeric - Gunakan field spinner untuk angka
✅ Konfirmasi sebelum hapus - Sistem akan meminta konfirmasi sebelum menghapus data
✅ Sorting kolom - Anda bisa klik header tabel untuk sort (jika diaktifkan)
✅ Auto-refresh - Setelah tambah/edit/hapus, tabel akan otomatis refresh

📁 Struktur Project

UAS/
│
├── main.py                    # File utama aplikasi
│
├── controllers/
│   ├── __init__.py
│   └── part_controller.py    # Controller untuk menangani input user
│
├── models/
│   ├── __init__.py
│   └── part.py               # Model data Part
│
├── services/
│   ├── __init__.py
│   └── part_service.py       # Service untuk business logic
│
├── database/
│   ├── __init__.py
│   └── database.py           # Konfigurasi koneksi database
│
├── .gitignore               # File untuk mengabaikan file tertentu di git
└── README.md                # File dokumentasi ini

🔧 Troubleshooting

Error: "No module named 'mysql'"

Solusi:

pip install mysql-connector-python

Error: "Connection refused"

Solusi:

Pastikan MySQL Server sudah berjalan
Cek konfigurasi host, user, dan password di database/database.py
Pada Linux: sudo service mysql start
Pada Windows: Buka Services dan start MySQL

Error: "Unknown database"

Solusi:

Pastikan database penjualan_pc sudah dibuat
Jalankan query SQL seperti yang dijelaskan di bagian Instalasi

Error: "Access denied for user"

Solusi:

Periksa username dan password MySQL di database/database.py
Pastikan user MySQL memiliki privilege yang sesuai

Aplikasi tidak membuka window

Solusi:

Pastikan Anda menjalankan dari terminal, bukan double-click
Pastikan DISPLAY variable sudah set (Linux/Mac)
Coba dengan: python main.py

🎨 Fitur GUI yang Tersedia

Fitur	Deskripsi
Tabel Data	Menampilkan semua part dalam format tabel yang rapi
Form Input	Dialog modern untuk input data
Dropdown Kategori	13 kategori part yang sudah tersedia
Validasi Input	Memvalidasi input sebelum menyimpan
Konfirmasi Hapus	Dialog konfirmasi sebelum menghapus data
Format Harga	Harga ditampilkan dengan format Rp
Error Handling	Pesan error yang jelas dan informatif
Auto Refresh	Tabel otomatis refresh setelah operasi

👨‍💻 Pengembang

Aspek	Detail
Dibuat Oleh	Muhamad Farhan Qolbi
Tanggal	Desember 2025
Status	Active ✅
Versi	2.0 (GUI dengan PyQt5)

📝 Lisensi

Proyek ini bebas digunakan untuk keperluan pendidikan dan komersial.

💡 Tips & Saran

Selalu backup database sebelum melakukan operasi delete
Gunakan virtual environment untuk menghindari konflik package
Pastikan MySQL running sebelum membuka aplikasi
Gunakan git untuk version control dan collaboration
Double-check data sebelum hapus karena tidak bisa di-undo

❓ FAQ

T: Bisakah saya menambah kategori part baru?
J: Ya, edit file gui/part_gui.py dan tambahkan kategori di list kombobox.

T: Bisakah saya menampilkan lebih banyak kolom di tabel?
J: Ya, edit struktur tabel di gui/part_gui.py dan tambahkan kolom di database.

T: Bagaimana cara backup database?
J: Gunakan mysqldump atau export dari MySQL Workbench.

T: Apakah aplikasi ini support multi-user?
J: Ya, asalkan semua user terkoneksi ke database MySQL yang sama.

T: Bisakah saya menjalankan aplikasi ini di web?
J: Saat ini CLI/GUI only. Untuk web, Anda bisa membuat REST API dengan Flask/Django.

📧 Kontak & Support

Jika ada pertanyaan atau saran, silakan hubungi melalui:

📧 Email: muhamadfarhanqolbi@gmail.com
💬 Issues: Report di repository

Selamat menggunakan Sistem Penjualan Part Komputer! 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
controllers		controllers
database		database
gui		gui
models		models
screenshots		screenshots
services		services
.gitignore		.gitignore
README.md		README.md
main.py		main.py

Folders and files

Latest commit

History

Repository files navigation

📦 Sistem Penjualan Part Komputer

📸 Screenshot Sistem

Main Window - Tampilan Utama

Dialog Tambah Part

Dialog Edit Part

Konfirmasi Hapus

✨ Fitur Utama

🛠️ Teknologi yang Digunakan

📋 Prasyarat

📦 Instalasi

1. Clone atau Download Project

2. Buat Virtual Environment (Opsional tapi Disarankan)

3. Install Dependencies

4. Setup Database MySQL

5. Konfigurasi Database

🚀 Cara Penggunaan

Menjalankan Aplikasi

📖 Panduan Penggunaan Fitur GUI

1️⃣ Tambah Part (Tombol ➕ Tambah)

2️⃣ Lihat Semua Part

3️⃣ Edit Part (Tombol ✏️ Edit)

4️⃣ Hapus Part (Tombol 🗑️ Hapus)

5️⃣ Refresh Data (Tombol 🔄 Refresh)

6️⃣ Keluar (Tombol ❌ Keluar)

📝 Catatan Penggunaan

📁 Struktur Project

🔧 Troubleshooting

Error: "No module named 'mysql'"

Error: "Connection refused"

Error: "Unknown database"

Error: "Access denied for user"

Aplikasi tidak membuka window

🎨 Fitur GUI yang Tersedia

👨‍💻 Pengembang

📝 Lisensi

💡 Tips & Saran

❓ FAQ

📧 Kontak & Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages