San Andreas Government Management System (eGovLS | GOV.SYS))

GOV.SYS (also called eGovLS) is a progressive web application that serves as the complete digital back-office for the San Andreas state government in a GTA roleplay server. It replaces manual paperwork and fragmented tools with a unified, browser-based portal where both citizens and government administrators can interact with the full lifecycle of government services, from submitting permit applications to tracking multi-stage budget approvals to generating official PDF documents. The system is built as a pure frontend single-page application with no custom backend server. All business logic executes in the browser, communicating directly with Backend-as-a-Service platforms: Appwrite for authentication, database, and hosting; n8n for workflow automation; and Cloudinary for file storage.

Roleplay communities rely on manual, out-of-game tools (Google Forms, Discord bots, shared spreadsheets) to simulate government administration. This creates several problems: Fragmented workflows: Citizens submit applications in one place, administrators review in another, documents are generated by hand, and notifications require manual Discord pings. No audit trail: There is no reliable record of who approved what, when budgets were allocated, or why a document was issued. Slow turnaround: Manual PDF creation, email delivery, and paper-based approval chains take hours or days, breaking immersion in a real-time roleplay environment. No role-based access: Everyone sees everything, or nothing at all. There is no granular control over who can view, approve, or edit government records. Zero transparency: Citizens have no visibility into how taxpayer money is spent or what documents are on file.

GOV.SYS solves these problems by providing a purpose-built, immersive government portal with: End-to-end intake pipeline: Multi-step forms that persist drafts in sessionStorage, accept file uploads to Cloudinary, and trigger automated document generation via n8n upon approval. Full financial lifecycle: OBR (Obligation Request) submissions with real-time MBO (Monthly Budget Obligation) cap validation, an 8-stage approval pipeline, disbursement voucher generation, and public budget transparency dashboards. Document factory: Client-side PDF generation via jsPDF for official documents (OBRs, DVs, MBO reports, payroll ledgers, citizen-issued documents) with a consistent government aesthetic. Role-based access control: 10 Appwrite teams mapped to every route, component, and admin feature, ensuring high-command users see exactly what they need. Public transparency: Public finance dashboards with MBO summaries and funding source breakdowns, searchable employee rosters, and a gazette for publishing government news with threaded comments.

Key Features Citizen-Facing City Hall Dashboard: Roleplay-immersive landing page with faction cards, government statistics, gazette previews, and attendance quick-check. Intake Forms: 8 application types (Faction Application, Business Permit, Citizen ID, City Clearance, Gun License, Police Clearance, Medical Clearance, NBI Clearance) with conditional fields, file uploads, and sessionStorage draft recovery. My Forms Portal: Track submission status, view issued documents with expiry tracking, and renew expired documents. Government Gazette: News articles with categories, tags, featured posts, content blocks, and Disqus-powered comments. Legal Document Library: Browse and download official government documents. Public Finance Transparency: Budget breakdowns with MBO summaries, funding source allocations, and interactive bar charts. Obligation Requests: Submit OBR forms with real-time validation against remaining budget caps. Attendance Portal: Duty check-in/check-out with photo proof, GPS location, and optional QR scan. Faction Onboarding: Standalone recruitment application flow for prospective employees. Public Rosters: Searchable directory of all government faction employees. Admin (Role-Protected) Admin Dashboard: 7-day trend graph, submission statistics, and quick-action toolbar. Form Queue: Review, approve, or reject intake submissions; approval triggers n8n document generation workflow. Settings Manager: Configure factions, ranks, business lines, and salary grades. Gazette Post Editor: Full CRUD for publishing government news articles. Legal Document Manager: Upload, organize, and publish downloadable government documents. Document Factory: Generate, track, renew, and revoke citizen-issued documents as PDFs. Payroll System: Salary grade management, employee profiles, duty roster views, pay period management, and payroll ledger generation. Faction Roster: Add, remove, promote, or demote members with full audit trail. Onboarding Queue: Approve or deny faction recruitment requests. Audit Logs: Filterable, infinite-scroll system-wide activity log. Finance Queue: 8-stage OBR approval pipeline (Pending, Approved, Accounting, Treasury, Disbursed, Reimbursed, plus Denied and Revision Required). MBO Configuration: Monthly Budget Obligation setup with per-funding-source caps. Allocation Ledger: Track budget utilization across all funding sources. Disbursement Panel: Issue Disbursement Vouchers against approved OBRs. Financial Pipeline The system implements a complete 8-stage budget obligation and disbursement pipeline on par with real-world government financial systems: Funding Sources: Personnel Services (PS), MOOE, Capital Outlay (CO), SPA, General Fund OBR Statuses: PENDING_OBR, APPROVED, OBO_ACCOUNTING, ACCOUNTING_APPROVED, TREASURY_PENDING, DISBURSED, REIMBURSED Generated Documents: OBR PDF, Disbursement Voucher PDF, MBO Report PDF, all rendered client-side via jsPDF with government-styled letterhead, double-border frames, signature blocks, and E-Commerce Act footer.

Technology Stack Frontend Framework: React 19, Vite 8 Styling: TailwindCSS 4 Routing: react-router-dom 7 Backend: Appwrite (Auth, Database, Hosting) Automation: n8n (PDF generation, Discord notifications, team management) File Storage: Cloudinary (uploads and transformations) PDF Generation: jsPDF 4 Comments: Disqus Testing: Vitest and jsdom PWA: Service worker, manifest, install prompt Architecture The system follows a serverless, client-heavy architecture: Browser (React SPA) - Appwrite SDK -> Appwrite Cloud API (auth, database, teams) - Cloudinary SDK -> Cloudinary (file uploads and transformations) - n8n Webhooks -> n8n on Render (documents, notifications, teams) - Disqus SDK -> Disqus (gazette comments) Demo Link: https://sanandreas.appwrite.network/