docs: finalize report assets and polish dashboard UI
This commit is contained in:
parent
441e709193
commit
a6edf804b4
42 changed files with 1084 additions and 406 deletions
|
|
@ -12,7 +12,6 @@
|
|||
\usepackage{hyperref}
|
||||
\usepackage{xcolor}
|
||||
\usepackage{listings}
|
||||
\usepackage[most]{tcolorbox}
|
||||
\usepackage{enumitem}
|
||||
\usepackage{titlesec}
|
||||
\usepackage{setspace}
|
||||
|
|
@ -38,7 +37,6 @@
|
|||
|
||||
\definecolor{codebg}{RGB}{248,248,248}
|
||||
\definecolor{bordergray}{RGB}{210,210,210}
|
||||
\definecolor{titleblue}{RGB}{25,66,122}
|
||||
|
||||
\lstdefinestyle{minmoncode}{
|
||||
backgroundcolor=\color{codebg},
|
||||
|
|
@ -53,37 +51,29 @@
|
|||
stringstyle=\color{red!50!black}
|
||||
}
|
||||
|
||||
\lstdefinelanguage{TypeScript}{
|
||||
keywords={import,from,export,const,return,if,await,async,type,string,number,boolean,null,undefined},
|
||||
sensitive=true,
|
||||
morecomment=[l]{//},
|
||||
morecomment=[s]{/*}{*/},
|
||||
morestring=[b]",
|
||||
morestring=[b]'
|
||||
}
|
||||
|
||||
\newcommand{\uipath}[1]{\texttt{#1}}
|
||||
\newcommand{\uibutton}[1]{\textbf{#1}}
|
||||
|
||||
\newtcolorbox{infobox}[1][]{
|
||||
colback=blue!3,
|
||||
colframe=titleblue,
|
||||
boxrule=0.6pt,
|
||||
arc=0pt,
|
||||
left=8pt,
|
||||
right=8pt,
|
||||
top=8pt,
|
||||
bottom=8pt,
|
||||
#1
|
||||
}
|
||||
|
||||
\newtcolorbox{warningbox}[1][]{
|
||||
colback=yellow!8,
|
||||
colframe=orange!70!black,
|
||||
boxrule=0.6pt,
|
||||
arc=0pt,
|
||||
left=8pt,
|
||||
right=8pt,
|
||||
top=8pt,
|
||||
bottom=8pt,
|
||||
#1
|
||||
}
|
||||
|
||||
\newcommand{\placeholderfigure}[2]{
|
||||
\newcommand{\uiscreenshot}[2]{
|
||||
\begin{figure}[H]
|
||||
\centering
|
||||
\fbox{\parbox[c][6cm][c]{0.82\textwidth}{\centering\textit{Placeholder gambar/diagram}\\[0.5em]#1}}
|
||||
\includegraphics[width=0.94\textwidth]{#1}
|
||||
\caption{#2}
|
||||
\end{figure}
|
||||
}
|
||||
|
||||
\newcommand{\uidiagram}[2]{
|
||||
\begin{figure}[H]
|
||||
\centering
|
||||
\includegraphics[width=0.94\textwidth,height=0.72\textheight,keepaspectratio]{#1}
|
||||
\caption{#2}
|
||||
\end{figure}
|
||||
}
|
||||
|
|
@ -96,19 +86,19 @@
|
|||
{\Huge \textbf{MINMON}}\\[0.4cm]
|
||||
{\Large Dashboard Inventaris dan Monitoring Homelab Berbasis Web}\\[1.2cm]
|
||||
|
||||
\begin{infobox}[width=0.9\textwidth]
|
||||
\textbf{Nama Mahasiswa} : [Isi Nama Anda]\\
|
||||
\textbf{NIM} : [Isi NIM Anda]\\
|
||||
\textbf{Program Studi} : [Isi Program Studi]\\
|
||||
\textbf{Mata Kuliah} : [Isi Mata Kuliah]\\
|
||||
\textbf{Dosen Pengampu} : [Isi Nama Dosen]\\
|
||||
\textbf{Institusi} : [Isi Nama Universitas / Sekolah]\\
|
||||
\textbf{Tahun Akademik} : [Isi Tahun Akademik]
|
||||
\end{infobox}
|
||||
\begin{tabular}{ll}
|
||||
\textbf{Nama Mahasiswa} & : \makebox[7cm]{\hrulefill}\\
|
||||
\textbf{NIM} & : \makebox[7cm]{\hrulefill}\\
|
||||
\textbf{Program Studi} & : \makebox[7cm]{\hrulefill}\\
|
||||
\textbf{Mata Kuliah} & : \makebox[7cm]{\hrulefill}\\
|
||||
\textbf{Dosen Pengampu} & : \makebox[7cm]{\hrulefill}\\
|
||||
\textbf{Institusi} & : \makebox[7cm]{\hrulefill}\\
|
||||
\textbf{Tahun Akademik} & : \makebox[7cm]{\hrulefill}
|
||||
\end{tabular}
|
||||
|
||||
\vfill
|
||||
|
||||
{\large Dokumen ini disusun untuk mendeskripsikan proyek \textit{Minmon} yang digunakan untuk mendata dan memonitor inventaris homelab, khususnya lingkungan kecil yang umumnya terdiri dari 2 server utama dengan banyak service dan domain terkait.}\\[1cm]
|
||||
{\large Dokumen ini disusun untuk mendeskripsikan proyek \textit{Minmon} yang digunakan untuk mendata dan memonitor inventaris homelab, khususnya lingkungan kecil yang terdiri dari beberapa server dengan banyak service dan domain terkait.}\\[1cm]
|
||||
|
||||
{\large \today}
|
||||
\end{titlepage}
|
||||
|
|
@ -119,31 +109,31 @@
|
|||
\chapter{Pendahuluan}
|
||||
|
||||
\section{Latar Belakang}
|
||||
Homelab modern tidak lagi hanya berisi satu mesin dengan satu layanan. Dalam praktiknya, satu homelab kecil dapat terdiri dari beberapa server, banyak service seperti reverse proxy, dashboard, media server, database, automation tools, serta sejumlah domain atau subdomain yang harus diarahkan ke alamat IP yang benar. Ketika jumlah aset ini bertambah, pencatatan manual menjadi sulit dipelihara karena data server, service, domain, dan catatan operasional tersebar di berbagai tempat.
|
||||
Homelab adalah lingkungan laboratorium komputer pribadi yang biasanya dibangun di rumah atau lingkungan kecil untuk belajar, mencoba, dan menjalankan layanan server secara mandiri. Dalam homelab, pengguna dapat mengelola server fisik, mini PC, virtual machine, container, jaringan lokal, serta berbagai aplikasi seperti dashboard, database, media server, reverse proxy, dan automation tools. Homelab modern tidak lagi hanya berisi satu mesin dengan satu layanan. Dalam praktiknya, satu homelab kecil dapat terdiri dari beberapa server, banyak service, serta sejumlah domain atau subdomain yang harus diarahkan ke alamat IP yang benar. Ketika jumlah aset ini bertambah, pencatatan manual menjadi sulit dipelihara karena data server, service, domain, dan catatan operasional tersebar di berbagai tempat.
|
||||
|
||||
Minmon dikembangkan sebagai dashboard inventaris dan monitoring ringan berbasis web untuk membantu pemilik homelab mengelola aset tersebut dalam satu aplikasi terpusat. Aplikasi ini tidak ditujukan untuk deployment automation, melainkan untuk kebutuhan dokumentasi, inventaris, relasi data, dan validasi DNS sederhana. Dalam konteks penggunaan pribadi, proyek ini cocok untuk skenario homelab yang biasanya terdiri dari 2 server utama dengan banyak service dan domain yang perlu dicatat serta dipantau.
|
||||
Minmon dikembangkan sebagai dashboard inventaris dan monitoring ringan berbasis web untuk membantu pemilik homelab mengelola aset tersebut dalam satu aplikasi terpusat. Aplikasi ini tidak ditujukan untuk deployment automation, melainkan untuk kebutuhan dokumentasi, inventaris, relasi data, dan validasi DNS sederhana. Dalam konteks penggunaan pribadi, proyek ini cocok untuk skenario homelab yang terdiri dari beberapa server dengan banyak service dan domain yang perlu dicatat serta dipantau.
|
||||
|
||||
Implementasi saat ini menyediakan autentikasi admin, dashboard ringkasan, CRUD untuk server, service, domain, dan note, serta fitur pemeriksaan DNS A record. Selain itu, relasi antar entitas juga sudah diterapkan melalui select input agar pengguna tidak perlu memasukkan ID relasi secara manual. Dengan demikian, Minmon dapat berfungsi sebagai pusat data operasional homelab yang lebih rapi, konsisten, dan mudah diperluas.
|
||||
Implementasi saat ini menyediakan autentikasi admin, dashboard ringkasan, CRUD untuk server, service, domain, dan catatan, serta fitur pemeriksaan DNS A record. Selain itu, relasi antar entitas juga sudah diterapkan melalui select input agar pengguna tidak perlu memasukkan ID relasi secara manual. Dengan demikian, Minmon dapat berfungsi sebagai pusat data operasional homelab yang lebih rapi, konsisten, dan mudah diperluas.
|
||||
|
||||
\section{Tujuan}
|
||||
Tujuan dari pengembangan proyek ini adalah sebagai berikut:
|
||||
|
||||
\begin{itemize}
|
||||
\item Membangun aplikasi web yang dapat digunakan untuk mengelola inventaris homelab secara terstruktur.
|
||||
\item Menyediakan fitur CRUD untuk data server, service, domain, dan note dalam satu dashboard terproteksi.
|
||||
\item Menyediakan fitur CRUD untuk data server, service, domain, dan catatan dalam satu dashboard terproteksi.
|
||||
\item Menyediakan pemeriksaan DNS sederhana untuk memverifikasi apakah domain mengarah ke IP server yang diharapkan.
|
||||
\item Mempermudah dokumentasi relasi data, misalnya service yang berjalan pada server tertentu dan note yang melekat pada server tertentu.
|
||||
\item Menjadi contoh implementasi full-stack berbasis React, tRPC, Drizzle ORM, PostgreSQL, dan better-auth.
|
||||
\item Mempermudah dokumentasi relasi data, misalnya service yang berjalan pada server tertentu dan catatan yang melekat pada server tertentu.
|
||||
\item Menjadi contoh implementasi aplikasi web penuh berbasis React, tRPC, Drizzle ORM, PostgreSQL, dan better-auth.
|
||||
\end{itemize}
|
||||
|
||||
\section{Manfaat}
|
||||
Manfaat dari proyek ini antara lain:
|
||||
|
||||
\begin{itemize}
|
||||
\item Membantu pemilik homelab mendokumentasikan server, service, domain, dan note dalam satu tempat.
|
||||
\item Mengurangi kesalahan input relasi data karena pilihan parent-child dibuat melalui select input.
|
||||
\item Memudahkan pengecekan domain melalui fitur DNS check berbasis A record / IPv4.
|
||||
\item Memberikan gambaran ringkas kondisi homelab melalui dashboard summary.
|
||||
\item Membantu pemilik homelab mendokumentasikan server, service, domain, dan catatan dalam satu tempat.
|
||||
\item Mengurangi kesalahan input relasi data karena hubungan antar data dipilih melalui field pilihan.
|
||||
\item Memudahkan pengecekan domain melalui fitur pemeriksaan DNS berbasis A record / IPv4.
|
||||
\item Memberikan gambaran ringkas kondisi homelab melalui ringkasan dashboard.
|
||||
\item Menjadi bahan laporan akademik dan contoh produk perangkat lunak yang benar-benar dapat dipakai.
|
||||
\end{itemize}
|
||||
|
||||
|
|
@ -154,59 +144,58 @@ Tahap pengembangan proyek Minmon dapat dijelaskan secara ringkas sebagai berikut
|
|||
|
||||
\begin{enumerate}
|
||||
\item \textbf{Identifikasi kebutuhan}\\
|
||||
Menentukan kebutuhan utama untuk inventaris homelab, yaitu pengelolaan data server, service, domain, dan note, serta kebutuhan monitoring DNS sederhana.
|
||||
Menentukan kebutuhan utama untuk inventaris homelab, yaitu pengelolaan data server, service, domain, dan catatan, serta kebutuhan monitoring DNS sederhana.
|
||||
|
||||
\item \textbf{Perancangan data dan relasi}\\
|
||||
Menentukan entitas inti: \texttt{server}, \texttt{service}, \texttt{domain}, dan \texttt{note}. Setiap service terkait ke satu server, setiap domain terkait ke satu service, dan setiap note terkait ke satu server.
|
||||
Menentukan entitas inti, yaitu server, service, domain, dan catatan. Setiap service terkait ke satu server, setiap domain terkait ke satu service, dan setiap catatan terkait ke satu server.
|
||||
|
||||
\item \textbf{Perancangan backend}\\
|
||||
Mengimplementasikan router tRPC untuk operasi list, detail, create, update, delete, serta ringkasan dashboard. Pemeriksaan DNS diimplementasikan sebagai mutation khusus pada domain.
|
||||
Mengimplementasikan router tRPC untuk operasi daftar data, detail, tambah, ubah, hapus, serta ringkasan dashboard. Pemeriksaan DNS diimplementasikan sebagai operasi khusus pada data domain.
|
||||
|
||||
\item \textbf{Perancangan frontend}\\
|
||||
Membangun halaman login, dashboard summary, halaman list, halaman create, dan halaman detail/edit untuk setiap entitas. Form relasi dibuat menggunakan select agar lebih aman dan mudah dipakai.
|
||||
Membangun halaman login, ringkasan dashboard, halaman daftar data, halaman tambah data, dan halaman detail/edit untuk setiap entitas. Form relasi dibuat menggunakan pilihan data agar lebih aman dan mudah dipakai.
|
||||
|
||||
\item \textbf{Integrasi dan validasi}\\
|
||||
Menghubungkan frontend ke backend dengan TanStack Query dan tRPC client, lalu memastikan mutasi, invalidasi query, serta tampilan ringkasan berjalan dengan baik.
|
||||
Menghubungkan frontend ke backend dengan TanStack Query dan tRPC client, lalu memastikan operasi data, pembaruan ulang data, serta tampilan ringkasan berjalan dengan baik.
|
||||
|
||||
\item \textbf{Pengujian dan penyempurnaan}\\
|
||||
Melakukan typecheck, pengecekan alur CRUD, pengecekan DNS, perbaikan kestabilan urutan list, dan penyempurnaan interaksi UI seperti delete dua langkah dan trigger DNS dari status badge.
|
||||
Melakukan pemeriksaan tipe, pengecekan alur CRUD, pengecekan DNS, perbaikan kestabilan urutan daftar data, dan penyempurnaan interaksi UI seperti hapus dua langkah dan pemicu DNS dari badge status.
|
||||
\end{enumerate}
|
||||
|
||||
\section{Identitas/Keunikan Produk}
|
||||
Minmon memiliki identitas produk sebagai dashboard inventaris dan monitoring ringan untuk homelab. Keunikan produk ini dibanding pencatatan manual biasa adalah sebagai berikut:
|
||||
|
||||
\begin{itemize}
|
||||
\item Fokus pada skenario homelab kecil-menengah, misalnya 2 server dengan banyak service dan domain.
|
||||
\item Fokus pada skenario homelab kecil-menengah, yaitu beberapa server dengan banyak service dan domain.
|
||||
\item Menggabungkan inventaris dan dokumentasi operasional dalam satu aplikasi.
|
||||
\item Menyediakan relasi data yang jelas antara server, service, domain, dan note.
|
||||
\item Memiliki DNS A-record checking yang terintegrasi langsung pada alur domain.
|
||||
\item Menampilkan note yang terkait langsung pada halaman detail server.
|
||||
\item Menyediakan relasi data yang jelas antara server, service, domain, dan catatan.
|
||||
\item Memiliki pemeriksaan DNS A record yang terintegrasi langsung pada alur domain.
|
||||
\item Menampilkan catatan yang terkait langsung pada halaman detail server.
|
||||
\item Menggunakan autentikasi admin sehingga dashboard tidak dapat diakses tanpa sesi.
|
||||
\end{itemize}
|
||||
|
||||
\begin{infobox}[title=Keunikan Praktis Produk]
|
||||
Untuk penggunaan pribadi, Minmon cocok sebagai pusat dokumentasi homelab yang tidak hanya menyimpan data inventaris, tetapi juga membantu memastikan domain masih mengarah ke IP yang benar dan memudahkan pelacakan note operasional pada setiap server.
|
||||
\end{infobox}
|
||||
Untuk penggunaan pribadi, Minmon cocok sebagai pusat dokumentasi homelab yang tidak hanya menyimpan data inventaris, tetapi juga membantu memastikan domain masih mengarah ke IP yang benar dan memudahkan pelacakan catatan operasional pada setiap server.
|
||||
|
||||
\section{Diagram-diagram UML (use case, class, activity, state chart, sequence, collaboration)}
|
||||
Bagian ini dapat diisi dengan diagram UML final. Struktur dan isi diagram sebaiknya disesuaikan dengan implementasi saat ini.
|
||||
Bagian ini berisi rancangan UML yang disusun berdasarkan implementasi aktual Minmon. Diagram disisipkan sebagai gambar agar alur sistem dapat dibaca langsung di dalam laporan. Struktur diagram mencerminkan aktor admin, modul frontend React, router tRPC, database PostgreSQL melalui Drizzle ORM, dan modul pemeriksaan DNS.
|
||||
|
||||
\subsection{Use Case Diagram}
|
||||
Use case utama dalam sistem ini meliputi:
|
||||
|
||||
\begin{itemize}
|
||||
\item Admin sign in
|
||||
\item Admin mengakses dashboard summary
|
||||
\item Admin mengakses ringkasan dashboard
|
||||
\item Admin mengelola server
|
||||
\item Admin mengelola service
|
||||
\item Admin mengelola domain
|
||||
\item Admin menjalankan DNS check
|
||||
\item Admin mengelola note
|
||||
\item Admin melihat note pada detail server
|
||||
\item Admin menjalankan pemeriksaan DNS dari halaman daftar atau detail domain
|
||||
\item UI menjalankan pemeriksaan DNS setelah domain dibuat atau diperbarui
|
||||
\item Admin mengelola catatan
|
||||
\item Admin melihat catatan pada detail server
|
||||
\item Admin sign out
|
||||
\end{itemize}
|
||||
|
||||
\placeholderfigure{Tambahkan diagram use case hasil export UML Anda di sini.}{Use Case Diagram Minmon}
|
||||
\uidiagram{diagrams/use-case.png}{Use Case Diagram Minmon}
|
||||
|
||||
\subsection{Class Diagram}
|
||||
Entitas utama pada sistem adalah:
|
||||
|
|
@ -215,33 +204,33 @@ Entitas utama pada sistem adalah:
|
|||
\item \textbf{Server}: id, name, primaryIpAddress, secondaryIpAddress, operatingSystem, location, provider, description, status, createdAt, updatedAt
|
||||
\item \textbf{Service}: id, serverId, name, type, internalPort, externalPort, protocol, status, description, createdAt, updatedAt
|
||||
\item \textbf{Domain}: id, serviceId, name, expectedServerIp, lastResolvedIp, lastResolvedIps, resolutionStatus, lastCheckedAt, remarks, lastCheckMessage, createdAt, updatedAt
|
||||
\item \textbf{Note}: id, serverId, title, content, category, createdAt, updatedAt
|
||||
\item \textbf{Catatan}: id, serverId, title, content, category, createdAt, updatedAt
|
||||
\end{itemize}
|
||||
|
||||
Hubungan utama:
|
||||
|
||||
\begin{itemize}
|
||||
\item Server 1..* Service
|
||||
\item Server 1..* Note
|
||||
\item Service 1..* Domain
|
||||
\item Server 1..* Service secara konseptual, tetapi secara database dapat 0..*.
|
||||
\item Server 1..* Catatan secara konseptual, tetapi secara database dapat 0..*.
|
||||
\item Service 1..* Domain secara konseptual, tetapi secara database dapat 0..*.
|
||||
\end{itemize}
|
||||
|
||||
\placeholderfigure{Tambahkan diagram class hasil export UML Anda di sini.}{Class Diagram Minmon}
|
||||
\uidiagram{diagrams/class.png}{Class Diagram Minmon}
|
||||
|
||||
\subsection{Activity Diagram}
|
||||
Activity diagram yang disarankan adalah alur \textit{Check DNS from Domain List}:
|
||||
Activity diagram berikut menampilkan alur pemeriksaan DNS yang sesuai dengan implementasi saat ini, yaitu dipicu oleh UI setelah domain ditambahkan/diperbarui atau dijalankan manual dari halaman daftar/detail domain:
|
||||
|
||||
\begin{enumerate}
|
||||
\item Admin membuka halaman domain list.
|
||||
\item Admin menekan badge status DNS.
|
||||
\item UI memanggil mutation \texttt{domains.check}.
|
||||
\item Admin membuat, memperbarui, atau memeriksa domain.
|
||||
\item UI memanggil operasi \texttt{domains.create}, \texttt{domains.update}, atau \texttt{domains.check} sesuai aksi.
|
||||
\item Setelah create/update berhasil, UI memanggil \texttt{domains.check} untuk menjalankan pemeriksaan DNS.
|
||||
\item Backend melakukan resolve IPv4 A record.
|
||||
\item Backend membandingkan hasil resolve dengan \texttt{expectedServerIp}.
|
||||
\item Backend menyimpan hasil ke database.
|
||||
\item UI me-refresh data dan menampilkan status baru.
|
||||
\item Backend menyimpan status dan hasil resolve ke database.
|
||||
\item UI memperbarui ulang data dan menampilkan status baru.
|
||||
\end{enumerate}
|
||||
|
||||
\placeholderfigure{Tambahkan activity diagram di sini.}{Activity Diagram DNS Check}
|
||||
\uidiagram{diagrams/activity.png}{Activity Diagram DNS Check}
|
||||
|
||||
\subsection{State Chart Diagram}
|
||||
State chart yang disarankan adalah state untuk status DNS domain:
|
||||
|
|
@ -260,134 +249,143 @@ Transisi utama:
|
|||
\item DNS gagal resolve $\rightarrow$ UNRESOLVED
|
||||
\end{itemize}
|
||||
|
||||
\placeholderfigure{Tambahkan state chart diagram di sini.}{State Chart Domain DNS}
|
||||
\uidiagram{diagrams/state-chart.png}{State Chart Domain DNS}
|
||||
|
||||
\subsection{Sequence Diagram}
|
||||
Sequence diagram yang cocok untuk proyek ini adalah alur \textit{Create Domain and Check DNS}:
|
||||
Sequence diagram yang cocok untuk proyek ini adalah alur tambah domain dan pemeriksaan DNS lanjutan, karena UI langsung memanggil pemeriksaan DNS setelah domain berhasil dibuat:
|
||||
|
||||
\begin{itemize}
|
||||
\item Admin
|
||||
\item Web UI
|
||||
\item tRPC API
|
||||
\item tRPC client/API
|
||||
\item Database
|
||||
\item Domain check module
|
||||
\item DNS Resolver
|
||||
\end{itemize}
|
||||
|
||||
\placeholderfigure{Tambahkan sequence diagram di sini.}{Sequence Diagram Create Domain and Check DNS}
|
||||
\uidiagram{diagrams/sequence.png}{Sequence Diagram Create Domain and Check DNS}
|
||||
|
||||
\subsection{Collaboration Diagram}
|
||||
Collaboration diagram dapat menunjukkan interaksi antara:
|
||||
Collaboration diagram menunjukkan interaksi aktual antara route terproteksi, halaman dashboard, TanStack Query, router tRPC, database, dan modul pemeriksaan DNS:
|
||||
|
||||
\begin{itemize}
|
||||
\item Admin
|
||||
\item Dashboard UI
|
||||
\item Dashboard UI dan route terproteksi
|
||||
\item better-auth client
|
||||
\item tRPC router
|
||||
\item TanStack Query dan tRPC router
|
||||
\item Database
|
||||
\item DNS lookup module
|
||||
\item Modul DNS lookup
|
||||
\end{itemize}
|
||||
|
||||
\placeholderfigure{Tambahkan collaboration diagram di sini.}{Collaboration Diagram Minmon}
|
||||
\uidiagram{diagrams/collaboration.png}{Collaboration Diagram Minmon}
|
||||
|
||||
\section{Potongan Code Fitur-Fitur Utama}
|
||||
Bagian ini menampilkan beberapa potongan kode yang mewakili fitur inti dari implementasi saat ini.
|
||||
\section{Coding Minimal 80 Baris}
|
||||
Bagian ini menampilkan kode asli dari file \uipath{packages/api/src/routers/services.ts}. Kode ini dipilih karena berjumlah 82 baris dan mewakili logika inti backend, yaitu protected CRUD untuk entitas service, validasi relasi ke server, penghitungan ringkasan domain, dan operasi database menggunakan Drizzle ORM.
|
||||
|
||||
\subsection{Redirect Root Berdasarkan Session}
|
||||
Potongan berikut menunjukkan bahwa route \uipath{/} akan mengarahkan pengguna ke \uipath{/dashboard} atau \uipath{/login} berdasarkan session yang didapat dari auth client.
|
||||
\begin{lstlisting}[style=minmoncode,language=TypeScript,caption={Kode servicesRouter: CRUD Service dan validasi relasi, 82 baris}]
|
||||
import { db } from "@minmon/db";
|
||||
import { domain, service } from "@minmon/db";
|
||||
import { count, desc, eq } from "drizzle-orm";
|
||||
|
||||
\begin{lstlisting}[style=minmoncode,language=TypeScript,caption={Root redirect berdasarkan session}]
|
||||
export const Route = createFileRoute("/")({
|
||||
beforeLoad: async () => {
|
||||
const session = await authClient.getSession();
|
||||
import { protectedProcedure, router } from "../index";
|
||||
import {
|
||||
byIdSchema,
|
||||
serviceCreateSchema,
|
||||
serviceListSchema,
|
||||
serviceUpdateSchema,
|
||||
} from "./schemas";
|
||||
import {
|
||||
createEntityId,
|
||||
requireServer,
|
||||
requireService,
|
||||
stripUndefined,
|
||||
} from "./utils";
|
||||
|
||||
throw redirect({
|
||||
to: session.data ? "/dashboard" : "/login",
|
||||
});
|
||||
},
|
||||
component: () => null,
|
||||
export const servicesRouter = router({
|
||||
list: protectedProcedure.input(serviceListSchema).query(async ({ input }) => {
|
||||
if (!input?.serverId) {
|
||||
return db.select().from(service).orderBy(desc(service.createdAt), desc(service.id));
|
||||
}
|
||||
|
||||
await requireServer(input.serverId);
|
||||
|
||||
return db
|
||||
.select()
|
||||
.from(service)
|
||||
.where(eq(service.serverId, input.serverId))
|
||||
.orderBy(desc(service.createdAt), desc(service.id));
|
||||
}),
|
||||
|
||||
byId: protectedProcedure.input(byIdSchema).query(async ({ input }) => {
|
||||
const item = await requireService(input.id);
|
||||
const [domainCount] = await db.select({ count: count() }).from(domain).where(eq(domain.serviceId, input.id));
|
||||
|
||||
return {
|
||||
...item,
|
||||
summary: {
|
||||
domains: domainCount?.count ?? 0,
|
||||
},
|
||||
};
|
||||
}),
|
||||
|
||||
create: protectedProcedure.input(serviceCreateSchema).mutation(async ({ input }) => {
|
||||
await requireServer(input.serverId);
|
||||
|
||||
const [created] = await db
|
||||
.insert(service)
|
||||
.values({
|
||||
id: createEntityId(),
|
||||
...input,
|
||||
})
|
||||
.returning();
|
||||
|
||||
return created;
|
||||
}),
|
||||
|
||||
update: protectedProcedure.input(serviceUpdateSchema).mutation(async ({ input }) => {
|
||||
const { id, serverId, ...changes } = input;
|
||||
await requireService(id);
|
||||
|
||||
if (serverId) {
|
||||
await requireServer(serverId);
|
||||
}
|
||||
|
||||
const [updated] = await db
|
||||
.update(service)
|
||||
.set(stripUndefined({ serverId, ...changes }))
|
||||
.where(eq(service.id, id))
|
||||
.returning();
|
||||
|
||||
return updated;
|
||||
}),
|
||||
|
||||
delete: protectedProcedure.input(byIdSchema).mutation(async ({ input }) => {
|
||||
await requireService(input.id);
|
||||
await db.delete(service).where(eq(service.id, input.id));
|
||||
return { id: input.id };
|
||||
}),
|
||||
});
|
||||
\end{lstlisting}
|
||||
|
||||
\subsection{Ordering List yang Stabil}
|
||||
List utama pada CRUD saat ini diurutkan berdasarkan \texttt{createdAt DESC} lalu \texttt{id DESC} agar urutan tetap deterministik ketika data di-refresh.
|
||||
|
||||
\begin{lstlisting}[style=minmoncode,language=TypeScript,caption={Stable ordering pada list router}]
|
||||
return db
|
||||
.select()
|
||||
.from(domain)
|
||||
.orderBy(desc(domain.createdAt), desc(domain.id));
|
||||
\end{lstlisting}
|
||||
|
||||
\subsection{Pemeriksaan DNS A Record}
|
||||
Pemeriksaan DNS dilakukan dengan resolve IPv4 A record dan membandingkannya dengan IP yang diharapkan.
|
||||
|
||||
\begin{lstlisting}[style=minmoncode,language=TypeScript,caption={Logika DNS check}]
|
||||
export function checkDomainDns(target: DomainCheckTarget) {
|
||||
return Effect.match(resolveIpv4ARecords(target.name), {
|
||||
onSuccess: (resolvedIps: string[]): DomainCheckResult => ({
|
||||
status: resolvedIps.includes(target.expectedServerIp)
|
||||
? "MATCH"
|
||||
: "MISMATCH",
|
||||
resolvedIps,
|
||||
checkedAt: new Date(),
|
||||
message: null,
|
||||
}),
|
||||
onFailure: (error: Error): DomainCheckResult => ({
|
||||
status: "UNRESOLVED",
|
||||
resolvedIps: [],
|
||||
checkedAt: new Date(),
|
||||
message: error.message,
|
||||
}),
|
||||
});
|
||||
}
|
||||
\end{lstlisting}
|
||||
|
||||
\subsection{Select Input untuk Relasi Data}
|
||||
Form relasi tidak lagi menggunakan input teks biasa untuk foreign key utama, tetapi menggunakan select agar lebih aman.
|
||||
|
||||
\begin{lstlisting}[style=minmoncode,language=TypeScript,caption={Contoh select relasi note -> server}]
|
||||
<form.Field name="serverId">
|
||||
{(field) => (
|
||||
<SelectField
|
||||
label="Server"
|
||||
name={field.name}
|
||||
value={field.state.value}
|
||||
onBlur={field.handleBlur}
|
||||
onValueChange={field.handleChange}
|
||||
placeholder="Select a server"
|
||||
options={serverOptions}
|
||||
/>
|
||||
)}
|
||||
</form.Field>
|
||||
\end{lstlisting}
|
||||
|
||||
\subsection{Delete Dua Langkah dengan Ikon}
|
||||
Untuk mencegah salah hapus, aksi delete pada list menggunakan dua tahap klik: ikon trash lalu ikon check.
|
||||
|
||||
\begin{lstlisting}[style=minmoncode,language=TypeScript,caption={Confirm delete icon button}]
|
||||
if (isConfirming) {
|
||||
onConfirm();
|
||||
setIsConfirming(false);
|
||||
return;
|
||||
}
|
||||
|
||||
setIsConfirming(true);
|
||||
\end{lstlisting}
|
||||
Penjelasan singkat kode di atas:
|
||||
\begin{itemize}
|
||||
\item \texttt{list} mengambil daftar service, baik seluruh service maupun service berdasarkan \texttt{serverId}, dengan urutan stabil berdasarkan \texttt{createdAt} dan \texttt{id}.
|
||||
\item \texttt{byId} mengambil detail service dan menambahkan ringkasan jumlah domain yang terhubung ke service tersebut.
|
||||
\item \texttt{create} memvalidasi server induk terlebih dahulu sebelum menyimpan service baru.
|
||||
\item \texttt{update} memastikan service yang diedit ada, lalu memvalidasi server baru jika relasi \texttt{serverId} diubah.
|
||||
\item \texttt{delete} memastikan data service ada sebelum dihapus dari database.
|
||||
\end{itemize}
|
||||
|
||||
\chapter{Manual Book}
|
||||
|
||||
\section{Gambaran Umum Penggunaan}
|
||||
Bagian ini menjelaskan cara menggunakan aplikasi Minmon berdasarkan implementasi saat ini. Gaya penjelasan dibuat seperti manual book: langkah demi langkah, ringkas, dan fokus pada hasil yang diharapkan.
|
||||
|
||||
\begin{warningbox}[title=Data yang Masih Perlu Anda Lengkapi]
|
||||
Untuk versi final laporan, Anda sebaiknya menambahkan screenshot nyata dari aplikasi Anda sendiri, termasuk nama server homelab, contoh service, dan domain yang benar-benar Anda gunakan.
|
||||
\end{warningbox}
|
||||
|
||||
\section{Login ke Sistem}
|
||||
\textbf{Path akses:} \uipath{/login}
|
||||
|
||||
\begin{enumerate}
|
||||
\item Jalankan aplikasi web dan server.
|
||||
\item Jalankan aplikasi web dan server backend dari root proyek menggunakan perintah \texttt{bun run dev}.
|
||||
\item Buka browser ke alamat \uipath{http://localhost:5173}.
|
||||
\item Jika belum login, sistem akan mengarahkan ke \uipath{/login}.
|
||||
\item Masukkan email admin dan password.
|
||||
|
|
@ -396,7 +394,9 @@ Untuk versi final laporan, Anda sebaiknya menambahkan screenshot nyata dari apli
|
|||
|
||||
\textbf{Hasil yang diharapkan:} pengguna masuk ke halaman \uipath{/dashboard}.
|
||||
|
||||
\placeholderfigure{Tambahkan screenshot halaman login di sini.}{Halaman Login Minmon}
|
||||
Tampilan halaman login berisi form email dan password untuk admin. Apabila data benar, sistem membuat session melalui better-auth dan mengarahkan pengguna ke dashboard.
|
||||
|
||||
\uiscreenshot{screenshots/manual-login.png}{Halaman Login Minmon}
|
||||
|
||||
\section{Membuka Dashboard Summary}
|
||||
\textbf{Path akses:} \uipath{/dashboard}
|
||||
|
|
@ -409,17 +409,19 @@ Halaman dashboard menampilkan ringkasan:
|
|||
\item total domain,
|
||||
\item jumlah DNS match / mismatch / unresolved,
|
||||
\item service yang inactive/down,
|
||||
\item recent notes.
|
||||
\item catatan terbaru.
|
||||
\end{itemize}
|
||||
|
||||
\textbf{Langkah penggunaan:}
|
||||
\begin{enumerate}
|
||||
\item Login sebagai admin.
|
||||
\item Setelah redirect ke dashboard, periksa kartu ringkasan di bagian atas.
|
||||
\item Gunakan link area untuk membuka halaman Servers, Services, Domains, atau Notes.
|
||||
\item Setelah diarahkan ke dashboard, periksa kartu ringkasan di bagian atas.
|
||||
\item Gunakan link area untuk membuka halaman Servers, Services, Domains, atau Catatan.
|
||||
\end{enumerate}
|
||||
|
||||
\placeholderfigure{Tambahkan screenshot dashboard summary di sini.}{Dashboard Summary}
|
||||
Dashboard summary berfungsi sebagai halaman awal setelah login. Pengguna dapat langsung melihat kondisi umum inventaris sebelum masuk ke halaman CRUD masing-masing modul.
|
||||
|
||||
\uiscreenshot{screenshots/manual-dashboard.png}{Dashboard Summary Minmon}
|
||||
|
||||
\section{Mengelola Data Server}
|
||||
\textbf{Path akses:} \uipath{/dashboard/servers}
|
||||
|
|
@ -434,6 +436,10 @@ Halaman dashboard menampilkan ringkasan:
|
|||
|
||||
\textbf{Hasil yang diharapkan:} data server tersimpan dan pengguna diarahkan ke halaman detail server.
|
||||
|
||||
\uiscreenshot{screenshots/manual-servers-list.png}{Halaman Daftar Server}
|
||||
|
||||
\uiscreenshot{screenshots/manual-server-create.png}{Form Tambah Server}
|
||||
|
||||
\subsection{Melihat Detail Server}
|
||||
\textbf{Path akses:} \uipath{/dashboard/servers/\$serverId}
|
||||
|
||||
|
|
@ -442,10 +448,12 @@ Pada halaman ini pengguna dapat:
|
|||
\begin{itemize}
|
||||
\item melihat ringkasan server,
|
||||
\item mengedit data server,
|
||||
\item melihat note yang terkait dengan server tersebut.
|
||||
\item melihat catatan yang terkait dengan server tersebut.
|
||||
\end{itemize}
|
||||
|
||||
\placeholderfigure{Tambahkan screenshot detail server di sini.}{Halaman Detail Server}
|
||||
Halaman detail server menjadi pusat informasi untuk satu server tertentu karena menampilkan data utama server dan catatan yang terhubung dengan server tersebut.
|
||||
|
||||
\uiscreenshot{screenshots/manual-server-detail.png}{Halaman Detail Server}
|
||||
|
||||
\section{Mengelola Data Service}
|
||||
\textbf{Path akses:} \uipath{/dashboard/services}
|
||||
|
|
@ -454,13 +462,17 @@ Pada halaman ini pengguna dapat:
|
|||
\begin{enumerate}
|
||||
\item Buka menu Services.
|
||||
\item Klik \uibutton{Add service}.
|
||||
\item Pilih server parent pada field \textit{Server}.
|
||||
\item Isi nama service, type, port, protocol, status, dan deskripsi.
|
||||
\item Pilih server induk pada field \textit{Server}.
|
||||
\item Isi nama service, tipe, port, protokol, status, dan deskripsi.
|
||||
\item Klik \uibutton{Save service}.
|
||||
\end{enumerate}
|
||||
|
||||
\textbf{Hasil yang diharapkan:} service tersimpan dan terhubung ke server yang dipilih.
|
||||
|
||||
\uiscreenshot{screenshots/manual-services-list.png}{Halaman Daftar Service}
|
||||
|
||||
\uiscreenshot{screenshots/manual-service-create.png}{Form Tambah Service}
|
||||
|
||||
\section{Mengelola Data Domain}
|
||||
\textbf{Path akses:} \uipath{/dashboard/domains}
|
||||
|
||||
|
|
@ -468,50 +480,58 @@ Pada halaman ini pengguna dapat:
|
|||
\begin{enumerate}
|
||||
\item Buka menu Domains.
|
||||
\item Klik \uibutton{Add domain}.
|
||||
\item Pilih service parent pada field \textit{Service}.
|
||||
\item Pilih service induk pada field \textit{Service}.
|
||||
\item Isi nama domain dan expected IP bila diperlukan.
|
||||
\item Klik \uibutton{Save domain}.
|
||||
\end{enumerate}
|
||||
|
||||
\textbf{Catatan:} jika expected IP dikosongkan, backend akan menggunakan IP server parent dari service terkait.
|
||||
\textbf{Catatan:} jika expected IP dikosongkan, backend akan menggunakan IP server induk dari service terkait.
|
||||
|
||||
\uiscreenshot{screenshots/manual-domain-create.png}{Form Tambah Domain}
|
||||
|
||||
\subsection{Menjalankan DNS Check}
|
||||
\begin{enumerate}
|
||||
\item Buka halaman domain list.
|
||||
\item Tekan badge status DNS pada row domain yang ingin dicek.
|
||||
\item Tunggu proses mutation selesai.
|
||||
\item Buka halaman daftar domain.
|
||||
\item Tekan badge status DNS pada baris domain yang ingin dicek.
|
||||
\item Tunggu proses pemeriksaan selesai.
|
||||
\item Lihat hasil baru pada kolom status dan IP hasil resolve.
|
||||
\end{enumerate}
|
||||
|
||||
\textbf{Hasil yang diharapkan:} status berubah menjadi \texttt{MATCH}, \texttt{MISMATCH}, atau \texttt{UNRESOLVED}.
|
||||
|
||||
\placeholderfigure{Tambahkan screenshot domain list dan DNS check di sini.}{Domain List dan DNS Check}
|
||||
Pada halaman daftar domain, badge status DNS juga berfungsi sebagai tombol aksi. Ketika ditekan, sistem menjalankan proses pemeriksaan DNS dan memperbarui status pada baris domain tersebut.
|
||||
|
||||
\section{Mengelola Data Note}
|
||||
\uiscreenshot{screenshots/manual-domains-list.png}{Halaman Daftar Domain dan Status DNS}
|
||||
|
||||
\section{Mengelola Data Catatan}
|
||||
\textbf{Path akses:} \uipath{/dashboard/notes}
|
||||
|
||||
\subsection{Menambah Note}
|
||||
\subsection{Menambah Catatan}
|
||||
\begin{enumerate}
|
||||
\item Buka menu Notes.
|
||||
\item Klik \uibutton{New note}.
|
||||
\item Buka menu Catatan.
|
||||
\item Klik tombol tambah catatan.
|
||||
\item Pilih server pada field \textit{Server}.
|
||||
\item Isi title, category, dan content.
|
||||
\item Klik \uibutton{Save note}.
|
||||
\item Isi judul, kategori, dan isi catatan.
|
||||
\item Klik tombol simpan catatan.
|
||||
\end{enumerate}
|
||||
|
||||
\textbf{Hasil yang diharapkan:} note tersimpan dan terhubung ke server terpilih.
|
||||
\textbf{Hasil yang diharapkan:} catatan tersimpan dan terhubung ke server terpilih.
|
||||
|
||||
\subsection{Melihat Note pada Detail Server}
|
||||
\uiscreenshot{screenshots/manual-notes-list.png}{Halaman Daftar Catatan}
|
||||
|
||||
\uiscreenshot{screenshots/manual-note-create.png}{Form Tambah Catatan}
|
||||
|
||||
\subsection{Melihat Catatan pada Detail Server}
|
||||
\begin{enumerate}
|
||||
\item Buka halaman detail server.
|
||||
\item Scroll ke bagian \textit{Server notes}.
|
||||
\item Lihat daftar note yang hanya terkait dengan server tersebut.
|
||||
\item Scroll ke bagian catatan server.
|
||||
\item Lihat daftar catatan yang hanya terkait dengan server tersebut.
|
||||
\end{enumerate}
|
||||
|
||||
\textbf{Hasil yang diharapkan:} note yang tampil hanyalah note dengan \texttt{serverId} yang sesuai.
|
||||
\textbf{Hasil yang diharapkan:} catatan yang tampil hanyalah catatan dengan \texttt{serverId} yang sesuai.
|
||||
|
||||
\section{Aksi Hapus Data}
|
||||
Pada list server, service, domain, dan note, aksi hapus saat ini menggunakan alur dua langkah:
|
||||
Pada daftar server, service, domain, dan catatan, aksi hapus saat ini menggunakan alur dua langkah:
|
||||
|
||||
\begin{enumerate}
|
||||
\item Klik ikon trash.
|
||||
|
|
@ -521,7 +541,7 @@ Pada list server, service, domain, dan note, aksi hapus saat ini menggunakan alu
|
|||
|
||||
\textbf{Catatan penting:}
|
||||
\begin{itemize}
|
||||
\item Hapus server akan menghapus service, domain, dan note terkait melalui cascade delete.
|
||||
\item Hapus server akan menghapus service, domain, dan catatan terkait melalui cascade delete.
|
||||
\item Hapus service akan menghapus domain terkait melalui cascade delete.
|
||||
\end{itemize}
|
||||
|
||||
|
|
@ -529,31 +549,20 @@ Pada list server, service, domain, dan note, aksi hapus saat ini menggunakan alu
|
|||
|
||||
\section*{Kesimpulan}
|
||||
\addcontentsline{toc}{section}{Kesimpulan}
|
||||
Minmon berhasil diimplementasikan sebagai aplikasi web untuk inventaris dan monitoring ringan homelab. Sistem ini sudah mencakup autentikasi admin, dashboard summary, CRUD untuk server, service, domain, dan note, serta DNS A-record checking. Dalam konteks penggunaan homelab pribadi dengan sekitar 2 server dan banyak service/domain, aplikasi ini sudah cukup representatif untuk membantu pencatatan aset, dokumentasi operasional, dan validasi domain.
|
||||
Minmon berhasil diimplementasikan sebagai aplikasi web untuk inventaris dan monitoring ringan homelab. Sistem ini sudah mencakup autentikasi admin, ringkasan dashboard, CRUD untuk server, service, domain, dan catatan, serta pemeriksaan DNS A record. Dalam konteks penggunaan homelab pribadi dengan beberapa server dan banyak service/domain, aplikasi ini sudah cukup representatif untuk membantu pencatatan aset, dokumentasi operasional, dan validasi domain.
|
||||
|
||||
Keunggulan utama implementasi saat ini adalah struktur relasi yang jelas, form relasi berbasis select, ringkasan dashboard yang langsung informatif, serta adanya note yang bisa ditampilkan langsung pada halaman detail server. Selain itu, interaksi UI juga sudah dibuat lebih aman melalui delete dua langkah dan urutan list yang stabil.
|
||||
Keunggulan utama implementasi saat ini adalah struktur relasi yang jelas, form relasi berbasis select, ringkasan dashboard yang langsung informatif, serta adanya catatan yang bisa ditampilkan langsung pada halaman detail server. Selain itu, interaksi UI juga sudah dibuat lebih aman melalui delete dua langkah dan urutan list yang stabil.
|
||||
|
||||
\section*{Saran}
|
||||
\addcontentsline{toc}{section}{Saran}
|
||||
Saran pengembangan untuk tahap berikutnya antara lain:
|
||||
|
||||
\begin{itemize}
|
||||
\item Menambahkan fitur search, filter, dan pagination pada halaman list.
|
||||
\item Menambahkan histori hasil DNS check agar perubahan status domain dapat dilacak dari waktu ke waktu.
|
||||
\item Menambahkan fitur pencarian, filter, dan pagination pada halaman daftar data.
|
||||
\item Menambahkan histori hasil pemeriksaan DNS agar perubahan status domain dapat dilacak dari waktu ke waktu.
|
||||
\item Menambahkan multi-role authentication jika aplikasi ingin dipakai lebih dari satu pengguna.
|
||||
\item Menambahkan dukungan monitoring lain selain DNS A record, misalnya SSL expiry, ping, atau health endpoint HTTP.
|
||||
\item Menambahkan screenshot final dan diagram UML final agar dokumen ini siap dikumpulkan sebagai laporan akademik lengkap.
|
||||
\item Menambahkan dukungan monitoring lain selain DNS A record, misalnya masa berlaku SSL, ping, atau health endpoint HTTP.
|
||||
\item Menambahkan histori aktivitas agar perubahan data server, service, domain, dan catatan dapat ditelusuri lebih mudah.
|
||||
\end{itemize}
|
||||
|
||||
\begin{infobox}[title=Data yang Sebaiknya Anda Kirim Jika Ingin Saya Finalkan]
|
||||
Saya masih bisa finalkan dokumen ini lebih jauh jika Anda mengirim:
|
||||
\begin{itemize}
|
||||
\item nama, NIM, kampus, mata kuliah, dan dosen,
|
||||
\item nama asli 2 server homelab Anda,
|
||||
\item contoh service/domain nyata yang ingin dimasukkan,
|
||||
\item screenshot UI,
|
||||
\item atau file diagram UML final.
|
||||
\end{itemize}
|
||||
\end{infobox}
|
||||
|
||||
\end{document}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue