SPENDEE

Platform Penyedia Pinjaman & Evaluasi Kesehatan Keuangan untuk Startup

Features • Installation • Usage • Architecture • Contributing

SPENDEE adalah platform inovatif yang dirancang untuk mengatasi tantangan dalam dunia pendanaan startup. Solusi berbasis data yang membantu investor dan lembaga keuangan menentukan kelayakan pendanaan, sekaligus memberdayakan startup untuk meningkatkan peluang mendapatkan investasi.

• Kesulitan Penilaian: Investor dan bank kesulitan menilai kelayakan startup untuk pendanaan
• Analisis Kompleks: Proses evaluasi memerlukan analisis cermat terhadap data keuangan yang rumit
• Risiko Tinggi: Tingginya risiko kesalahan dalam keputusan pemberian pinjaman
• Akses Terbatas: Startup sulit mendapatkan pendanaan karena kurangnya transparansi dalam penilaian

• ✅ Evaluasi berbasis data untuk meminimalisir risiko kesalahan pendanaan
• ✅ Interface user-friendly yang mudah dipahami dan navigasi intuitif
• ✅ Sistem prediksi AI untuk meningkatkan akurasi keputusan investasi
• ✅ Tools komprehensif untuk startup dalam mempersiapkan proposal pendanaan

🏦 Loan Approval - Sistem penilaian otomatis berbasis AI untuk menentukan kelayakan peminjam dengan analisis mendalam terhadap profil finansial dan riwayat kredit
🚀 Eligibility Checker Startup - Platform evaluasi komprehensif yang menganalisis potensi startup berdasarkan model bisnis, tim, market validation, dan proyeksi keuangan
💼 Risk Management Consultant - AI-powered chatbot consultant yang memberikan insights strategis tentang manajemen risiko dan rekomendasi peningkatan skor kelayakan

• 📱 Responsive Design - Optimal untuk desktop dan mobile
• 🛡️ Protected Routes - Middleware-based route protection
• 🎨 Modern UI/UX - Clean interface dengan Tailwind CSS
• 📘 TypeScript - Type-safe development environment
• 🍪 Secure Sessions - Cookie-based authentication system
• ⚡ Performance Optimized - Fast loading dengan Next.js optimization

Pastikan sistem kamu sudah memiliki:

• Node.js (v18.0.0 atau lebih baru)
• Bun (recommended) / npm / yarn / pnpm
• Git untuk version control

git clone https://github.com/capstone-spendee/spendee-frontend.git
cd spendee-frontend

# Menggunakan Bun (recommended)
bun install

# Atau menggunakan npm
npm install

# Atau menggunakan yarn
yarn install

# Copy environment template
cp .env.example .env.local

# Edit file .env.local sesuai konfigurasi
nano .env.local

# Menggunakan Bun
bun dev

# Atau menggunakan npm
npm run dev

# Atau dengan auto-open browser
npm run dev --open

Aplikasi akan berjalan di http://localhost:3000

# Build untuk production
npm run build

# Preview production build
npm run preview

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

├── public/                 # Static assets (images, icons, favicon)
├── src/                   # Source code
│   ├── app/              # App Router (Next.js 14+)
│   │   ├── (auth)/       # Authentication route group
│   │   │   ├── sign-in/  # Login page & components
│   │   │   └── sign-up/  # Registration page & components
│   │   ├── api/          # API routes & endpoints
│   │   │   ├── form-feedback/  # Feedback API handlers
│   │   │   └── model/    # ML model integration
│   │   ├── components/   # Page-specific components
│   │   ├── dashboard/    # Protected dashboard area
│   │   ├── globals.css   # Global styles & Tailwind imports
│   │   ├── layout.tsx    # Root layout component
│   │   ├── not-found.tsx # Custom 404 error page
│   │   └── page.tsx      # Homepage component
│   ├── components/       # Reusable UI components
│   ├── hooks/           # Custom React hooks
│   └── lib/             # Utility functions & configurations
├── middleware.ts        # Route protection middleware
├── .env.example        # Environment variables template
├── .gitignore          # Git ignore configuration
├── package.json        # Dependencies & scripts
├── tailwind.config.js  # Tailwind CSS configuration
├── tsconfig.json       # TypeScript configuration
└── README.md           # Project documentation

Arsitektur sistem SPENDEE menunjukkan flow data dari frontend ke backend dengan integrasi AI/ML models

• Frontend Layer: Next.js dengan TypeScript untuk user interface
• API Layer: RESTful APIs untuk komunikasi data
• Authentication: Middleware-based security system
• ML Integration: Machine learning models untuk eligibility assessment
• Database: Data storage untuk user profiles dan feedback

// Login process
const handleLogin = async (credentials) => {
  const response = await fetch('/api/auth/login', {
    method: 'POST',
    body: JSON.stringify(credentials)
  });
  // Automatic redirect to dashboard
};

// Check startup eligibility
const checkEligibility = async (startupData) => {
  const result = await fetch('/api/model/eligibility', {
    method: 'POST',
    body: JSON.stringify(startupData)
  });
  return result.json();
};

// Real-time currency conversion
const convertCurrency = async (amount, from, to) => {
  const rate = await fetch(`/api/currency/${from}/${to}`);
  return amount * rate.value;
};

# Development
bun dev           # Start development server
bun build         # Build for production
bun start         # Start production server
bun lint          # Run ESLint
bun type-check    # TypeScript type checking

• ESLint: Automated code linting
• Prettier: Code formatting
• TypeScript: Static type checking
• Husky: Pre-commit hooks

Kami welcome kontribusi dari developer community!

1. Fork repository ini
2. Create feature branch (git checkout -b feature/AmazingFeature)
3. Commit perubahan (git commit -m 'Add: AmazingFeature')
4. Push ke branch (git push origin feature/AmazingFeature)
5. Open Pull Request

• Follow existing code style dan conventions
• Write clear commit messages
• Add tests untuk new features
• Update documentation jika diperlukan
• Ensure code passes all linting checks

Distributed under the MIT License. See LICENSE file for more information.

• Project Repository: GitHub - SPENDEE
• Documentation: Docs
• Issues: Report Bug
• Discussions: GitHub Discussions