1. Ringkasan Proyek 1. Project Overview

SRM Command Center Website adalah aplikasi dashboard internal yang dikembangkan khusus untuk departemen Security Risk Management (SRM) dari PT Freeport Indonesia. Aplikasi ini memusatkan pengawasan wilayah AOR, kontak penting, dan koordinasi tanggap darurat.

The SRM Command Center Website is an internal dashboard application custom-built for the Security Risk Management (SRM) department of PT Freeport Indonesia. It centralizes AOR group tracking, priority helplines, and emergency incident dispatch tools.

Aplikasi ini menggunakan arsitektur hibrida terpisah yang terdiri dari aplikasi utama berbasis Laravel (React + Inertia.js) dan backend microservice pencarian kesamaan berbasis Python FastAPI.

The system implements a hybrid decoupled architecture consisting of a primary Laravel application (React + Inertia.js) and a secondary similarity search microservice powered by Python FastAPI.

2. Tujuan Aplikasi 2. Application Purpose

Aplikasi ini berfungsi sebagai pusat operasi internal untuk mengelola data sensitif. Ini bukan portal pemasaran publik, melainkan dashboard administratif yang menangani:

This system functions as an internal operations hub for handling highly sensitive logistics. It is not a public portal but an administrative panel handling:

• Segmentasi Area of Responsibility (AOR) untuk membagi data wilayah penugasan keamanan.
• Katalog nomor darurat (emergency contact) untuk jalur respons cepat.
• Pengiriman laporan lapangan (field reports) dan pencatatan shift personel manned guarding.
• Log persetujuan administratif untuk menyetujui rilis berita dan postingan lapangan.
• Pustaka dokumen SOP dengan dukungan mesin pencari kesamaan teks.

• Area of Responsibility (AOR) grouping to separate duty outpost metrics.
• Emergency call directories filtered by AOR for quick reaction dispatch.
• Field incident reports submissions and shift logging for manned guarding.
• Administrative approval logging to validate field posts and news publications.
• Secure SOP catalog hosting backed by a text similarity recommendation search.

3. Teknologi yang Digunakan 3. Technology Stack

4. Kebutuhan Local Development 4. Local Development Requirements

Sebelum memulai instalasi, pastikan workstation development Anda memenuhi persyaratan perangkat lunak berikut:

Before initiating installation, verify that your development environment satisfies the following software requirements:

• Versi PHP: PHP 8.3 atau yang lebih baru.
• Package Manager PHP: Composer terinstal global.
• JavaScript Runtime: Node.js LTS (v20+) dengan NPM.
• Engine Database: MySQL versi 8.0+.
• Versi Python: Python 3.10+ beserta Pip.

• PHP Engine: PHP 8.3 or newer runtime.
• PHP Package Manager: Composer installed globally.
• JS Runtime Environment: Node.js LTS (v20+) with NPM.
• Database Engine: MySQL 8.0 or newer.
• Python Runtime: Python 3.10+ and Pip package manager.

5. Panduan Instalasi macOS 5. macOS Installation Guide

Instalasi development yang disarankan untuk pengguna macOS adalah dengan menggunakan Laravel Herd untuk virtual hosting lokal dan DBngin untuk mengelola instance MySQL 8 lokal.

The recommended setup route on macOS utilizes Laravel Herd for rapid local domain routing and DBngin for database instance provisioning.

git clone https://github.com/DodikSukma/srm-fmi-web.git
cd srm-fmi-web
cp .env.example .env
composer install
npm install

6. Panduan Instalasi Windows 6. Windows Installation Guide

Untuk OS Windows, developer disarankan menggunakan Laragon untuk mempermudah pembuatan virtual host lokal dan manajemen MySQL 8.

On Windows workstations, developers are encouraged to run Laragon for simple virtual domain mapping and embedded database hosting.

7. Setup Database 7. Database Setup

Aplikasi memerlukan database relasional bernama srm_fmi_web.

The local environment requires a schema named srm_fmi_web to be initialized.

CREATE DATABASE srm_fmi_web CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

8. Environment Variables 8. Environment Variables

Sesuaikan berkas .env Anda untuk menghubungkan framework ke database dan server NLP FastAPI:

Adjust the parameters in your .env file to tie Laravel with MySQL and the NLP FastAPI service:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=srm_fmi_web
DB_USERNAME=root
DB_PASSWORD=

# FastAPI NLP API endpoint
RECOMMENDATION_SERVICE_URL=http://127.0.0.1:8000

9. Perintah Setup Laravel & Frontend 9. Laravel & Frontend Setup Commands

Jalankan perintah berikut pada terminal di folder root project untuk meng-generate key, memigrasi tabel database, serta mengompilasi assets React:

Run these setup commands in your terminal at the root directory to generate application keys, migrate tables, seed initial AOR data, and build UI bundles:

# Generate App Key & Migrasi Database
php artisan key:generate
php artisan migrate --seed

# Jalankan hot-reloading Vite server
npm run dev

10. Setup Python FastAPI 10. Python FastAPI Setup

Layanan rekomendasi NLP berbasis Python FastAPI terletak di folder /recommendation_service. Jalankan uvicorn server pada port 8000 dengan langkah berikut:

The natural language processing service is located inside the /recommendation_service directory. Build and run it on port 8000 using the following steps:

# Masuk ke folder layanan & buat virtual environment
cd recommendation_service
python3 -m venv venv

# Aktifkan venv (macOS/Linux)
source venv/bin/activate
# Aktifkan venv (Windows CMD): venv\Scripts\activate

# Install requirements & jalankan server
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

11. Struktur Folder 11. Folder Structure

Peta struktur direktori penting di dalam project workspace:

Folder structure map highlighting important directories in the project workspace:

srm-fmi-web/
├── app/                        # Inti Laravel (Controllers, Models, Services)
├── database/                   # Migrasi database & data seeds
├── docs/                       # Dokumentasi proyek & tiket
│   └── docs-web/               # Folder website dokumentasi statis (portal ini)
├── recommendation_service/     # Python FastAPI NLP Service
├── resources/                  # Folder Aset Frontend
│   └── js/                     # Halaman React & Komponen UI (Welcome, Dashboard, dsb.)
├── routes/                     # Definisi routing aplikasi (web.php)
└── tailwind.config.js          # Pengaturan visual Tailwind CSS tokens