🔐 Sistema de Registro y Login

App Flutter conectada con API PHP y Plugin FacturaScripts

Descargar Ejemplos Completos

📱 ¿Qué es este sistema?

Sistema Completo de Autenticación

Esta aplicación Flutter demuestra cómo crear un sistema completo de registro y login que se integra con:

Backend PHP simple: API REST para autenticación básica
Plugin FacturaScripts: Extensión que crea API Keys automáticamente
App Flutter: Interfaz móvil con pantallas de registro, login y home
Gestión de estado: Control de sesión y tokens de autenticación

Arquitectura del Sistema

📱 Frontend Flutter: Pantallas y servicios de autenticación
🔌 API PHP: Backend de ejemplo con JWT/tokens
🏢 Plugin FacturaScripts: Extensión del modelo Cliente para generar API Keys
🔗 Conexión: El password del cliente se usa como API Key en FacturaScripts

📁 Estructura del Proyecto

RegistroLogin/
├── lib/                                 # Aplicación Flutter
│   ├── config/
│   │   └── api_config.dart             # Configuración de endpoints
│   ├── models/
│   │   └── user.dart                   # Modelo de Usuario
│   ├── services/
│   │   └── auth_service.dart           # Servicio de autenticación
│   ├── screens/
│   │   ├── register_screen.dart        # Pantalla de registro
│   │   ├── login_screen.dart           # Pantalla de login
│   │   └── home_screen.dart            # Pantalla principal
│   ├── backend_ejemplo/
│   │   └── api.php                     # Backend PHP de ejemplo
│   └── main.dart                       # Punto de entrada
│
└── ReparacionesRK/                     # Plugin FacturaScripts
    ├── facturascripts.ini              # Configuración del plugin
    ├── Init.php                        # Inicialización
    ├── Extension/
    │   └── Model/
    │       └── Cliente.php             # Extensión del modelo Cliente
    ├── Model/                           
    ├── Controller/                      
    └── XMLView/

🔍 Explora los Componentes

Haz clic en cualquier componente para ver su código completo:

🚀

Punto de Entrada

main.dart

Ver código →

⚙️

Configuración API

api_config.dart

Ver código →

👤

Modelo User

user.dart

Ver código →

🔐

Auth Service

auth_service.dart

Ver código →

🔑

Pantalla Login

login_screen.dart

Ver código →

📝

Pantalla Registro

register_screen.dart

Ver código →

🏠

Pantalla Home

home_screen.dart

Ver código →

🖥️

Backend PHP

api.php

Ver código →

🔌

Extensión Cliente

Cliente.php

Ver código →

⚡

Init Plugin

Init.php

Ver código →

📄

Config Plugin

facturascripts.ini

Ver código →

🔄 Flujo de Funcionamiento

1️⃣ Registro de Usuario

Usuario completa formulario en RegisterScreen
AuthService.register() envía datos a la API
Backend PHP valida y crea usuario con token
Usuario es redirigido a pantalla de login

2️⃣ Login de Usuario

Usuario ingresa email y password en LoginScreen
AuthService.login() autentica con la API
Backend verifica credenciales y devuelve token
Token se guarda y usuario accede a HomeScreen

3️⃣ Integración con FacturaScripts

En FacturaScripts, se crea/edita un Cliente
Campo password personalizado se completa
Extensión Cliente.php intercepta el guardado
Se crea automáticamente un ApiKey usando:
- dni: CIF/NIF del cliente
- description: Email del cliente
- apikey: Password del cliente
App Flutter puede usar ese password para autenticarse con FacturaScripts

🔧 Explicación Técnica Detallada

🎯 Patrón Service Layer

AuthService centraliza toda la lógica de autenticación:

Abstrae las peticiones HTTP
Gestiona errores de forma centralizada
Serializa/deserializa JSON automáticamente
Devuelve objetos User tipados

🔐 Gestión de Tokens

El sistema usa tokens Bearer para autenticación:

Generados en backend con bin2hex(random_bytes(32))
Enviados en header Authorization: Bearer {token}
Validados en cada petición protegida
Almacenados en la app (SharedPreferences recomendado)

🏗️ Extensión de Modelos

Plugin FacturaScripts extiende el modelo Cliente:

saveInsert(): Se ejecuta al crear cliente
saveUpdate(): Se ejecuta al actualizar cliente
Usa Closure para inyectar lógica personalizada
Crea/actualiza ApiKey automáticamente

🔗 Cómo se Conectan Flutter y FacturaScripts

Crear Cliente en FacturaScripts

Admin añade cliente con email y password personalizado

↓

Plugin Genera API Key

Extensión Cliente.php crea ApiKey automáticamente

apikey = password del cliente

↓

Usuario Login en App

Usuario ingresa email y password en la app Flutter

↓

App Accede a FacturaScripts

Flutter usa el password como token en header:

token: {password}

📋 Requisitos y Dependencias

Flutter (pubspec.yaml)

dependencies:
  flutter:
    sdk: flutter
  http: ^1.1.0              # Peticiones HTTP
  provider: ^6.0.0          # Gestión de estado (opcional)
  shared_preferences: ^2.0.0 # Persistencia de token

Backend PHP

PHP 7.4 o superior
Extensión JSON habilitada
Extensión OpenSSL para tokens
Headers CORS configurados

FacturaScripts

FacturaScripts 2024 o superior
Plugin instalado en /Plugins/ReparacionesRK/
Campo personalizado password en modelo Cliente
API habilitada en configuración

✅ Mejores Prácticas Implementadas

🛡️ Seguridad

Passwords hasheados con password_hash()
Tokens aleatorios seguros
Validación en cliente y servidor
Headers CORS configurados
Sin passwords en respuestas

🎨 UX/UI

Indicadores de carga (_isLoading)
Validación de formularios en tiempo real
SnackBars para feedback al usuario
Navegación fluida entre pantallas
TextFormField con validators

🏗️ Arquitectura

Separación de capas (UI, Service, Model)
Configuración centralizada
Código reutilizable y mantenible
Gestión de errores consistente
Logs informativos en backend y plugin

🔧 Solución de Problemas Comunes

❌ Error de CORS

Síntoma: "CORS policy blocked"

Solución:

Verifica headers en api.php
Asegura que Access-Control-Allow-Origin: * esté presente
Maneja peticiones OPTIONS (preflight)

🔐 API Key no se crea

Síntoma: Cliente guardado pero sin ApiKey

Solución:

Verifica que el campo password no esté vacío
Revisa logs de FacturaScripts
Confirma que Init.php carga la extensión
Comprueba permisos de escritura en BD

📱 App no conecta

Síntoma: "Connection refused"

Solución:

En dispositivo físico, usa IP real (no localhost)
Verifica que el servidor esté corriendo
Comprueba baseUrl en api_config.dart
Usa http://10.0.2.2:8000 en emulador Android

🔑 Token inválido

Síntoma: "Error 401: Token inválido"

Solución:

Verifica formato: Bearer {token}
Confirma que el token se guarda correctamente
Revisa que no haya espacios extra
Valida que el token exista en users.json

🚀 Mejoras Sugeridas

1. Persistencia de Sesión

Implementar SharedPreferences para mantener al usuario logueado:

Guardar token al hacer login
Verificar token al iniciar app
Limpiar token al hacer logout
Auto-login si token es válido

2. Gestión de Estado

Usar Provider, Riverpod o BLoC para gestionar el estado global:

AuthProvider con estado de usuario
Loading states centralizados
Navegación condicional según estado
Refresh automático de datos

3. Base de Datos Real

Migrar de JSON a MySQL/PostgreSQL:

Tablas relacionales para usuarios
Índices para búsquedas rápidas
Transacciones ACID
Backups automatizados

4. Seguridad Avanzada

JWT con expiración automática
Refresh tokens
Rate limiting en API
Validación de email con código
2FA (autenticación de dos factores)

🔐 Servicio de Autenticación - auth_service.dart

import 'dart:convert';
import 'package:http/http.dart' as http;
import '../config/api_config.dart';
import '../models/user.dart';

/// Servicio básico de autenticación
class AuthService {
  /// Registrar nuevo usuario
  Future<User?> register({
    required String name,
    required String email,
    required String password,
  }) async {
    try {
      final response = await http.post(
        Uri.parse('${ApiConfig.baseUrl}${ApiConfig.registerEndpoint}'),
        headers: ApiConfig.headers,
        body: jsonEncode({
          'name': name,
          'email': email,
          'password': password,
        }),
      );

      if (response.statusCode == 200 || response.statusCode == 201) {
        final data = jsonDecode(response.body);
        return User.fromJson(data['user'] ?? data);
      } else {
        print('Error en registro: ${response.body}');
        return null;
      }
    } catch (e) {
      print('Error de conexión: $e');
      return null;
    }
  }

  /// Login de usuario
  Future<User?> login({
    required String email,
    required String password,
  }) async {
    try {
      final response = await http.post(
        Uri.parse('${ApiConfig.baseUrl}${ApiConfig.loginEndpoint}'),
        headers: ApiConfig.headers,
        body: jsonEncode({
          'email': email,
          'password': password,
        }),
      );

      if (response.statusCode == 200) {
        final data = jsonDecode(response.body);
        return User.fromJson(data['user'] ?? data);
      } else {
        print('Error en login: ${response.body}');
        return null;
      }
    } catch (e) {
      print('Error de conexión: $e');
      return null;
    }
  }

  /// Obtener información del usuario autenticado
  Future<User?> getUser(String token) async {
    try {
      final response = await http.get(
        Uri.parse('${ApiConfig.baseUrl}${ApiConfig.userEndpoint}'),
        headers: ApiConfig.headersWithAuth(token),
      );

      if (response.statusCode == 200) {
        final data = jsonDecode(response.body);
        return User.fromJson(data);
      } else {
        return null;
      }
    } catch (e) {
      print('Error: $e');
      return null;
    }
  }
}

🔑 Pantalla de Login - login_screen.dart

import 'package:flutter/material.dart';
import '../services/auth_service.dart';
import 'register_screen.dart';
import 'home_screen.dart';

/// Pantalla básica de login
class LoginScreen extends StatefulWidget {
  const LoginScreen({Key? key}) : super(key: key);

  @override
  State<LoginScreen> createState() => _LoginScreenState();
}

class _LoginScreenState extends State<LoginScreen> {
  final _formKey = GlobalKey<FormState>();
  final _emailController = TextEditingController();
  final _passwordController = TextEditingController();
  final _authService = AuthService();
  bool _isLoading = false;

  @override
  void dispose() {
    _emailController.dispose();
    _passwordController.dispose();
    super.dispose();
  }

  Future<void> _login() async {
    if (!_formKey.currentState!.validate()) return;

    setState(() => _isLoading = true);

    final user = await _authService.login(
      email: _emailController.text.trim(),
      password: _passwordController.text,
    );

    setState(() => _isLoading = false);

    if (user != null) {
      if (!mounted) return;
      Navigator.pushReplacement(
        context,
        MaterialPageRoute(
          builder: (_) => HomeScreen(user: user),
        ),
      );
    } else {
      if (!mounted) return;
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('Credenciales incorrectas')),
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Iniciar Sesión'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Form(
          key: _formKey,
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              TextFormField(
                controller: _emailController,
                decoration: const InputDecoration(
                  labelText: 'Email',
                  border: OutlineInputBorder(),
                ),
                keyboardType: TextInputType.emailAddress,
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Ingresa tu email';
                  }
                  return null;
                },
              ),
              const SizedBox(height: 16),
              TextFormField(
                controller: _passwordController,
                decoration: const InputDecoration(
                  labelText: 'Contraseña',
                  border: OutlineInputBorder(),
                ),
                obscureText: true,
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Ingresa tu contraseña';
                  }
                  return null;
                },
              ),
              const SizedBox(height: 24),
              SizedBox(
                width: double.infinity,
                child: ElevatedButton(
                  onPressed: _isLoading ? null : _login,
                  child: _isLoading
                      ? const CircularProgressIndicator()
                      : const Text('Iniciar Sesión'),
                ),
              ),
              const SizedBox(height: 16),
              TextButton(
                onPressed: () {
                  Navigator.pushReplacement(
                    context,
                    MaterialPageRoute(builder: (_) => const RegisterScreen()),
                  );
                },
                child: const Text('¿No tienes cuenta? Regístrate'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

📝 Pantalla de Registro - register_screen.dart

import 'package:flutter/material.dart';
import '../services/auth_service.dart';
import 'login_screen.dart';

/// Pantalla básica de registro
class RegisterScreen extends StatefulWidget {
  const RegisterScreen({Key? key}) : super(key: key);

  @override
  State<RegisterScreen> createState() => _RegisterScreenState();
}

class _RegisterScreenState extends State<RegisterScreen> {
  final _formKey = GlobalKey<FormState>();
  final _nameController = TextEditingController();
  final _emailController = TextEditingController();
  final _passwordController = TextEditingController();
  final _authService = AuthService();
  bool _isLoading = false;

  @override
  void dispose() {
    _nameController.dispose();
    _emailController.dispose();
    _passwordController.dispose();
    super.dispose();
  }

  Future<void> _register() async {
    if (!_formKey.currentState!.validate()) return;

    setState(() => _isLoading = true);

    final user = await _authService.register(
      name: _nameController.text.trim(),
      email: _emailController.text.trim(),
      password: _passwordController.text,
    );

    setState(() => _isLoading = false);

    if (user != null) {
      if (!mounted) return;
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('Registro exitoso!')),
      );
      Navigator.pushReplacement(
        context,
        MaterialPageRoute(builder: (_) => const LoginScreen()),
      );
    } else {
      if (!mounted) return;
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('Error al registrar')),
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Registro'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Form(
          key: _formKey,
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              TextFormField(
                controller: _nameController,
                decoration: const InputDecoration(
                  labelText: 'Nombre',
                  border: OutlineInputBorder(),
                ),
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Ingresa tu nombre';
                  }
                  return null;
                },
              ),
              const SizedBox(height: 16),
              TextFormField(
                controller: _emailController,
                decoration: const InputDecoration(
                  labelText: 'Email',
                  border: OutlineInputBorder(),
                ),
                keyboardType: TextInputType.emailAddress,
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Ingresa tu email';
                  }
                  if (!value.contains('@')) {
                    return 'Ingresa un email válido';
                  }
                  return null;
                },
              ),
              const SizedBox(height: 16),
              TextFormField(
                controller: _passwordController,
                decoration: const InputDecoration(
                  labelText: 'Contraseña',
                  border: OutlineInputBorder(),
                ),
                obscureText: true,
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Ingresa tu contraseña';
                  }
                  if (value.length < 6) {
                    return 'Mínimo 6 caracteres';
                  }
                  return null;
                },
              ),
              const SizedBox(height: 24),
              SizedBox(
                width: double.infinity,
                child: ElevatedButton(
                  onPressed: _isLoading ? null : _register,
                  child: _isLoading
                      ? const CircularProgressIndicator()
                      : const Text('Registrar'),
                ),
              ),
              const SizedBox(height: 16),
              TextButton(
                onPressed: () {
                  Navigator.pushReplacement(
                    context,
                    MaterialPageRoute(builder: (_) => const LoginScreen()),
                  );
                },
                child: const Text('¿Ya tienes cuenta? Inicia sesión'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

🏠 Pantalla Home - home_screen.dart

import 'package:flutter/material.dart';
import '../models/user.dart';

/// Pantalla básica de inicio después del login
class HomeScreen extends StatelessWidget {
  final User user;

  const HomeScreen({Key? key, required this.user}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Inicio'),
        actions: [
          IconButton(
            icon: const Icon(Icons.logout),
            onPressed: () {
              Navigator.of(context).pushNamedAndRemoveUntil(
                '/',
                (route) => false,
              );
            },
          ),
        ],
      ),
      body: Center(
        child: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              const Icon(
                Icons.check_circle,
                size: 100,
                color: Colors.green,
              ),
              const SizedBox(height: 24),
              const Text(
                '¡Sesión iniciada!',
                style: TextStyle(
                  fontSize: 24,
                  fontWeight: FontWeight.bold,
                ),
              ),
              const SizedBox(height: 16),
              Text(
                'Bienvenido, ${user.name}',
                style: const TextStyle(fontSize: 18),
              ),
              const SizedBox(height: 8),
              Text(
                user.email,
                style: const TextStyle(
                  fontSize: 16,
                  color: Colors.grey,
                ),
              ),
              if (user.token != null) ...[
                const SizedBox(height: 24),
                const Text(
                  'Token guardado:',
                  style: TextStyle(fontWeight: FontWeight.bold),
                ),
                const SizedBox(height: 8),
                Container(
                  padding: const EdgeInsets.all(12),
                  decoration: BoxDecoration(
                    color: Colors.grey[200],
                    borderRadius: BorderRadius.circular(8),
                  ),
                  child: Text(
                    user.token!.substring(0, 30) + '...',
                    style: const TextStyle(
                      fontSize: 12,
                      fontFamily: 'monospace',
                    ),
                  ),
                ),
              ],
            ],
          ),
        ),
      ),
    );
  }
}

🖥️ Backend PHP - api.php

<?php
/**
 * API BACKEND BÁSICA DE EJEMPLO PARA lib2
 * 
 * Este es un ejemplo MUY básico de una API REST en PHP
 * para usar con la aplicación Flutter de lib2
 * 
 * IMPORTANTE: Este código es solo para desarrollo/guía.
 * NO usar en producción sin mejorar la seguridad.
 */

header('Content-Type: application/json');
header('Access-Control-Allow-Origin: *');
header('Access-Control-Allow-Methods: POST, GET, OPTIONS');
header('Access-Control-Allow-Headers: Content-Type, Authorization');

// Manejar preflight requests
if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
    http_response_code(200);
    exit();
}

// Base de datos simple (usar MySQL en producción)
$usersFile = __DIR__ . '/users.json';
if (!file_exists($usersFile)) {
    file_put_contents($usersFile, json_encode([]));
}

function getUsers() {
    global $usersFile;
    return json_decode(file_get_contents($usersFile), true) ?: [];
}

function saveUsers($users) {
    global $usersFile;
    file_put_contents($usersFile, json_encode($users, JSON_PRETTY_PRINT));
}

function generateToken() {
    return bin2hex(random_bytes(32));
}

// Parsear la ruta
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$method = $_SERVER['REQUEST_METHOD'];

// REGISTRO
if ($path === '/api/3/register' && $method === 'POST') {
    $input = json_decode(file_get_contents('php://input'), true);
    
    $name = $input['name'] ?? '';
    $email = $input['email'] ?? '';
    $password = $input['password'] ?? '';
    
    if (empty($name) || empty($email) || empty($password)) {
        http_response_code(400);
        echo json_encode(['error' => 'Todos los campos son requeridos']);
        exit;
    }
    
    $users = getUsers();
    
    // Verificar si el email ya existe
    foreach ($users as $user) {
        if ($user['email'] === $email) {
            http_response_code(400);
            echo json_encode(['error' => 'El email ya está registrado']);
            exit;
        }
    }
    
    // Crear nuevo usuario
    $newUser = [
        'id' => count($users) + 1,
        'name' => $name,
        'email' => $email,
        'password' => password_hash($password, PASSWORD_DEFAULT),
        'token' => generateToken(),
    ];
    
    $users[] = $newUser;
    saveUsers($users);
    
    // No enviar la password en la respuesta
    unset($newUser['password']);
    
    http_response_code(201);
    echo json_encode(['user' => $newUser]);
    exit;
}

// LOGIN
if ($path === '/api/3/login' && $method === 'POST') {
    $input = json_decode(file_get_contents('php://input'), true);
    
    $email = $input['email'] ?? '';
    $password = $input['password'] ?? '';
    
    if (empty($email) || empty($password)) {
        http_response_code(400);
        echo json_encode(['error' => 'Email y contraseña requeridos']);
        exit;
    }
    
    $users = getUsers();
    
    foreach ($users as &$user) {
        if ($user['email'] === $email) {
            if (password_verify($password, $user['password'])) {
                // Generar nuevo token
                $user['token'] = generateToken();
                saveUsers($users);
                
                // No enviar la password
                $responseUser = $user;
                unset($responseUser['password']);
                
                http_response_code(200);
                echo json_encode(['user' => $responseUser]);
                exit;
            }
        }
    }
    
    http_response_code(401);
    echo json_encode(['error' => 'Credenciales incorrectas']);
    exit;
}

// OBTENER USUARIO (requiere autenticación)
if ($path === '/api/3/user' && $method === 'GET') {
    $headers = getallheaders();
    $authHeader = $headers['Authorization'] ?? '';
    
    if (empty($authHeader) || !preg_match('/Bearer\\s+(.*)$/i', $authHeader, $matches)) {
        http_response_code(401);
        echo json_encode(['error' => 'Token no proporcionado']);
        exit;
    }
    
    $token = $matches[1];
    $users = getUsers();
    
    foreach ($users as $user) {
        if (isset($user['token']) && $user['token'] === $token) {
            unset($user['password']);
            unset($user['token']);
            
            http_response_code(200);
            echo json_encode($user);
            exit;
        }
    }
    
    http_response_code(401);
    echo json_encode(['error' => 'Token inválido']);
    exit;
}

// Ruta no encontrada
http_response_code(404);
echo json_encode(['error' => 'Endpoint no encontrado']);

🔌 Extensión Cliente - Cliente.php

<?php
namespace FacturaScripts\Plugins\ReparacionesRK\Extension\Model;
use FacturaScripts\Core\Model\Apikey;
use FacturaScripts\Core\Tools;
use FacturaScripts\Core\Where;
use Closure;

class Cliente
{
    public function saveInsert(): Closure
    {       
        return function() {
            if (empty($this->password)) {
                return;
            }
            
            $apikey = new ApiKey();
            $apikey->dni = $this->cifnif;
            $apikey->description = $this->email;
            $apikey->fullaccess = true;
            $apikey->apikey = $this->password;
            
            if ($apikey->save()) {
                Tools::log()->info('API Key creada para cliente: ' . $this->codcliente);
            } else {
                Tools::log()->error('Error creando API Key para cliente: ' . $this->codcliente);
            }
        };
    }

    public function saveUpdate(): Closure
    {
        return function() {
            if (empty($this->password)) {
                return;
            }
            
            // Buscar API Key existente por descripción (email)
            $apikey = new ApiKey();
            $where = [
                Where::eq('description', $this->email)
            ];
            
            $existingKeys = $apikey->all($where);
            
            if (!empty($existingKeys)) {
                // Actualizar todas las API Keys encontradas
                foreach ($existingKeys as $key) {
                    $key->apikey = $this->password;
                    if ($key->save()) {
                        Tools::log()->info('API Key actualizada para cliente: ' . $this->codcliente . ' (ID: ' . $key->id . ')');
                    } else {
                        Tools::log()->error('Error actualizando API Key ID: ' . $key->id . ' para cliente: ' . $this->codcliente);
                    }
                }
            } else {
                // Si no existe, crear una nueva
                $newApikey = new ApiKey();
                $newApikey->description = $this->email;
                $newApikey->fullaccess = true;
                $newApikey->apikey = $this->password;
                
                if ($newApikey->save()) {
                    Tools::log()->info('API Key creada para cliente existente: ' . $this->codcliente);
                } else {
                    Tools::log()->error('Error creando API Key para cliente existente: ' . $this->codcliente);
                }
            }
        };
    }
}

Iniciar Sesión

Recuperar contraseña

Crear Cuenta

📱 ¿Qué es este sistema?

Sistema Completo de Autenticación

Arquitectura del Sistema

📁 Estructura del Proyecto

🔍 Explora los Componentes

Punto de Entrada

Configuración API

Modelo User

Auth Service

Pantalla Login

Pantalla Registro

Pantalla Home

Backend PHP

Extensión Cliente

Init Plugin

Config Plugin

🔄 Flujo de Funcionamiento

1️⃣ Registro de Usuario

2️⃣ Login de Usuario

3️⃣ Integración con FacturaScripts

🔧 Explicación Técnica Detallada

🎯 Patrón Service Layer

🔐 Gestión de Tokens

🏗️ Extensión de Modelos

🔗 Cómo se Conectan Flutter y FacturaScripts

Crear Cliente en FacturaScripts

Plugin Genera API Key

Usuario Login en App

App Accede a FacturaScripts

📋 Requisitos y Dependencias

Flutter (pubspec.yaml)

Backend PHP

FacturaScripts

✅ Mejores Prácticas Implementadas

🛡️ Seguridad

🎨 UX/UI

🏗️ Arquitectura

🔧 Solución de Problemas Comunes

❌ Error de CORS

🔐 API Key no se crea

📱 App no conecta

🔑 Token inválido

🚀 Mejoras Sugeridas

1. Persistencia de Sesión

2. Gestión de Estado

3. Base de Datos Real

4. Seguridad Avanzada

🚀 Punto de Entrada - main.dart

📖 Explicación

⚙️ Configuración API - api_config.dart

📖 Explicación

👤 Modelo User - user.dart

📖 Explicación

🔐 Servicio de Autenticación - auth_service.dart

📖 Explicación

🔑 Pantalla de Login - login_screen.dart

📖 Explicación

📝 Pantalla de Registro - register_screen.dart

📖 Explicación

🏠 Pantalla Home - home_screen.dart

📖 Explicación

🖥️ Backend PHP - api.php

📖 Explicación

🔌 Extensión Cliente - Cliente.php

📖 Explicación

⚡ Inicialización Plugin - Init.php

📖 Explicación

📄 Configuración Plugin - facturascripts.ini

📖 Explicación