GitHub - mhaatha/kivo-api: Kivo membantu Anda menemukan ide bisnis yang potensial dan menilai apakah ide tersebut layak bertahan. Platform ini juga menghasilkan Business Model Canvas otomatis sebagai strategi awal agar bisnis lebih siap dan kuat.

Menciptakan strategi untuk bisnismu!

Watch Demo »

About | How to Run

💡 Mengapa Kivo?

Memulai bisnis adalah pertaruhan besar. Tanpa data yang tepat, ide brilian sekalipun bisa gagal di tengah jalan.

😟 Masalah

Banyak founder dan calon pengusaha terjebak dalam situasi ini:

❌ Decision Paralysis: Terlalu banyak keraguan (hesitation) untuk melangkah karena takut salah mengambil keputusan.
❌ Risiko Kegagalan Tinggi: Membangun produk yang didasarkan pada asumsi semata, bukan kebutuhan pasar yang valid.
❌ Strategi yang Abstrak: Memiliki ide di kepala tetapi kesulitan menurunkannya menjadi model bisnis yang konkret dan terstruktur.

😃 Solusi Kami

Kivo hadir sebagai platform validasi cerdas untuk mengubah keraguan menjadi keyakinan berbasis data:

✅ Pre-Launch Validation: Kami memvalidasi konsep bisnis Anda sebelum satu baris kode ditulis atau biaya dikeluarkan.
✅ Data-Driven Predictions: Menggunakan prediksi pasar berbasis data untuk memastikan ide Anda relevan hari ini dan future-proof untuk masa depan.
✅ Structured Business Model: Menghasilkan Business Model Canvas (BMC) yang solid secara otomatis untuk mempertajam strategi eksekusi Anda.

📋 Prerequisites

Pastikan Anda telah menginstal:

Node.js (Gunakan versi LTS terbaru)
Docker & Docker Compose
Git
Mongosh

🏗️ Installation & Setup

1. Clone Repository

git clone https://github.com/mhaatha/kivo-api.git
cd kivo-api

2. Install Dependencies

npm install

3. Setup Environment

Copy file .env.example ke .env:

cp .env.example .env

Edit file .env dan isi variabel berikut:

# Express Server Configuration
PORT=5000

# MongoDB Connection
MONGODB_URI=your_mongodb_uri

# Clerk Authentication (diperlukan untuk auth)
CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
CLERK_WEBHOOK_SIGNING_SECRET=your_clerk_webhook_secret

# Frontend URLs (untuk CORS)
FRONTEND_URL1=https://kivoai.netlify.app

# Kolosal AI API Configuration
KOLOSAL_API_ENDPOINT=https://api.kolosal.example.com
KOLOSAL_API_KEY=your_kolosal_api_key

# JWT Configuration
JWT_SECRET=your_super_secret_jwt_key

# OpenRouter API Key (untuk AI chat)
OPENROUTER_API_KEY=your_openrouter_api_key

# Supermemory API Key (untuk AI memory)
SUPERMEMORY_API_KEY=your_supermemory_api_key

🐳 Menjalankan MongoDB dengan Docker

Kivo memerlukan MongoDB untuk menyimpan data. Jalankan dengan Docker Compose:

docker-compose up -d

Perintah ini akan:

Menjalankan MongoDB di port 27017
Membuat volume data persisten untuk MongoDB
Menggunakan replica set untuk performa yang lebih baik

Setelah container berjalan, jalankan perintah berikut ntuk mengaktifkan fitur transaction:

docker exec -it kivo-mongo mongosh --eval "rs.initiate({ _id: 'rs0', members: [{ _id: 0, host: 'localhost:27017' }] })"

Jika output menampilkan { "ok" : 1 }, berarti fitur transaksi berhasi dijalankan.

Untuk menghentikan MongoDB:

docker-compose down

🚀 Menjalankan Aplikasi

Mode Development (dengan auto-reload)

npm run dev

Mode Production

npm start

Server akan berjalan di http://localhost:5000 (atau port yang Anda tentukan di .env)

🔍 Testing

Jalankan Semua Tests

npm test

Jalankan Tests dengan Watch Mode

npm run test:watch

Jalankan Tests dengan Coverage Report

npm run test:coverage

Jalankan Integration Tests

npm run test:integration

Jalankan AI-powered Tests (jika tersedia)

npm run test:ai

📝 API Documentation

API documentation tersedia di file OpenAPI:

OpenAPI Spec: api/v1.0.yaml

Untuk melihat route yang tersedia:

npm run route:list

🛠️ Core Features & Routes

Authentication (Clerk)

POST /api/v1/auth/* - Authentication endpoints

Business Model Canvas

POST /api/v1/bmc/bmc-routes - BMC operations
POST /api/bmc/bmc-routes - Alternative BMC endpoint

Database Management

GET /api/v1/databases - Database operations

AI Chat

POST /api/chat - AI chat untuk konsultasi bisnis
GET /api/chats/:id - Mengambil history chat

Protected Routes

GET /api/v1/protected/* - Protected endpoints yang memerlukan authentication

📊 Environment Variables

Variable	Description	Example
`PORT`	Port untuk Express server	`3000`
`MONGODB_URI`	MongoDB connection string	`mongodb://localhost:27017/kivo`
`CLERK_PUBLISHABLE_KEY`	Clerk publishable key - needed untuk authentication	`pk_test_***`
`CLERK_SECRET_KEY`	Clerk secret key - needed untuk authentication	`sk_test_***`
`CLERK_WEBHOOK_SIGNING_SECRET`	Clerk webhook secret - needed untuk auth webhooks	`whsec_***`
`FRONTEND_URL1`	Frontend URL untuk CORS	`https://kivoai.netlify.app`
`KOLOSAL_API_ENDPOINT`	Kolosal AI API endpoint - needed untuk AI features	`https://api.kolosal.example.com`
`KOLOSAL_API_KEY`	Kolosal AI API key - needed untuk AI features	`your_kolosal_api_key`
`JWT_SECRET`	Secret key untuk JWT tokens - needed untuk authentication	`your_super_secret_jwt_key`
`OPENROUTER_API_KEY`	OpenRouter API key - needed untuk chat AI	`your_openrouter_api_key`
`SUPERMEMORY_API_KEY`	Supermemory API key - needed untuk AI memory	`your_supermemory_api_key`

Catatan Penting: Semua variabel di atas adalah WAJIB diisi untuk menjaga kemananan dan kelengkapan aplikasi, meskipun beberapa fungsi fitur mungkin tidak berjalan jika value-nya dikosongkan.

Bagaimana Setiap Env Bekerja Jika Dikosongkan:

PORT - HARUS ada, aplikasi error jika kosong
MONGODB_URI - HARUS ada, aplikasi error jika kosong
CLERK_* - Aplikasi tetap jalan tanpa auth features
FRONTEND_URL1 - CORS tidak akan aktif, frontend access akan error dari origin di luar localhost
KOLOSAL_* - AI features yang menggunakan Kolosal AI tidak akan aktif
JWT_SECRET - Auth features yang pakai JWT tidak akan jalan
OPENROUTER_API_KEY - Chat AI tidak akan aktif
SUPERMEMORY_API_KEY - AI memory features tidak akan aktif

⚡ API Keys Configuration

Untuk mendapatkan API keys, ikuti panduan berikut:

1. Clerk Authentication:

Buat akun di https://clerk.com
Ambil Publishable Key & Secret Key dari dashboard
Setup webhook dan dapatkan Webhook Signing Secret

2. OpenRouter AI (Untuk chat AI):

Daftar di https://openrouter.ai
Buat API key di dashboard

3. Supermemory AI (Untuk AI memory):

Daftar di https://supermemory.ai
Buat API key untuk fitur memory AI

4. Kolosal AI (Untuk AI processing):

Dapatkan akses ke Kolosal AI API
Masukkan endpoint dan API key sesuai provider

🔄 Development Workflow

Setup Environment - Selesaikan konfigurasi .env
Jalankan MongoDB - docker-compose up -d
Aktifkan fitur transaction - docker exec -it kivo-mongo mongosh --eval "rs.initiate({ _id: 'rs0', members: [{ _id: 0, host: 'localhost:27017' }] })"
Install Dependencies - npm install
Development Mode - npm run dev
Testing - npm run test:watch
Build & Deploy - Proses deployment ke production

🚨 Troublehooting

MongoDB Connection Error

Pastikan MongoDB berjalan: docker ps
Cek logs: docker logs kivo-mongo
Restart MongoDB: docker-compose restart

AI Features Error

Pastikan OPENROUTER_API_KEY dan SUPERMEMORY_API_KEY terisi untuk fitur AI chat
Verifikasi KOLOSAL_API_ENDPOINT dan KOLOSAL_API_KEY jika AI tidak merespons

Clerk Authentication Error

Pastikan semua CLERK_* environment variables terisi jika ingin menggunakan auth features

CORS Error

Pastikan FRONTEND_URL1 sesuai dengan URL frontend Anda

Dependencies Error

Hapus node_modules dan install ulang: rm -rf node_modules && npm install

Dependencies Error

Hapus node_modules dan install ulang: rm -rf node_modules && npm install

📁 Project Structure

kivo-api/
├── api/                    # OpenAPI documentation
├── src/
│   ├── app/               # Core application code
│   │   ├── ai/           # AI chat functionality
│   │   ├── config/       # Application configuration
│   │   ├── controllers/  # Request handlers
│   │   ├── middlewares/  # Express middlewares
│   │   ├── models/       # Mongoose models
│   │   ├── repositories/ # Data access layer
│   │   ├── services/     # Business logic
│   │   ├── utils/        # Utility functions
│   │   ├── validations/  # Validation schemas
│   │   └── routes/       # API route definitions
│   ├── scripts/         # Utility scripts
│   ├── types/            # TypeScript definitions
│   └── server.js         # Application entry point
├── tests/                 # Test files
├── docker-compose.yaml   # Docker configuration
└── vitest.config.js      # Test configuration

📞 Support

Jika mengalami masalah:

Cek logs aplikasi untuk error messages
Pastikan semua environment variables terisi dengan benar
Verifikasi koneksi MongoDB dan Clerk configuration

Name		Name	Last commit message	Last commit date
Latest commit History 155 Commits
api		api
src		src
tests		tests
.env.example		.env.example
.gitignore		.gitignore
.prettierrc		.prettierrc
README.md		README.md
docker-compose.yaml		docker-compose.yaml
package-lock.json		package-lock.json
package.json		package.json
vitest.config.js		vitest.config.js

mhaatha/kivo-api

Folders and files

Latest commit

History

Repository files navigation

Menciptakan strategi untuk bisnismu!

💡 Mengapa Kivo?

😟 Masalah

😃 Solusi Kami

📋 Prerequisites

🏗️ Installation & Setup

1. Clone Repository

2. Install Dependencies

3. Setup Environment

🐳 Menjalankan MongoDB dengan Docker

🚀 Menjalankan Aplikasi

Mode Development (dengan auto-reload)

Mode Production

🔍 Testing

Jalankan Semua Tests

Jalankan Tests dengan Watch Mode

Jalankan Tests dengan Coverage Report

Jalankan Integration Tests

Jalankan AI-powered Tests (jika tersedia)

📝 API Documentation

🛠️ Core Features & Routes

Authentication (Clerk)

Business Model Canvas

Database Management

AI Chat

Protected Routes

📊 Environment Variables

⚡ API Keys Configuration

🔄 Development Workflow

🚨 Troublehooting

MongoDB Connection Error

AI Features Error

Clerk Authentication Error

CORS Error

Dependencies Error

Dependencies Error

📁 Project Structure

📞 Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 5

Uh oh!

Languages

Packages