Prerequisites

• Flutter SDK: ^3.10.4
• Dart SDK: ^3.0.0
• IDE: VS Code (recommended) or Android Studio.
• Java: JDK 17+ (for Android builds).

Getting Started

Installation

1. Clone the repository.
2. Navigate to the project root:

   cd guardiapp-mobile-flutter
   

3. Get dependencies:

   flutter pub get
   

Running the App

• Mobile (Android/iOS):

  flutter run
  

• Web:

  flutter run -d chrome
  

• Desktop (Windows/macOS/Linux):

  flutter run -d windows # or macos/linux
  

Project Structure

• lib/models/: Data models and State management (AppState).
• lib/screens/: UI screens for Auth, Dashboard, Students, Schedule, etc.
• lib/utils/: Helper classes and localization (AppStrings).
• lib/theme/: Custom application themes.
• assets/: Images, icons, and backgrounds.

Versión en Español

Características

• Autenticación: Sistema de inicio de sesión seguro para profesores y administradores.
• Gestión de Profesores: Directorio con búsqueda, edición de perfil y rastreo de disponibilidad.
• Gestión de Estudiantes: CRUD completo para alumnos, incluyendo curso e información de contacto de padres.
• Gestión de Horarios: Horario interactivo para gestionar turnos y asignaturas.
• Seguimiento de Ausencias: Sistema para solicitar y aprobar ausencias de profesores.
• Localización: Soporte completo para los idiomas inglés y español.
• Personalización: Soporte para modo oscuro y fondos personalizables.

Stack Tecnológico

• Framework: Flutter (Dart)
• Gestión de Estado: Provider
• Almacenamiento Local: SharedPreferences
• Componentes de UI: Google Fonts, efectos Shimmer, animaciones escalonadas.
• Utilidades: Intl (localización), Uuid, Path Provider.

Requisitos Previos

• Flutter SDK: ^3.10.4
• Dart SDK: ^3.0.0
• IDE: VS Code (recomendado) o Android Studio.
• Java: JDK 17+ (para compilación en Android).

Primeros Pasos

Instalación

1. Clona el repositorio.
2. Ve al directorio raíz del proyecto:

   cd guardiapp-mobile-flutter
   

3. Instala las dependencias:

   flutter pub get
   

Ejecución de la App

• Móvil (Android/iOS):

  flutter run
  

• Web:

  flutter run -d chrome
  

• Escritorio (Windows/macOS/Linux):

  flutter run -d windows # o macos/linux
  

Estructura del Proyecto

• lib/models/: Modelos de datos y gestión de estado (AppState).
• lib/screens/: Pantallas de UI (Auth, Dashboard, Alumnos, Horario, etc.).
• lib/utils/: Clases auxiliares y localización (AppStrings).
• lib/theme/: Temas personalizados de la aplicación.
• assets/: Imágenes, iconos y fondos de pantalla.