Skip to content

hardx/Kas-Management

Repository files navigation

Kas Management

Aplikasi manajemen keuangan pribadi yang dibangun menggunakan React (Vite), TypeScript, dan Express JS dengan database MySQL.

Prasyarat

Pastikan Anda telah menginstal aplikasi berikut di komputer Anda:

  • Node.js (versi 16 atau lebih baru)
  • MySQL (atau gunakan Laragon/XAMPP)

Cara Menjalankan Project

1. Konfigurasi Database

Buat file bernama .env di direktori utama (root) project. Salin konfigurasi di bawah ini:

# Konfigurasi Database
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=
DB_NAME=notes_new

# Konfigurasi JWT (Untuk login)
JWT_SECRET=kunci_rahasia_aman_anda

Catatan: Sesuaikan DB_USER dan DB_PASSWORD dengan pengaturan MySQL di komputer Anda. Jika menggunakan default XAMPP/Laragon, password biasanya kosong.

2. Instalasi Dependensi

Buka terminal di folder project, lalu jalankan perintah berikut secara berurutan:

# 1. Install dependensi untuk Frontend (Root folder)
npm install

# 2. Install dependensi untuk Backend (Server folder)
cd server
npm install
cd ..

3. Inisialisasi Database

Jalankan perintah ini untuk membuat database dan tabel secara otomatis:

node server/init_db.js

Jika berhasil, akan muncul pesan "Database initialized successfully!".

4. Menjalankan Aplikasi

Anda perlu menjalankan Backend dan Frontend secara bersamaan. Gunakan dua terminal terpisah.

Terminal 1 (Untuk Backend Server):

cd server
npm run dev

Server akan berjalan (biasanya di port 3000).

Terminal 2 (Untuk Frontend React):

# Pastikan Anda berada di folder root (bukan folder server)
npm run dev

Akses aplikasi melalui browser di URL yang muncul (biasanya http://localhost:5173).

Fitur Utama

  • Dashboard: Ringkasan keuangan.
  • Transaksi: Catat pemasukan dan pengeluaran dengan filter & pagination.
  • Kategori: Kelola kategori transaksi.
  • Hutang & Piutang: Catat hutang piutang.
  • Jurnal Besar: Laporan lengkap semua transaksi.

Cara Mengganti Nama Toko (Dyfhaa Print)

Secara default, aplikasi menggunakan nama "Dyfhaa Print". Anda dapat menggantinya dengan mengubah teks di 3 file berikut:

  1. Sidebar (Menu Samping)

    • Buka file: src/components/Layout/Sidebar.tsx
    • Cari teks Dyfhaa Print (sekitar baris 30).
    • Ganti dengan nama usaha Anda.
  2. Halaman Login

    • Buka file: src/components/Auth/LoginForm.tsx
    • Cari teks Dyfhaa Print (sekitar baris 40).
    • Ganti sesuai keinginan Anda.
  3. Halaman Dashboard

    • Buka file: src/components/Dashboard/Dashboard.tsx
    • Cari teks Ringkasan keuangan Dyfhaa Print (sekitar baris 95).
    • Ubah menjadi Ringkasan keuangan [Nama Usaha Anda].

Tampilan Aplikasi

Halaman Login

Login

Dashboard

Dashboard

Daftar Transaksi

Transaksi

Manajemen Kategori

Kategori

Manajemen Hutang & Piutang

Hutang

Jurnal Besar

Jurnal Besar

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published