https://github.com/rvph10/nuge
Mobile application for locating nomadic food vendors
https://github.com/rvph10/nuge
fastify food-trucks postgis react-native supabase typescript
Last synced: 9 months ago
JSON representation
Mobile application for locating nomadic food vendors
- Host: GitHub
- URL: https://github.com/rvph10/nuge
- Owner: rvph10
- Created: 2025-10-08T14:50:50.000Z (9 months ago)
- Default Branch: develop
- Last Pushed: 2025-10-08T15:13:56.000Z (9 months ago)
- Last Synced: 2025-10-08T16:38:11.808Z (9 months ago)
- Topics: fastify, food-trucks, postgis, react-native, supabase, typescript
- Language: TypeScript
- Homepage:
- Size: 179 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Roadmap: docs/ROADMAP.md
Awesome Lists containing this project
README
# 🍕 Nuge
**Application mobile de localisation de vendeurs alimentaires nomades**
[](https://opensource.org/licenses/MIT)
[](https://reactnative.dev/)
[](https://www.fastify.io/)
[](https://www.postgresql.org/)
## 📖 À Propos
Nuge est une application mobile permettant aux consommateurs de localiser facilement tous les types de vendeurs alimentaires nomades (food trucks, marchands ambulants, bouchers mobiles, vendeurs de glaces, etc.) et aux vendeurs d'augmenter leur visibilité auprès de leur clientèle.
### 🎯 Problème Résolu
- **Pour les consommateurs** : Difficulté à trouver et localiser les vendeurs nomades, ne pas savoir s'ils sont ouverts
- **Pour les vendeurs** : Visibilité limitée, dépendance au bouche-à-oreille, difficulté à fidéliser
### ✨ Proposition de Valeur
- **Localisation temps réel** des vendeurs actifs
- **Notifications** quand vos vendeurs préférés sont près de vous
- **Système de commande** pour éviter les files d'attente
- **Notation et avis** pour découvrir les meilleurs vendeurs
- **Dashboard vendeurs** pour gérer position, produits et analyser performances
## 🚀 Fonctionnalités Principales
### Pour les Consommateurs
- ✅ Carte interactive avec vendeurs actifs à proximité
- ✅ Filtres avancés (type de produit, distance, note, diététique)
- ✅ Abonnement aux vendeurs préférés avec notifications push
- ✅ Système de notation et avis
- ✅ Commande à emporter (phase 2)
- ✅ Historique et favoris
### Pour les Vendeurs
- ✅ Publication manuelle de position une fois installé
- ✅ Gestion de statut (actif/inactif)
- ✅ Catalogue produits avec photos
- ✅ Stories éphémères (promotions, nouveautés)
- ✅ Analytics démographiques clients
- ✅ Dashboard de performance
## 🏗️ Architecture Technique
### Stack
- **Frontend** : React Native + Expo
- **Backend** : Node.js + Fastify + TypeScript
- **Database** : PostgreSQL 16 + PostGIS (Supabase)
- **Auth** : Supabase Auth (JWT)
- **Storage** : Supabase Storage (photos vendeurs/produits)
- **Hosting** : Railway (backend) + Supabase (database)
- **Push Notifications** : Expo Push Notifications
## 📚 Documentation
- [**Architecture Technique**](./docs/ARCHITECTURE.md) - Détails complets de l'architecture
- [**Stack Technique**](./docs/TECH_STACK.md) - Justifications et comparaisons
- [**Analyse Marché**](./docs/MARKET_ANALYSIS.md) - Validation et insights
- [**Roadmap**](./docs/ROADMAP.md) - Plan de développement
## 🚦 Roadmap
### Phase 1 : MVP
- ✅ Carte avec vendeurs actifs
- ✅ Publication position vendeurs
- ✅ Système de notation basique
- ✅ Auth utilisateurs/vendeurs
- 🔄 Profils et favoris
### Phase 2 : Growth
- ⏳ Commandes à emporter
- ⏳ Stories vendeurs éphémères
- ⏳ Notifications intelligentes
- ⏳ Programme de fidélité
### Phase 3 : Scale
- ⏳ Analytics avancées vendeurs
- ⏳ Réservation pour événements privés
- ⏳ Expansion multi-villes
- ⏳ API publique pour partenaires
## 📊 Métriques de Succès
### KPIs Phase MVP
- **10-20 vendeurs** actifs à Bruxelles
- **500+ utilisateurs** actifs/mois
- **70%+ vendeurs** publient position ≥2x/semaine
- **30%+ utilisateurs** ouvrent app ≥2x/semaine
- **NPS > 40**
## 📈 Validation Marché
Basé sur **55 réponses** de notre enquête terrain à Bruxelles :
- ✅ **80% intéressés** par l'application
- ✅ **93% considéreraient** food trucks vs fast food si faciles à trouver
- ✅ **49% trouvent** les vendeurs par hasard actuellement
- ✅ **29% ont du mal** à localiser les vendeurs
- ✅ **0% utilisent** des apps dédiées (marché vierge)
[Voir analyse complète](./docs/MARKET_ANALYSIS.md)
## 💰 Modèle Économique
### Revenus Prévus
- **Commission** : 8-10% sur commandes via app
- **Abonnement vendeurs** : 20-40€/mois (premium features)
- **Services B2B** : Réservation événements privés (100-500€)
### Coûts Estimés
```
MVP (0-500 users) : 0-15€/mois
Growth (500-5k users) : 50-150€/mois
Scale (5k-50k users) : 300-800€/mois
```
## 🤝 Contribution
Contributions, issues et feature requests sont les bienvenues !
1. Fork le projet
2. Crée ta feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit tes changements (`git commit -m 'Add some AmazingFeature'`)
4. Push sur la branch (`git push origin feature/AmazingFeature`)
5. Ouvre une Pull Request
## 📝 License
Ce projet est sous licence MIT. Voir le fichier `LICENSE` pour plus de détails.
## 👥 Équipe
- **Fondateur** : rvph
- **Repo** : https://github.com/rvph10/nuge
- **Contact** : rvph@upintown.dev
---
**⭐ Si ce projet vous intéresse, n'hésitez pas à le star !**