Loan Manager App

Prestamist - app - background v4 0 0

Loan Manager App es una aplicación diseñada para ayudar a las empresas de préstamos a gestionar sus operaciones diarias de manera eficiente. Con un panel de administrador y una interfaz de cajero, la aplicación permite la gestión de todos los préstamos, incluyendo el seguimiento de los días retrasados y los días restantes por pagar.

Además, la aplicación admite múltiples sucursales, lo que permite una gestión centralizada de todos los préstamos en diferentes locaciones. Los usuarios pueden actualizar los pagos diarios, semanales o personalizados y cerrar los préstamos de manera eficiente.

La aplicación también permite enviar recordatorios personalizados a través de WhatsApp, lo que facilita la comunicación con los clientes y mejora la eficiencia del proceso de cobro. La administración de caja es una de las características clave de la aplicación, permitiendo un seguimiento detallado de los ingresos y gastos.

Además, los usuarios pueden generar informes de caja personalizados por fechas, lo que les permite conocer el estado financiero de la empresa en cualquier momento. La aplicación también permite registrar préstamos personalizados con intereses y plazos ajustables, y realizar un redondeo de préstamos para una gestión más precisa y eficiente.

En resumen, Loan Manager App es una herramienta útil para cualquier empresa de préstamos que busque optimizar sus operaciones y mejorar la eficiencia de su proceso de cobro.

🚀 Features

Menus (Dashboard / Finanzas / Registro)
Géstion de todos los préstamos (días retrasados - días faltantes por pagar)
Múltiples Sucursales
Admin Panel / Cashier
Actualiza pagos diarios / semanales / personalizados
Cierra préstamos
Envía recordatorios personalizados mediante Whatsapp & Sms
Administración de caja
Prestamos personalizados (DIARIO, SEMANAL, QUINCENAL, MENSUAL, BIMESTRAL, TRIMESTRAL, SEMESTRAL, ANUAL)
Reporte de caja por fechas personalizados
Registro de préstamos personalizados (ínteres ó plazos )
Genera voucher de pago
Opciones para compartir voucher por dispositivo
Redondeo de préstamos
Automatización de envio de bouchers por email con RESEND.com (Opcional - V4.1.0)

🛠 Tech Stack & Open-source libraries

Minimum SDK level 24
Kotlin - First class and official programming language for Android development.
Coroutines - For asynchronous programming
Flow - A cold asynchronous data stream
JetPack
- Lifecycle - Observe Android lifecycles and handle UI states
- ViewModel - UI related data holder, lifecycle aware
- Room - Construct database
- Navigation Component - Handle everything needed for in-app navigation
Koin - Dependency Injection framework
Firebase - Backend platform for authentication and realtime database
Material-Components - Material design components

🏗️ Architecture

Clean Architecture
MVI Architecture (View - View - Intent)
Repository pattern
SOLID Principles
Jetpack Libraries

Installation

Configuracion del proyecto en Firebase
- Crear un proyecto en firebase
- Configurar Firestore Database
- Configurar RealTime Database
- Configurar Authentication method using Email/Password

Configurar Firestore Database

Configurar rules

rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
    match /{document=**} {
        allow read, write:if(request.auth) != null
        }
    }
}

Configurar Indices para el modulo de finanzas

Reemplazar el archivo Google Services de Firebase

Cambiar el archivo google-services.json que se encuentra dentro de la carpeta 
./prestamist/app/google-services.json

Cargar las sucursales actuales dentro de Realtime Database

  Ejemplo:

  {
  "sucusales": {
    "sucursal1": {
      "address": "Av lima 1456",
      "id": 0,
      "name": "Pichanaki A"
    },
    "sucursal2": {
      "address": "Jr. Mediaterraneo 1587",
      "id": 16,
      "name": "Pichanaki B"
    },
    "sucursal3": {
      "address": "Av. circunvalacion s/n",
      "id": 18,
      "name": "Puerto Bermudez"
    }
  }
}

Configuración de Notificaciones Automáticas (OPCIONAL)

Para configurar notificaciones automáticas utilizando la API de Resend, sigue estos pasos:
1. Crear una cuenta en Resend
2. Configurar un nuevo proyecto en Resend
3. Configurar tu dominio en Resend
4. Obtener el API Key de Resend
5. Configurar el API Key en el local.properties del proyecto
```
RESEND_API_KEY=<REPLACE_WITH_API_KEY>
```
Para configurar el recipient from en el envio de mensajes, debes configurar el archivo PADATAConstants.kt
```
const val RECIPIENT_FROM = "PrestamistApp <info@paparazziteam.work>"
```
Sincronizar el proyecto y vincularlo con Firebase

  Disfrútalo 💕 💕 💕

Demo

Super Admin credentials

Username: demo3@gmail.com
Password: 123456789

Admin credentials

Username:
Password:

Cashier credentials

Username:
Password:

Authors

@ahuamana

Licence

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

ahuamana / prestamistAPP

readme