🤖 Isbar-Si AI — Website-ka AI Chatbots & Courses

📋 Waxa Website-ku Leeyahay

🛠️ Tignoolajiyada La Isticmaalay (Tech Stack)

🚀 Sida Loo Install Gareeyo (Local Development)

1. Shuruudaha (Prerequisites)

Hubi in kuwan ku jiraan nidaamkaaga:

• Node.js v18 ama ka sarreeya → nodejs.org
• npm ama pnpm → npm install -g pnpm
• Git → git-scm.com

2. Clone-garee Repo-ga

git clone https://github.com/Faratoon/isbar-si-ai.git
cd isbar-si-ai

3. Install Dependencies

npm install

4. Habeynta Environment Variables

Samee file .env oo ku jirta root directory-ga:

# Database (TiDB / MySQL)
DATABASE_URL=mysql://user:password@host:4000/dbname?ssl={"rejectUnauthorized":true}

# Manus OAuth (Authentication)
MANUS_CLIENT_ID=your_manus_client_id
MANUS_CLIENT_SECRET=your_manus_client_secret
MANUS_REDIRECT_URI=http://localhost:3001/auth/callback

# Session Secret
SESSION_SECRET=your_random_secret_key_here

# LLM (Built-in Manus LLM)
OPENAI_API_KEY=your_openai_api_key
OPENAI_API_BASE=https://api.openai.com/v1

⚠️ Xusuusin: .env file-ka weligaa GitHub ku push garinayso — wuxuu ku jiraa .gitignore.

5. Bilow Development Server-ka

npm run dev

Website-ka wuxuu furmayaa: http://localhost:3001

🏗️ Sida Loo Build Gareeyo (Production Build)

npm run build

Build-ka wuxuu abuuraa:

• dist/public/ — Frontend files (HTML, CSS, JS)
• dist/index.js — Backend server bundle

Xusuusin: Haddii RAM-ka computerkaagu yar yahay (< 1GB), build-ka ku samee computer kale oo RAM badan leh, ka dibna copy-garee dist/ folder-ka server-ka.

🌐 Sida Loo Deploy Gareeyo (VPS Deployment)

Shuruudaha VPS-ka

• Ubuntu 20.04+
• Node.js v18+
• PM2: npm install -g pm2
• Nginx

Tallaabada 1: Build-garee

npm run build
tar czf dist.tar.gz dist

Tallaabada 2: Copy-garee VPS-ka

scp dist.tar.gz ubuntu@your-server-ip:~/isbar-si-ai/
ssh ubuntu@your-server-ip
cd ~/isbar-si-ai && tar xzf dist.tar.gz

Tallaabada 3: PM2 ku Bilow

pm2 start ecosystem.config.cjs
pm2 save
pm2 startup

Tallaabada 4: Nginx Config

server {
    listen 80;
    server_name isbar-si.com www.isbar-si.com;

    location / {
        proxy_pass http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

sudo nginx -t && sudo systemctl reload nginx

Tallaabada 5: Domain DNS

DNS-ka domain-kaaga u habeey sidan:

A  @    →  your-server-ip
A  www  →  your-server-ip

📁 Qaab-dhismeedka Mashruuca (Project Structure)

isbar-si-ai/
├── client/
│   ├── src/
│   │   ├── components/           # UI Components
│   │   │   ├── Navbar.tsx        # Navigation bar
│   │   │   ├── ChatbotPopup.tsx  # AI popup (4s auto-open)
│   │   │   ├── AIChatBox.tsx     # Chat UI component
│   │   │   ├── WeekIcon.tsx      # Icon helper
│   │   │   └── ui/               # shadcn/ui components
│   │   ├── pages/                # Bogagga website-ka
│   │   │   ├── Home.tsx          # Landing page
│   │   │   ├── Courses.tsx       # Koorsooyinka catalog
│   │   │   ├── CourseDetail.tsx  # Casharrada koorso kasta
│   │   │   ├── PrivateFasal.tsx  # Fasal Gaar ah
│   │   │   ├── Booking.tsx       # Ballan Online
│   │   │   ├── Chat.tsx          # AI Chat page
│   │   │   └── KnowledgeBase.tsx # Knowledge Base
│   │   ├── data/
│   │   │   ├── courses.ts        # Xogta 4-ta koorso
│   │   │   └── course.ts         # Knowledge Base data
│   │   └── App.tsx               # Routes & layout
│   └── index.html
├── server/
│   ├── _core/                    # tRPC, Auth, LLM helpers
│   ├── routers/
│   │   ├── chat.ts               # AI Chat router (system prompt)
│   │   └── ...
│   └── routers.ts                # Main router composition
├── drizzle/
│   └── schema.ts                 # Database schema
├── all-koorso.json               # Xogta koorsooyinka (JSON source)
├── ecosystem.config.cjs          # PM2 config
├── vite.config.ts                # Vite build config
└── package.json

📚 Koorsooyinka (4 Courses)

1. 🎥 40 Cashar AI (YouTube)

• 40 cashar oo ku saabsan AI, Chatbots, ManyChat, Botpress, Telegram Bots, Prompts, Canva AI, VEO 3, Linux, iyo qalab kale
• Platform: YouTube

2. 🎬 AI Video Editing (Loom)

• 9 cashar oo ku saabsan AI Video Editing: InVideo, Pictory.ai, Lumen5
• Platform: Loom

3. 🛒 Dropshipping iyo Zendrop AI

• 10 cashar oo ku saabsan Zendrop, Telegram AI bots ganacsi, AI automation
• Platform: Loom

4. 🌐 Resources & Community

• 9 link oo toos ah: WhatsApp groups, Telegram channels, YouTube, Facebook, Substack

Sida loo helo casharrada: Buuxi foomka diiwaangelinta — links-ka casharrada ayaa laguugu soo diri doonaa email ahaan.

🌙 Fasal Gaar ah (Private Classes)

Jadwalka fasalada gaarka ah — Jimce & Sabti, Waqtiga Geeska Afrika (EAT):

🤖 AI Chatbot Popup

• Wuxuu si toos ah u soo baxaa 4 seconds kaddib marka qofku website-ka soo galo
• Wuxuu ku salaaminayaa Af-Soomaali: "Soo dhawoow! Wax ma kaa caawin karaa?"
• Wuxuu ka jawaabaa su'aalaha AI, chatbots, koorsooyinka, iyo qorista basic-ka ah
• Wuxuu u diraa foomka diiwaangelinta marka qofku koorsooyinka weydiisto

🔗 Xiriirrada Muhiimka ah

🛠️ Amarka PM2 ee Muhiimka ah

# Xaaladda app-ka
pm2 status

# Dib u bilow
pm2 restart horn-music-app

# Logs
pm2 logs horn-music-app

# Jooji
pm2 stop horn-music-app

# Kaydi xaaladda
pm2 save

🤝 Sida Loo Wax ka Bedelo (Contributing)

1. Fork-garee repo-ga
2. Samee branch cusub: git checkout -b feature/magac-feature
3. Wax ka bedel oo commit-garee: git commit -m "feat: sharaxaad kooban"
4. Push-garee: git push origin feature/magac-feature
5. Pull Request fur

📄 Ruqsadda (License)

© 2025 isbar-si.com — Faratoon. Dhammaan xuquuqdu way xifdisan tahay.

👨‍💻 Macallinka

Faratoon — AI & Technology Educator

• 📺 YouTube: MrFaraton
• 📱 Telegram: @Farsamada
• 📰 Substack: mfaratoon.substack.com
• 📘 Facebook: Soomaali Podcast