v-va*

← return to the collection

09 · web application

rukun

administration for an indonesian neighborhood (rt)

civic platform · community management


artist
fazza abiyyu
date
2025
role
fullstack developer & quality assurance
medium
Nuxt.js · Prisma ORM · MySQL · Nitro
status
archived

statement

A digital platform designed to streamline administrative tasks for neighborhood units (RT). It automates citizen data management, family card tracking, and official letter generation while providing a transparent financial monitoring system.

  • schema database design for residents, dues, and document requests.
  • services restful apis with authentication & authorization on nitro + prisma.
  • assurance test cases, manual testing, documented system architecture.
  • preservation deployment retired; preserved here with its documentation.
10+ functional requirements
4 uml diagrams
8 tech components
Audit trail system

the problem

administrative inefficiency

Traditional RT management relies on manual record-keeping, leading to slow document processing, difficulty in tracking citizen demographics, and a lack of transparency in neighborhood financial reports.

the answer

automated management platform

Rukun automates the entire workflow from citizen registration to letter generation. It features secure JWT-based authentication, interactive financial dashboards, and a comprehensive audit trail for all administrative actions.

exhibited artifact

fig. i — resident ledger · prisma schema study
fig. i — resident ledger · prisma schema study

requirements analysis

functional requirements

coderequirementdescription
FR-01Citizen ManagementAdd, edit, and view citizen data and family card (KK) structures
FR-02Letter AutomationAutomatic generation of administrative letters (Surat Pengantar, etc.)
FR-03Financial TrackingReal-time logging of income and expenses (Cash Flow)
FR-04Interactive DashboardVisual analytics for population statistics and financial summaries
FR-05Secure AuthJWT-based authentication with short-lived access and long-lived refresh tokens
FR-06Audit TrailDetailed system logs tracking all Create, Update, and Delete interactions
FR-07Notification SystemAutomated alerts for administrative updates and financial transactions
FR-08Role-based AccessSpecific permissions for Admin, RT Chairman, and Residents
FR-09Data ExportGenerate PDF reports for financial and citizen data
FR-10Profile ManagementManage individual user credentials and contact information

system design — uml plates

drawings & diagrams

system architecture — client · api layer · database
plate i — system architecture — client · api layer · database
use case diagram — actors and system use cases
plate ii — use case diagram — actors and system use cases
class diagram — entity relationships
plate iii — class diagram — entity relationships
sequence diagram — resident registration flow
plate iv — sequence diagram — resident registration flow

materials list

technical inventory

language TypeScript
framework Nuxt 3 (Universal)
styling Tailwind + Preline UI
database MySQL
orm Prisma
auth JWT (Access/Refresh)
api RESTful API (Nitro)
deployment Vercel (Serverless)