🔧 ChambApp - Aplicación de Servicios y Trabajos

ChambApp es una aplicación móvil de Android que conecta clientes con trabajadores y emprendedores de servicios locales.

🚀 Características

• 👤 Sistema de autenticación (clientes y trabajadores)
• 🔍 Búsqueda de trabajadores por oficio y ubicación
• 💬 Sistema de chat en tiempo real
• ⭐ Sistema de calificaciones y reseñas
• 📍 Integración con geolocalización
• 📸 Subida de imágenes de perfil y trabajos
• 🔔 Sistema de peticiones de trabajo

📋 Requisitos

• Android Studio Hedgehog | 2023.1.1 o superior
• JDK 11 o superior
• SDK de Android API 23+ (Android 6.0 o superior)
• Cuenta de Firebase (para backend)

⚙️ Configuración del Proyecto

1. Clonar el repositorio

git clone https://github.com/TU_USUARIO/ChambApp.git
cd ChambApp

2. Configurar Firebase

Este proyecto requiere Firebase para funcionar. NO incluimos el archivo google-services.json por razones de seguridad.

Pasos para obtener tu archivo de configuración:

1. Ve a Firebase Console
2. Crea un nuevo proyecto o usa uno existente
3. Agrega una aplicación Android con el package name: com.example.chambapp
4. Descarga el archivo google-services.json
5. Colócalo en: app/google-services.json

Configurar servicios de Firebase:

• Firestore Database: Para almacenar datos
• Firebase Storage: Para imágenes y archivos
• Firebase Authentication: Para autenticación de usuarios
• Firebase App Check: Para seguridad (recomendado)

Ver INSTRUCCIONES_FIREBASE.md para más detalles.

3. Configurar reglas de seguridad

⚠️ IMPORTANTE: Las reglas de ejemplo en INSTRUCCIONES_FIREBASE.md son para desarrollo solamente.

Para producción, usa reglas seguras que requieran autenticación. Ver ejemplos en el archivo de instrucciones.

4. Compilar el proyecto

# Limpiar y compilar
./gradlew clean
./gradlew assembleDebug

# O desde Android Studio:
# Build > Rebuild Project

🏗️ Estructura del Proyecto

app/src/main/java/com/example/chambapp/
├── data/
│   ├── models/          # Modelos de datos
│   ├── repository/      # Capa de acceso a datos
│   └── utils/           # Utilidades de datos
├── ui/
│   ├── components/      # Componentes reutilizables
│   ├── navigation/      # Sistema de navegación
│   ├── screens/         # Pantallas de la app
│   └── theme/           # Tema y colores
├── utils/               # Utilidades generales
├── viewmodel/           # ViewModels (MVVM)
└── MainActivity.kt      # Actividad principal

Ver GUIA_DE_USO.md para documentación detallada.

🔒 Seguridad

• No compartas tu archivo google-services.json
• No subas keystores (.jks, .keystore) al repositorio
• Configura reglas de Firestore apropiadas para producción
• Habilita App Check en Firebase Console antes de publicar

Ver SECURITY.md para más información.

🛠️ Tecnologías Utilizadas

• Kotlin - Lenguaje de programación
• Jetpack Compose - UI moderna declarativa
• Firebase - Backend (Firestore, Storage, Auth)
• Material Design 3 - Sistema de diseño
• Coroutines - Programación asíncrona
• MVVM - Arquitectura

📖 Documentación

• GUIA_DE_USO.md - Guía completa de desarrollo
• INSTRUCCIONES_FIREBASE.md - Configuración de Firebase
• ESTRUCTURA_DEL_PROYECTO.md - Arquitectura del proyecto
• RESUMEN_REORGANIZACION.md - Cambios y mejoras

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Haz fork del proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📄 Licencia

Este proyecto es de código abierto y está disponible bajo la Licencia MIT.

📧 Contacto

Para preguntas o soporte, por favor abre un issue en GitHub.

---

Nota: Esta aplicación está en desarrollo. No usar en producción sin las configuraciones de seguridad apropiadas.