Skip to content

NexusFlow: Enterprise Inventory System with Internal Control & AI. A robust ERP built with Next.js 14, TypeScript & Prisma.

Notifications You must be signed in to change notification settings

shinerking/nexusflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

20 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NEXUS FLOW

Enterprise Inventory System with Internal Control & AI


Vercel Deployment Next.js Database AI Integration

Secure β€’ Smart β€’ Scalable



πŸ“– Tentang NexusFlow

NexusFlow adalah solusi Enterprise Resource Planning (ERP) modern yang dirancang untuk menjaga integritas aset perusahaan. Dibangun dengan filosofi "Internal Control", NexusFlow mentransformasi cara perusahaan mengelola gudang dengan mencegah kecurangan (fraud) dan kesalahan manusia (human error).

Berbeda dengan aplikasi inventaris biasa, NexusFlow menerapkan Sistem Maker-Checker, di mana setiap perubahan data sensitif harus melalui validasi bertingkat sebelum mempengaruhi stok fisik.

🎯 Mengapa NexusFlow?

  • πŸ›‘οΈ Maker-Checker Workflow - Input dari Staff tidak mengubah stok langsung, melainkan masuk ke antrean persetujuan Manager.
  • πŸ” Role-Based Security (RBAC) - Pemisahan akses data yang ketat. Staff operasional tidak dapat melihat data finansial sensitif.
  • πŸ€– AI-Powered Analytics - Analisis otomatis menggunakan Google Gemini AI untuk mendeteksi anomali dan rekomendasi stok.
  • ⚑ Real-time Experience - Notifikasi instan dan pembaruan status tanpa page reload.

✨ Fitur Utama

πŸ›‘οΈ Keamanan & Kontrol (Enterprise Grade)

  • Role-Based Access Control: Hak akses spesifik untuk Manager (Full Access), Staff (Operational), dan Auditor (Read-Only).
  • Approval Queue System: Mekanisme "Pending Review" untuk setiap penambahan atau pengurangan stok (Adjustment).
  • Audit Trail (Log): Pencatatan riwayat aktivitas yang permanen dan transparan (Siapa, Kapan, Mengapa).

⚑ Produktivitas & UX

  • Real-time Notifications: Integrasi Sonner (Toast) dan Email Alert untuk pemberitahuan instan kepada Manager.
  • Interactive Dashboard: Visualisasi nilai aset, grafik tren stok, dan peringatan Low Stock secara real-time.
  • Custom Modals: Antarmuka persetujuan modern dengan fitur input alasan penolakan (Rejection Reason).
  • Staff History: Halaman khusus bagi staff untuk memantau status pengajuan mereka dan ringkasan kinerja mingguan.

πŸ“Š Manajemen Data Cerdas

  • AI Analytics: Integrasi Google Gemini untuk memberikan insight pengadaan barang.
  • Smart Sorting & Filtering: Navigasi ribuan data inventaris dengan mudah.
  • Import/Export: Dukungan penuh untuk Import Excel dan Export Laporan PDF/Excel.

πŸ› οΈ Tech Stack

Frontend

Backend & Database


πŸ“¦ Instalasi

Prasyarat

Pastikan Anda telah menginstall:

  • Node.js (v18+)
  • Git
  • PostgreSQL Database (Local atau Cloud seperti Supabase/Neon)

Langkah-langkah

1️⃣ Clone Repository

git clone [https://github.com/shinerking/nexusflow.git](https://github.com/shinerking/nexusflow.git)
cd nexusflow

2️⃣ Install Dependencies

npm install
# atau
yarn install

3️⃣ Setup Environment Variables

Buat file .env di root project dan isi konfigurasi berikut:

# Database (Supabase/Postgres)
DATABASE_URL="postgresql://user:password@host:5432/postgres?pgbouncer=true"
DIRECT_URL="postgresql://user:password@host:5432/postgres"

# Authentication & Security
NEXTAUTH_SECRET="rahasia_dapur_nexusflow"
NEXTAUTH_URL="http://localhost:3000"

# AI & Services
GEMINI_API_KEY="your_gemini_api_key"
RESEND_API_KEY="your_resend_api_key"

# Email Config
NOTIFICATION_EMAIL="admin@nexusflow.com"

4️⃣ Setup Database

# Generate Prisma Client
npx prisma generate

# Push schema ke database
npx prisma migrate dev

# (Opsional) Isi data dummy untuk testing
npx prisma db seed

5️⃣ Jalankan Server

npm run dev

Buka browser dan akses http://localhost:3000 πŸŽ‰


πŸ‘₯ Akun Demo (Seeding)

Gunakan kredensial ini untuk mencoba berbagai fitur berdasarkan role:

Role Email Password Fitur yang Bisa Diakses
πŸ‘‘ Manager manager@nexusflow.com password123 Full Access, Approvals, Analytics, User Mgmt.
πŸ‘· Staff staff@nexusflow.com password123 Request Stock, History, No Financial Data.
πŸ” Auditor auditor@nexusflow.com password123 Read-Only Logs & Reports.

πŸ“Έ Galeri Tampilan (Screenshots)

Berikut adalah tampilan antarmuka NexusFlow yang dirancang dengan mode gelap (Dark Mode) untuk kenyamanan visual dan nuansa profesional.

1. Manager Dashboard (Executive View)

Pusat kendali utama bagi Manager. Menampilkan data krusial seperti Total Asset Value, Revenue, dan grafik tren stok. Manager Dashboard

Dashboard Manager memiliki akses penuh ke data finansial dan statistik global.

2. Approval Workflow (Maker-Checker System)

Fitur unggulan NexusFlow. Setiap perubahan stok yang dilakukan Staff masuk ke antrean ini. Manager dapat melihat detail, menyetujui, atau menolak dengan Alasan Penolakan (Rejection Reason). Approval Modal

Modal konfirmasi kustom dengan fitur input alasan penolakan untuk audit trail.

3. Staff View (Restricted Access)

Tampilan khusus Staff Gudang. Perhatikan bahwa kartu Revenue dan Total Value disembunyikan secara otomatis demi keamanan data perusahaan (Role-Based Access Control). Staff Dashboard

Antarmuka Staff yang bersih, fokus pada operasional tanpa akses ke data sensitif.

4. Staff History & Weekly Summary

Halaman transparansi bagi Staff untuk memantau status pengajuan mereka (Approved/Rejected) serta melihat ringkasan kinerja mingguan mereka. Staff History

Staff dapat belajar dari kesalahan melalui catatan penolakan yang tertera di history.



πŸ“ Struktur Project

nexusflow/
β”œβ”€β”€ prisma/
β”‚   └── schema.prisma      # Database Schema & Models
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ actions/       # Server Actions (Backend Logic)
β”‚   β”‚   β”œβ”€β”€ api/           # API Routes
β”‚   β”‚   β”œβ”€β”€ (dashboard)/   # Protected Routes
β”‚   β”‚   └── layout.tsx     # Root Layout
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ui/            # Shadcn UI Components
β”‚   β”‚   β”œβ”€β”€ dashboard/     # Charts & Stats Cards
β”‚   β”‚   └── modals/        # Approval/Reject Modals
β”‚   └── lib/
β”‚       β”œβ”€β”€ db.ts          # Prisma Client Singleton
β”‚       └── gemini.ts      # AI Configuration
└── public/                # Static Assets


🀝 Kontribusi

Kontribusi selalu diterima! Jika Anda ingin berkontribusi:

  1. Fork repository ini
  2. Buat branch baru (git checkout -b feature/FiturBaru)
  3. Commit perubahan (git commit -m 'Add fitur baru')
  4. Push ke branch (git push origin feature/FiturBaru)
  5. Buat Pull Request

πŸ‘¨β€πŸ’» Developer

Dibuat dengan ❀️ oleh Abimanyu R Putra


⭐ Jangan lupa beri star pada repository ini jika bermanfaat! ⭐

Made by ARP