parky

🅿️ Parky

El Waze del parking. Encuentra plaza en segundos, comparte cuando te vas.

¿Qué es Parky?

Parky es una app colaborativa de aparcamiento en tiempo real. Los usuarios marcan cuando dejan una plaza libre y otros pueden verla en el mapa antes de llegar.

Sin registros complejos. Sin mapas de pago. Sin bullshit.

Features del MVP

Feature	Estado
🗺️ Mapa en tiempo real con plazas disponibles	✅
🚗 Botón “Dejo plaza” con GPS automático	✅
⏱️ Plazas expiran en 10 min automáticamente	✅
⭐ Sistema de karma (+1 punto por cada plaza reportada)	✅
🔐 Login con Google	✅
🟢🟡🔴 Pines por frescura (<3min / 3-7min / 7-10min)	✅

Stack

Flutter (Dart)          → App móvil Android/iOS
Firebase Auth           → Login con Google
Cloud Firestore         → Base de datos en tiempo real
Google Maps Flutter     → Mapa interactivo
Cloud Functions (Node)  → Expiración automática de spots
Riverpod               → Estado de la app
GitHub Actions          → CI/CD + build de APK

Arquitectura

lib/
├── main.dart               # Entry point + AuthGate
├── models/
│   ├── spot.dart           # Plaza de parking
│   └── app_user.dart       # Usuario con karma
├── services/
│   ├── auth_service.dart   # Login Google
│   ├── spot_service.dart   # CRUD plazas + karma
│   └── location_service.dart
├── providers/              # Riverpod providers
├── screens/
│   ├── login_screen.dart
│   └── map_screen.dart
└── widgets/
    └── karma_badge.dart

Distribución no oficial (Beta)

Como el MVP es privado y no está en Play Store, usamos distribución directa mediante APK.

Cómo instalar la APK en tu Android

1. Activa “Fuentes desconocidas”

Ajustes → Seguridad → Instalar apps desconocidas
(en Android 8+: actívalo solo para el navegador/files)

2. Descarga la APK

Cada vez que se hace un push a main, GitHub Actions compila automáticamente una nueva APK.

Descárgala aquí → Releases / Actions → último build → parky-debug.apk

3. Instala y lanza

Abre el archivo .apk desde tu gestor de archivos y pulsa “Instalar”.

Distribución por WhatsApp / Telegram (early adopters)

Para los primeros 50 usuarios de prueba:

Descarga la APK del link de Actions
Compártela directamente por WhatsApp / Telegram
Los usuarios activan fuentes desconocidas e instalan

⚠️ Esta APK es debug y pesa más de lo normal (~50MB). La versión release será ~15MB.

Distribución futura (roadmap)

Canal	Cuándo
APK directa (ahora)	MVP / validación
Firebase App Distribution	Beta cerrada con testers
Play Store (acceso anticipado)	Tras validar 50 usuarios activos

CI/CD

Cada push a main genera automáticamente una APK de debug disponible en GitHub Actions como artifact (parky-debug).

on:
  push:
    branches: [main]

Configuración local (devs)

# 1. Clona el repo
git clone https://github.com/Darkvus/parky.git && cd parky

# 2. Instala dependencias
flutter pub get

# 3. Añade tu Maps API Key
echo "MAPS_API_KEY=TU_KEY" >> android/local.properties

# 4. Lanza
flutter run

lib/firebase_options.dart y android/app/google-services.json ya están en el repo (proyecto parky-mvp-2024).

Validación del MVP

Objetivo en 72h tras lanzar:

50 usuarios instalan la app
10 plazas reales compartidas
Al menos 3 usuarios reportan >3 plazas cada uno

Si se cumplen → hay product-market fit. Siguiente paso: alertas push + freemium.