mrzinson/darkpen

Appka Badali Lahaa Ai-yo Badan Oo Manta Jira # Darkpen — Kaaliyaha Waxbarashada ee AI (Somali AI Study Assistant) Darkpen waa kaaliye waxbarasho oo ku shaqeeya sirdoonka macmalka ah (AI), kaas oo loogu talagalay ardayda Soomaaliyeed. App-ku wuxuu u sahlayaa ardayda inay la sheekaystaan AI si ay su'aalaha uga caawiso, dib-u-eegis ku sameeyaan imtixaanadii hore, akhriyaan buugaagta manhajka, oo ay ku xidhmaan bahdooda waxbarasho (wada-sheekaysiga kooxaha). Mashruucan wuxuu ka kooban yahay dhowr qaybood oo wada shaqaynaya: 1. **Backend API**: Node.js & Express (oo leh MySQL, Socket.io, iyo AI API integraions). 2. **Mobile App**: React Native & Expo (SDK 57) oo loogu talagalay ardayda. 3. **Admin Dashboard**: React (v19) & Vite (oo loogu talagalay maamulayaasha). 4. **Web App**: Next.js (v16) oo loogu talagalay bogga internetka ee rasmiga ah. --- ## 📁 Qaab-dhismeedka Mashruuca (Project Structure) ```text darkpen-main/ ├── backend/ # Server-ka dhexe (REST API, Socket.io, iyo Migrations) ├── mobile-app/ # App-ka mobilada (React Native / Expo) ├── admin-dashboard/ # Dashboard-ka maamulayaasha (React / Vite) ├── darkpen-web/ # Bogga rasmiga ah ee internetka (Next.js) └── privacy-policy/ # Bogga shuruucda ilaalinta xogta (HTML) ``` --- ## 🛠️ Framework-yada & Tiknoolajiyada la Isticmaalay ### 1. Mobile App (Expo) - **Framework**: React Native (Expo SDK 57) & TypeScript. - **Navigation**: Expo Router (File-based routing). - **Astaamaha Muhiimka ah**: - `expo-secure-store` (Halkii lagu kaydin lahaa JWT token si ammaan ah). - `expo-notifications` (Ogeysiisyada tooska ah - Push Notifications). - `expo-image-picker` & `expo-font` (Maamulka sawirada iyo farta Inter/Poppins). ### 2. Backend (API Server) - **Runtime**: Node.js oo leh Express Framework. - **Database**: MySQL (iyadoo la isticmaalayo `mysql2` pool connection, oo leh pings keep-alive iyo dib-u-isku-day toos ah). - **Real-time Engine**: Socket.io (Wada-sheekaysiga tooska ah ee kooxaha iyo AI). - **AI Integrations**: Goo …