164 lines
3.5 KiB
Markdown
164 lines
3.5 KiB
Markdown
# mb-app — Application Marchand de Biens
|
|
|
|
Application mobile et web pour la gestion quotidienne d'une activité de marchand de biens immobiliers.
|
|
|
|
**Stack :** React Native (Expo) + PocketBase (self-hosted sur NAS Synology) + IA Claude
|
|
|
|
---
|
|
|
|
## Démarrage rapide
|
|
|
|
### Prérequis
|
|
- Docker Desktop (Mac/Windows) ou Docker Engine (Linux/NAS)
|
|
- Node.js 18+
|
|
- Un compte DuckDNS (gratuit) pour l'accès distant
|
|
|
|
### 1. Cloner le projet
|
|
|
|
```bash
|
|
git clone https://github.com/VOUS/mb-app.git
|
|
cd mb-app
|
|
```
|
|
|
|
### 2. Setup initial
|
|
|
|
```bash
|
|
make setup
|
|
# → Crée les dossiers nécessaires
|
|
# → Copie .env.example en .env.local
|
|
```
|
|
|
|
Éditer `.env.local` :
|
|
```
|
|
EXPO_PUBLIC_PB_URL=http://localhost:8090
|
|
ANTHROPIC_API_KEY=sk-ant-VOTRE_CLE
|
|
```
|
|
|
|
### 3. Lancer en développement
|
|
|
|
```bash
|
|
# Terminal 1 — Backend PocketBase
|
|
make dev
|
|
# → PocketBase sur http://localhost:8090
|
|
# → Admin sur http://localhost:8090/_/
|
|
|
|
# Terminal 2 — App Expo
|
|
cd app
|
|
npm install
|
|
npx expo start
|
|
```
|
|
|
|
**Première fois :** Aller sur http://localhost:8090/_/ → créer le compte admin
|
|
→ Settings → Import collections → coller le contenu de `pocketbase/pb_collections.json`
|
|
|
|
---
|
|
|
|
## Déploiement sur le NAS Synology
|
|
|
|
### 1. Cloner sur le NAS
|
|
|
|
```bash
|
|
# Se connecter en SSH au NAS
|
|
ssh admin@IP_DU_NAS
|
|
|
|
# Cloner le projet
|
|
git clone https://github.com/VOUS/mb-app.git /volume1/docker/mb-app
|
|
cd /volume1/docker/mb-app
|
|
```
|
|
|
|
### 2. Configurer l'environnement production
|
|
|
|
```bash
|
|
make setup-nas
|
|
# Puis éditer .env.production :
|
|
nano .env.production
|
|
```
|
|
|
|
```
|
|
EXPO_PUBLIC_PB_URL=https://mon-sous-domaine.duckdns.org
|
|
ANTHROPIC_API_KEY=sk-ant-VOTRE_CLE
|
|
DUCKDNS_SUBDOMAINS=mon-sous-domaine
|
|
DUCKDNS_TOKEN=VOTRE_TOKEN_DUCKDNS
|
|
```
|
|
|
|
### 3. Ouvrir les ports sur votre box internet
|
|
- Port 80 → IP du NAS, port 80
|
|
- Port 443 → IP du NAS, port 443
|
|
|
|
### 4. Obtenir le certificat SSL
|
|
|
|
```bash
|
|
make ssl
|
|
```
|
|
|
|
### 5. Lancer la stack
|
|
|
|
```bash
|
|
make prod
|
|
```
|
|
|
|
### Mettre à jour après un git push
|
|
|
|
```bash
|
|
# Sur le NAS :
|
|
make deploy
|
|
# → git pull + restart PocketBase (les hooks sont rechargés)
|
|
```
|
|
|
|
---
|
|
|
|
## Workflow de développement
|
|
|
|
```
|
|
[Local] Coder + tester
|
|
↓
|
|
git add . && git commit -m "feat: module visites"
|
|
↓
|
|
git push origin main
|
|
↓
|
|
[NAS] make deploy
|
|
```
|
|
|
|
Les **données** (`pb_data/`) restent sur chaque machine et ne sont jamais dans Git.
|
|
Le **code** (hooks, migrations, app) est versionné et déployé via Git.
|
|
|
|
---
|
|
|
|
## Structure du projet
|
|
|
|
```
|
|
mb-app/
|
|
├── app/ ← Code React Native (Expo Router)
|
|
├── pocketbase/
|
|
│ ├── pb_hooks/ ← Hooks JS côté serveur (IA, etc.)
|
|
│ ├── pb_migrations/ ← Migrations auto PocketBase
|
|
│ └── pb_collections.json ← Schéma des collections
|
|
├── docker/
|
|
│ ├── docker-compose.dev.yml
|
|
│ ├── docker-compose.prod.yml
|
|
│ └── nginx.prod.conf
|
|
├── .cursorrules ← Contexte pour Cursor AI
|
|
├── AGENTS.md ← Suivi des sessions de développement
|
|
└── Makefile ← Raccourcis commandes
|
|
```
|
|
|
|
---
|
|
|
|
## Commandes utiles
|
|
|
|
| Commande | Description |
|
|
|---|---|
|
|
| `make dev` | Lance PocketBase en local |
|
|
| `make dev-stop` | Arrête le dev |
|
|
| `make logs` | Logs en temps réel |
|
|
| `make prod` | Lance la stack NAS |
|
|
| `make deploy` | git pull + redémarre (sur NAS) |
|
|
| `make renew-ssl` | Renouvelle le certificat SSL |
|
|
|
|
---
|
|
|
|
## Backup des données
|
|
|
|
Les données PocketBase sont dans `pb_data/` (exclu du Git).
|
|
Configurer une tâche Synology Hyper Backup sur `/volume1/docker/mb-app/pb_data/`.
|