Contribución a Proyectos de Código Abierto

Participar en proyectos de software libre es una práctica fundamental para cualquier desarrollador. El flujo de trabajo estándar para colaborar en repositorios alojados en plataformas como GitHub o Gitee sigue estos pasos técnicos:

1. Fork: Crear una copia del repositorio original en su propia cuenta para tener permisos de escritura.
2. Clonación y Desarrollo: Descargar el código localmente, implementar mejoras o correcciones de errores y realizar el push hacia su repositorio remoto.
3. Pull Request (PR): Notificar al mantenedor original sobre los cambios realizados, detallando la lógica aplicada y esperando la revisión para la fusión del código.

Gestión de Versiones con Git en PyCharm

PyCharm ofrece una interfaz robusta para gestionar el control de versiones sin depender exclusivamente de la terminal. Para comenzar, es necesario configurar la ruta del ejecutable de Git en File -> Settings -> Version Control -> Git.

Una vez configurado, el entorno permite realizar operaciones comunes como commit, push, pull y gestión de ramas de forma visual, facilitando el seguimiento de cambios y la resolución de conflictos mediante su herramienta de combinación (merge tool) integrada.

Análisis de Funcionalidades de Usuario: Registro y Acceso

En el desarollo de aplicaciones modernas, el sistema de autenticación debe ser flexible. Analizaremos la implementación de dos servicios clave: la verificación de disponibilidad de móvil y el inicio de sesión híbrido.

1. Verificación de Existencia de Teléfono

Este endpoint permite al frontend validar si un número telefónico ya está registrado antes de proceder con el envío de códigos SMS o el registro de cuenta.

from rest_framework.viewsets import GenericViewSet
from rest_framework.decorators import action
from rest_framework.response import Response
from .models import Account

class AccountViewSet(GenericViewSet):
    
    @action(methods=['GET'], detail=False)
    def verify_phone(self, request, *args, **kwargs):
        target_phone = request.query_params.get('phone_number')
        
        # Validamos la existencia mediante un filtro eficiente
        account_exists = Account.objects.filter(phone=target_phone).exists()
        
        if not account_exists:
            return Response({'status': 0, 'message': 'Número no registrado'})
            
        return Response({'status': 1, 'message': 'El número ya existe en el sistema'})

2. Sistema de Autenticación Multimodal

El objetivo es permitir que el usuario acceda utilizando su nombre de usuario, correo electrónico o teléfono, acompañado de su contraseña.

# serializers.py
import re
from rest_framework import serializers
from rest_framework.exceptions import AuthenticationFailed
from .models import Account
from .utils import create_token

class AuthSerializer(serializers.ModelSerializer):
    identifier = serializers.CharField()

    class Meta:
        model = Account
        fields = ['identifier', 'password']

    def validate(self, data):
        user_instance = self._find_user(data.get('identifier'))
        password_raw = data.get('password')

        if user_instance and user_instance.check_password(password_raw):
            generated_token = create_token(user_instance)
            # Almacenamos datos en el contexto para el ViewSet
            self.context['account'] = user_instance
            self.context['access_token'] = generated_token
            return data
            
        raise AuthenticationFailed('Credenciales inválidas')

    def _find_user(self, identifier):
        # Lógica de búsqueda por múltiples campos
        if re.match(r'^1[3-9]\d{9}$', identifier):
            return Account.objects.filter(phone=identifier).first()
        elif '@' in identifier:
            return Account.objects.filter(email=identifier).first()
        return Account.objects.filter(username=identifier).first()

# views.py
class AuthViewSet(GenericViewSet):
    serializer_class = AuthSerializer

    @action(methods=['POST'], detail=False)
    def user_login(self, request):
        serializer = self.get_serializer(data=request.data)
        serializer.is_valid(raise_exception=True)
        
        return Response({
            'msg': 'Acceso concedido',
            'user': serializer.context.get('account').username,
            'token': serializer.context.get('access_token')
        })

Utilidad para Generación de JWT

Utilizamos JSON Web Tokens para manejar la persistencia de la sesión de manera stateless.

import datetime
from rest_framework_jwt.settings import api_settings

encode_jwt = api_settings.JWT_ENCODE_HANDLER

def create_token(user):
    claims = {
        'identity': user.pk,
        'name': user.username,
        'expiration': (datetime.datetime.utcnow() + datetime.timedelta(hours=12)).timestamp()
    }
    return encode_jwt(claims)

Implementación de Servicios de Mensajería (Tencent Cloud)

Para habilitar el inicio de sesión vía SMS, es necesario integrar un proveeedor externo. En el caso de Tencent Cloud, el proceso técnico requiere:

1. Configuración de Identidad: Registrarse en la plataforma y completar la verificación de identidad (requiere una cuenta válida o suscripción de servicio).
2. Gestión de Firmas: Solicitar una "Firma" (Signature) que identifique a la empresa o proyecto en los mensajes enviados.
3. Plantillas de Texto: Crear plantillas con variables dinámicas (como el código de verificcaión {1}) que deben ser aprobadas por el equipo de cumplimiento.
4. Integración de SDK: Utilizar el SDK oficial para Python para invocar el método de envío de mensajes, proporcionando el SecretId, SecretKey y los IDs de plantilla obtenidos anteriormente.