FiscAI

Asistente fiscal inteligente para pequeños negocios y emprendedores

FiscAI es una aplicación móvil multiplataforma desarrollada con Expo y React Native, diseñada para ayudar a pequeños negocios y emprendedores a gestionar su situación fiscal, obtener recomendaciones personalizadas, visualizar su progreso y acceder a herramientas inteligentes como chat asistido, roadmap fiscal, análisis financiero y más.

• Instalación
• Uso
• Estructura del Proyecto
• Tecnologías Utilizadas
• Funcionalidades Principales
• Base de Datos y Supabase
• Créditos

1. Clona el repositorio y entra al directorio:

   git clone https://github.com/Rugroso/FiscAI.git
   cd FiscAI

2. Instala las dependencias:

   npm install

3. Configura las variables de entorno en un archivo .env:

   EXPO_PUBLIC_SUPABASE_URL=TU_URL_SUPABASE
   EXPO_PUBLIC_SUPABASE_KEY=TU_KEY_SUPABASE
   EXPO_PUBLIC_API_BASE_URL=TU_API_URL
   EXPO_PUBLIC_GOOGLE_MAPS_API_KEY=TU_API_KEY

4. Inicia la app:

   npx expo start

Puedes abrir la app en un emulador Android/iOS, dispositivo físico con Expo Go, o en la web. Sigue las instrucciones que aparecen en la terminal tras ejecutar el comando de inicio.

FiscAI/
├── app/                # Pantallas y rutas principales (file-based routing)
│   ├── _layout.tsx     # Layout global, providers de contexto
│   ├── login.tsx       # Pantalla de inicio de sesión
│   ├── register.tsx    # Registro de usuario
│   ├── cuestionario.tsx# Cuestionario inicial de negocio
│   ├── (drawer)/       # Navegación principal tipo Drawer
│   │   └── (tabs)/     # Navegación por pestañas (Home, Chat, Mapa, etc.)
│   │       ├── stackhome/   # Home, Roadmap, Beneficios, Recomendaciones
│   │       ├── stackchat/   # Chatbot fiscal
│   │       └── stackmap/    # Mapa de bancos y SAT
├── components/         # Componentes reutilizables (UI, gráficos, etc.)
├── context/            # Contextos globales (Auth, Progreso)
├── services/           # Lógica de negocio (ej. chat, API)
├── constants/          # Temas y constantes globales
├── config/             # Configuración de API y Supabase
├── assets/             # Imágenes y recursos estáticos
├── scripts/            # Scripts utilitarios
├── package.json        # Dependencias y scripts de npm
├── app.json            # Configuración de Expo
└── README.md           # Este archivo

• app/: Contiene todas las pantallas y rutas. Usa Expo Router para navegación basada en archivos.
• components/: Elementos visuales reutilizables (ej. growthpotential.tsx, roadmap.tsx, ui/).
• context/: Proveedores de contexto global para autenticación y progreso del usuario.
• services/: Lógica de negocio, como el servicio de chat conectado a Supabase.
• supabase/: Migraciones SQL para la base de datos (conversaciones, negocios, etc.).
• config/: Configuración centralizada de APIs y claves.
• constants/: Temas de color y constantes globales.

• React Native (Expo)
• TypeScript
• Expo Router
• Supabase (autenticación, base de datos, realtime)
• React Navigation
• AsyncStorage
• Google Maps API
• Expo Modules: Haptics, Image Picker, Location, etc.

• Autenticación de usuarios (registro, login, persistencia de sesión)
• Cuestionario inicial para personalizar la experiencia según el negocio
• Roadmap fiscal: guía paso a paso para cumplir obligaciones fiscales
• Chatbot fiscal: asistente inteligente conectado a Supabase
• Análisis de potencial de crecimiento y recomendaciones financieras
• Mapa interactivo de bancos y oficinas SAT cercanas
• Gestión de progreso y desbloqueo de etapas
• Beneficios y recursos para el usuario

El backend utiliza Supabase para autenticación y almacenamiento de datos. Las migraciones SQL se encuentran en supabase/migrations/ e incluyen:

• 001_chat_schema.sql: Tablas para conversaciones y mensajes del chat
• 002_businesses_schema.sql: Información de negocios, métricas y formalidad

Desarrollado por Rugroso y colaboradores.

• Expo documentation: Learn fundamentals, or go into advanced topics with our guides.
• Learn Expo tutorial: Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.

Join our community of developers creating universal apps.

• Expo on GitHub: View our open source platform and contribute.
• Discord community: Chat with Expo users and ask questions.