🧠 Personal OS V2

Dashboard de pilotage personnel pour étudiants & entrepreneurs.

Tâches · projets · examens · finances · habits · assistant IA — en un seul endroit.

🌐 personal-os.click · 📲 Télécharger l'APK · 🎯 Roadmap · 💬 Feedback

---

📲 Essayer / Installer

Plateforme	Comment
🌐 Web (instantané)	personal-os.click
🤖 Android (APK)	Dernière release → ouvrir le .apk → autoriser l'installation
🍎 iPhone (PWA)	Safari → Partager → « Sur l'écran d'accueil »

Gratuit · fonctionne hors ligne · données synchronisées sur tous tes appareils.

---

🎯 Pourquoi Personal OS V2

Les outils existants sont fragmentés : Notion pour les notes, Todoist pour les tâches, Google Calendar pour l'agenda, Excel pour les finances, l'agenda papier pour les habitudes. Résultat : 10 apps ouvertes, contexte perdu, friction permanente.

Personal OS V2 réunit tout dans un seul tableau de bord intelligent, avec un assistant IA qui comprend ton mode (Étudiant / Entrepreneur / Hybride) et t'aide à exécuter — pas juste à lister.

Conçu pour les étudiants africains qui construisent : profil dual, contraintes budgétaires (FCFA), pas de fioritures, exécution rapide.

---

✨ Features principales

📋 Productivité

• Tâches avec ajout rapide, swipe (terminer / supprimer), filtres par projet
• Projets en vue Liste + vue Kanban (drag-and-drop)
• Habit tracker 90 jours style GitHub-graph + streaks header
• Vue Calendrier (roadmap V2.3)

🎓 Module École

• Examens avec notifications J-3 / J-1 / J-0
• Devoirs avec deadlines + estimation temps
• Plan de révision IA généré par Groq

💰 Module Finances

• Dépenses & revenus multi-devises (XOF, EUR, USD)
• Paiements adaptés au contexte africain (Wave, Orange Money, Free Money)
• Catégorisation IA automatique
• Graphique camembert par catégorie

🤖 Assistant IA (Groq)

• Conversation contextualisée (mode profil + heure)
• Actions directes : create_task, create_exam, create_idea, create_devoir, create_expense
• Streaming temps réel
• Analyse projet IA + score

🎨 UX / Design

• Design system "Neural OS" : glassmorphisme, gradients cyan→violet→or, animations spring
• Thèmes sombre + clair (orbes dynamiques en sombre, ombres vraies en clair)
• PWA avec notifications Push (Service Worker v6)
• Mobile-first responsive

---

🛠️ Stack

Couche	Tech
Framework	Next.js 16.2 (App Router, proxy.ts)
Frontend	React 19, TypeScript 5, Tailwind v4
Backend	Supabase (Postgres + Auth + RLS) — 12 tables, migrations versionnées
Sync	Moteur unifié localStorage ⇄ Supabase (pull/push différentiel, offline-first)
Auth	Supabase email/password, token Bearer pour les API routes
Emails	Resend (domaine vérifié personal-os.click)
IA	Groq SDK (Llama 3.3 70B) — assistant + génération de tâches
Notifications	Web Push VAPID + Service Worker + Cron Vercel
PWA / APK	Manifest + SW custom · APK Android (TWA, signé)
Animations	Framer Motion 12 · Icons Lucide React
Deploy	Vercel · domaine personal-os.click

---

🚀 Quick start

# 1. Cloner
git clone https://github.com/LeM2003/personal-os-v2.git
cd personal-os-v2

# 2. Installer les dépendances
npm install

# 3. Configurer les variables d'environnement
cp .env.example .env.local
# Remplir :
#   GROQ_API_KEY                    (https://console.groq.com)
#   NEXT_PUBLIC_SUPABASE_URL
#   NEXT_PUBLIC_SUPABASE_ANON_KEY
#   SUPABASE_SERVICE_ROLE_KEY

# 4. Lancer en dev
npm run dev

Ouvre http://localhost:3000.

Pré-requis

• Node.js 20+ (LTS recommandé)
• Compte Groq pour la clé API IA (gratuit)
• Compte Supabase pour le backend (gratuit jusqu'à 500 MB DB + 50k MAU)

---

📂 Architecture

personal-os-v2/
├── app/                    # Next.js App Router (pages + API routes)
│   ├── api/
│   │   ├── ai/             # Endpoints IA structurés (parse_tasks, analyze_project, weekly_report)
│   │   └── assistant/      # Streaming chat + actions IA
│   ├── page.tsx            # Dashboard principal
│   └── layout.tsx
├── components/             # UI components (cards, modals, kanban, charts)
├── context/                # React Context (theme, profile)
├── data/                   # localStorage helpers → migration Supabase en cours
├── hooks/                  # Custom hooks (useTheme, useStreak, useNotifications)
├── public/                 # PWA assets (icons, sw.js, manifest)
└── supabase/migrations/    # Migrations SQL versionnées (12 tables + RLS)

---

🎯 Roadmap

En production ✅

• V2.0 — Refonte UI + migration TypeScript complète
• V2.1 — Backend Supabase (schéma SQL complet, 12 tables + RLS)
• V2.2 — Auth Supabase (email/password + reset par email)
• V2.3 — Sync multi-appareils (tâches, dossiers, projets, dépenses)
• Notifications — Web Push VAPID (rappels matin / midi / soir)
• Distribution — PWA installable + APK Android + mode invité (essai sans compte)
• Feedback in-app — retour direct (bug / suggestion / éloge) + alerte email

À venir

• Phase C — Sync École (examens, devoirs) + abonnements/dettes/épargne → Supabase
• V2.4 — Vue Calendrier hebdo
• V3.0 — Pricing FCFA (Free / Pro étudiant / Pro entrepreneur) + lancement campus UCAD/UMEF
• V3.1 — Mode collaboratif (workspaces partagés)

Voir les issues pour le détail.

---

🤝 Feedback

Tu utilises Personal OS V2 ? Trois façons de me dire ce que tu en penses :

• Dans l'app — Réglages → « Ton retour » (bug / suggestion / éloge). Marche même sans compte.
• GitHub — ouvre une issue.
• LinkedIn — écris-moi.

Tout retour compte.

---

📝 Build in public

Ce projet est développé en transparence sur LinkedIn (#BuildInPublic). Suis l'avancée :

• Profil Mouhamadou Diouf
• Hashtag : #PersonalOS

---

⚖️ Licence

Code visible pour transparence et apprentissage. Tous droits réservés — pas de revente, pas de fork commercial sans accord. Pour collaborer : contact.

---

Construit avec ☕ et conviction à Dakar 🇸🇳 par Mouhamadou Diouf

AI Product Builder · mouhamadou-diouf.com (bientôt)