📋 Project Management System

Aplikasi manajemen proyek internal untuk mengelola proyek, aktivitas, mitra/partner, sertifikasi, dan laporan keuangan.

📖 Deskripsi

Project Management System adalah aplikasi Project Management berbasis web yang dirancang untuk mengelola siklus hidup proyek secara menyeluruh — mulai dari pendataan proyek, pencatatan aktivitas harian, manajemen mitra (customer & vendor), pelacakan sertifikasi barang, hingga pelaporan keuangan.

Aplikasi ini dibangun dengan arsitektur terpisah (decoupled):

• Backend sebagai RESTful API yang menangani bisnis logika, autentikasi, otorisasi, dan manajemen data.
• Frontend sebagai Single Page Application (SPA) yang mengonsumsi API dan menyajikan antarmuka pengguna.

Fitur Utama

• 🗂️ Manajemen Proyek — CRUD proyek dengan filter status, kategori, dan pencarian.
• 📝 Pencatatan Aktivitas — Dokumentasi aktivitas per-proyek dengan multi-attachment dan AI-powered document extraction.
• 🤝 Manajemen Mitra — Database customer, vendor, dan partner dengan kontak detail.
• 📜 Sertifikasi — Pelacakan sertifikat barang dan proyek sertifikasi.
• 💰 Laporan Keuangan — Ringkasan finansial proyek.
• 📊 Dashboard — Ringkasan data proyek dan statistik.
• 🔐 Role-Based Access Control — Manajemen role & permission berbasis Spatie.
• 📋 Activity Log — Audit trail untuk semua perubahan data.

🏗️ Arsitektur Sistem

┌─────────────────────┐     HTTP/JSON      ┌─────────────────────────┐
│  Backend (Laravel)  │ ◄───────────────── │  Frontend (SvelteKit)   │
│  - be: backend      │ ──────────────────►│  - fe-v1: frontend-v1   │
│  REST API + JWT     │     API Response   │  - fe-v2: frontend-v2   │
│  Port: 8000         │                    │  Port: 5174 / 5175      │
└─────────────────────┘                    └─────────────────────────┘
         │
         ▼
┌─────────────────────┐
│  Database (MySQL)   │
└─────────────────────┘

⚙️ Tech Stack

Backend

Frontend

Tools Pendukung

📋 Prerequisites

Pastikan tools berikut sudah terinstall di mesin development Anda:

[!TIP] Untuk pengguna Windows, Laragon sangat direkomendasikan karena sudah mencakup PHP, MySQL, Apache/Nginx, dan Composer dalam satu paket.

🚀 Installation & Setup Guide

1. Clone Repository

# Project Management
git clone https://github.com/indogreen/project-management.git
cd project-management

# Laravel Backend (pada terminal terpisah)
cd backend

# SvelteKit Frontend v1 (pada terminal terpisah)
cd frontend-v1

# SvelteKit Frontend v2 (pada terminal terpisah)
cd frontend-v2

2. Setup Backend (Laravel)

cd backend

# Install dependencies PHP
composer install

# Salin file environment
copy .env.example .env        # Windows
# cp .env.example .env        # Linux/Mac

# Generate application key
php artisan key:generate

# Generate JWT secret key
php artisan jwt:secret

Konfigurasi .env Backend

Buka file .env dan sesuaikan konfigurasi berikut:

# ── Aplikasi ────────────────────────────────────────
APP_NAME="[Nama Proyek]"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost:8000

# ── Database ─────────────────────────────────────
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=[nama_database]
DB_USERNAME=root
DB_PASSWORD=

# ── Laravel dev server defaults (Opsional) ──────
SERVER_HOST=192.168.1.66
SERVER_PORT=8001

# ── AI Document Extraction (Opsional) ───────────
AI_BASE_URL=[url_ai_provider]
AI_API_KEY=[api_key_anda]
AI_MODEL=[nama_model]

# ── JWT ──────────────────────────────────────────
JWT_SECRET=[akan terisi otomatis setelah php artisan jwt:secret]

JWT_ALGO=[akan terisi otomatis setelah php artisan jwt:secret]

Jalankan Migration & Seeder

# Buat tabel di database
php artisan migrate

# (Opsional) Jalankan seeder untuk data awal
php artisan db:seed

# Buat symbolic link untuk storage publik
php artisan storage:link

Jalankan Backend Server

# Cara 1: Laravel dev server saja
php artisan serve

# Cara 2: Jalankan semua service sekaligus (server + queue + logs + vite)
composer run dev

Server backend akan berjalan di: http://localhost:8000

3. Setup Frontend (SvelteKit)

[!NOTE] Langkah ini sama untuk v1 (frontend-v1) maupun v2 (frontend-v2).

cd frontend-v1    # atau frontend-v2

# Install dependencies Node.js
npm install

# Salin file environment
copy .env.example .env        # Windows
# cp .env.example .env        # Linux/Mac

Konfigurasi .env Frontend

# Server development
DEV_HOST=localhost
DEV_PORT=5174              # Gunakan port berbeda untuk v2 (misal: 5175)

# Server preview
PREVIEW_HOST=localhost
PREVIEW_PORT=4174

# HMR (Hot Module Replacement)
HMR_HOST=localhost
HMR_PORT=24679             # Gunakan port berbeda untuk v2

# Public — URL Backend API
PUBLIC_API_BASE_URL=http://127.0.0.1:8000/api
PUBLIC_STORAGE_BASE_URL=http://127.0.0.1:8000/storage

Jalankan Frontend Dev Server

npm run dev

Frontend akan berjalan di: http://localhost:5174 (atau port yang dikonfigurasi)

4. Verifikasi Instalasi

📁 Struktur Repository

[project-root]/
├── backend/        # Laravel REST API
├── frontend-v1/    # SvelteKit Frontend v1 (Axios-based)
└── frontend-v2/    # SvelteKit Frontend v2 (Fetch-based)

[!IMPORTANT] Setiap repository memiliki .git sendiri. Pastikan untuk mengelola version control secara independen per-repository.

🧪 Testing

# Backend — PHPUnit
cd backend
php artisan test

# Frontend — Vitest
cd frontend-v1      # atau frontend-v2
npm run test

📚 Dokumentasi Lanjutan

👥 Tim & Kontributor