""" FastAPI Admin Router (/api/v1) Provides modular endpoints for User Administration, RBAC Roles, Security Impersonation, System Reset, Audit Logs, Settings (SMTP/Moodle/Google) and Moodle Queue operations. """ from typing import Optional, List, Dict, Any from fastapi import APIRouter, Depends, HTTPException, Query, status, Request from sqlalchemy import func, or_ from datetime import datetime, timezone from app import db from app.models.user import User from app.models.role import Role, Permission, SYSTEM_MODULES from app.models.audit_log import AuditLog from app.models.setting import SystemSetting from app.models.sync_task import MoodleSyncTask from app.services.audit_service import AuditService from app.services.moodle_queue_service import moodle_queue_service from app.constants.document_types import DOCUMENT_TYPES, validate_document from dependencies import get_current_user, require_roles from database import get_flask_app admin_router = APIRouter(prefix="/api/v1", tags=["Administration & Settings"]) flask_app = get_flask_app() # ========================================================= # USERS CRUD ENDPOINTS # ========================================================= @admin_router.get("/users") @admin_router.get("/admin/users") def get_users( search: Optional[str] = Query(None), role_id: Optional[int] = Query(None, alias="role"), status_filter: Optional[str] = Query(None, alias="status"), current_user: User = Depends(require_roles(["ADMIN", "BEDELIA"])) ): """Lista usuarios del sistema con filtros de búsqueda y rol.""" with flask_app.app_context(): query = User.query if search: s_clean = search.strip().lower() query = query.filter( or_( User.name.ilike(f'%{s_clean}%'), User.email.ilike(f'%{s_clean}%'), User.personal_email.ilike(f'%{s_clean}%'), User.document_number.ilike(f'%{s_clean}%'), User.first_name.ilike(f'%{s_clean}%'), User.last_name.ilike(f'%{s_clean}%') ) ) if role_id: query = query.filter(User.role_id == role_id) if status_filter == 'active': query = query.filter(User.is_active == True) elif status_filter == 'inactive': query = query.filter(User.is_active == False) users = query.order_by(User.id.asc()).all() roles = Role.query.order_by(Role.name.asc()).all() users_data = [] for u in users: d = u.to_dict() d['role_obj'] = { 'id': u.role_obj.id, 'name': u.role_obj.name } if u.role_obj else {'id': 1, 'name': u.role or 'Admin'} users_data.append(d) roles_data = [{'id': r.id, 'name': r.name} for r in roles] return { 'status': 'success', 'total': len(users_data), 'users': users_data, 'roles': roles_data, 'document_types': DOCUMENT_TYPES } @admin_router.post("/users", status_code=status.HTTP_201_CREATED) @admin_router.post("/admin/users", status_code=status.HTTP_201_CREATED) async def create_user( request: Request, current_user: User = Depends(require_roles(["ADMIN", "BEDELIA"])) ): """Crea un nuevo usuario en la plataforma con soporte para sincronización hacia Moodle.""" data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) with flask_app.app_context(): email = (data.get('email') or '').strip().lower() first_name = (data.get('first_name') or '').strip() last_name = (data.get('last_name') or '').strip() name = (data.get('name') or f"{first_name} {last_name}").strip() role_name = (data.get('role') or 'docente').strip().upper() role_id = data.get('role_id') phone = (data.get('phone') or '').strip() personal_email = (data.get('personal_email') or '').strip().lower() address = (data.get('address') or '').strip() document_type = (data.get('document_type') or 'DNI').strip().upper() document_number = (data.get('document_number') or '').strip() password = data.get('password') is_active = data.get('is_active', True) if isinstance(is_active, str): is_active = is_active.lower() in ['true', '1', 'on'] if not email or not name: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="El email y nombre completo son requeridos.") if User.query.filter(User.email.ilike(email)).first(): raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=f"Ya existe un usuario con el email {email}.") if document_number: is_valid, clean_doc, err_msg = validate_document(document_type, document_number) if not is_valid: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=err_msg) document_number = clean_doc if User.query.filter_by(document_type=document_type, document_number=document_number).first(): raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=f"El documento {document_type} {document_number} ya está registrado.") user = User( email=email, name=name, first_name=first_name or (name.split()[0] if name else ''), last_name=last_name or (' '.join(name.split()[1:]) if len(name.split()) > 1 else ''), phone=phone or None, personal_email=personal_email or None, address=address or None, document_type=document_type, document_number=document_number, role=role_name, role_id=int(role_id) if (role_id and str(role_id).strip().isdigit()) else None, is_active=bool(is_active) ) user.set_password(password or 'edu-space2026') db.session.add(user) db.session.commit() # Encolar creación en Moodle si aplica try: username = user.email.split('@')[0].lower() moodle_queue_service.enqueue_task( action='CREATE_USER', entity_type='user', entity_id=str(user.id), payload={ 'username': username, 'email': user.email, 'firstname': user.first_name or 'Docente', 'lastname': user.last_name or 'EduSpace', 'password': password or 'EduSpace2026*' } ) except Exception: pass return { 'status': 'success', 'message': 'Usuario creado exitosamente.', 'user': user.to_dict() } @admin_router.get("/users/{id}") def get_user_detail( id: int, current_user: User = Depends(require_roles(["ADMIN", "BEDELIA"])) ): """Obtiene el detalle de un usuario por su identificador.""" with flask_app.app_context(): user = User.query.get(id) if not user: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Usuario con ID {id} no encontrado.") d = user.to_dict() d['role_obj'] = { 'id': user.role_obj.id, 'name': user.role_obj.name } if user.role_obj else {'id': 1, 'name': user.role or 'Admin'} return { 'status': 'success', 'user': d } @admin_router.put("/users/{id}") async def update_user( id: int, request: Request, current_user: User = Depends(require_roles(["ADMIN", "BEDELIA"])) ): """Actualiza los datos de un usuario.""" data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) with flask_app.app_context(): user = User.query.get(id) if not user: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Usuario con ID {id} no encontrado.") first_name = (data.get('first_name', user.first_name or '')).strip() last_name = (data.get('last_name', user.last_name or '')).strip() name = (data.get('name') or '').strip() if 'first_name' in data or 'last_name' in data: user.first_name = first_name user.last_name = last_name user.name = f"{first_name} {last_name}".strip() elif name: user.name = name parts = name.split() user.first_name = parts[0] if parts else '' user.last_name = ' '.join(parts[1:]) if len(parts) > 1 else '' if 'phone' in data: user.phone = (data['phone'] or '').strip() if 'personal_email' in data: user.personal_email = (data['personal_email'] or '').strip().lower() if 'address' in data: user.address = (data['address'] or '').strip() if 'document_type' in data or 'document_number' in data: doc_type = (data.get('document_type') or user.document_type or 'DNI').strip().upper() doc_num = (data.get('document_number') or user.document_number or '').strip() if doc_num: is_valid, clean_doc, err_msg = validate_document(doc_type, doc_num) if not is_valid: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=err_msg) doc_num = clean_doc existing_doc = User.query.filter( User.document_type == doc_type, User.document_number == doc_num, User.id != id ).first() if existing_doc: raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=f'El documento {doc_type} {doc_num} ya está asignado a otro usuario.') user.document_type = doc_type user.document_number = doc_num if 'email' in data and data['email']: email = data['email'].strip().lower() existing = User.query.filter(User.email.ilike(email), User.id != id).first() if existing: raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=f'El email {email} ya está registrado por otro usuario.') user.email = email if 'role_id' in data: r_id = data['role_id'] user.role_id = int(r_id) if (r_id and str(r_id).strip().isdigit()) else None if user.role_id: r_obj = Role.query.get(user.role_id) if r_obj: user.role = r_obj.name.upper() if 'is_active' in data: val = data['is_active'] user.is_active = val in [True, 'true', '1', 'on'] db.session.commit() return { 'status': 'success', 'message': 'Usuario actualizado exitosamente.', 'user': user.to_dict() } @admin_router.post("/users/{id}/toggle") def toggle_user( id: int, current_user: User = Depends(require_roles(["ADMIN", "BEDELIA"])) ): """Conmuta el estado activo/inactivo de un usuario.""" with flask_app.app_context(): user = User.query.get(id) if not user: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Usuario con ID {id} no encontrado.") user.is_active = not user.is_active db.session.commit() return { 'status': 'success', 'id': user.id, 'is_active': user.is_active, 'message': f'Usuario {"activado" if user.is_active else "desactivado"} correctamente.' } @admin_router.delete("/users/{id}") def delete_user( id: int, current_user: User = Depends(require_roles(["ADMIN", "BEDELIA"])) ): """Elimina permanentemente un usuario o lo desactiva si tiene reservas.""" with flask_app.app_context(): user = User.query.get(id) if not user: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Usuario con ID {id} no encontrado.") has_reservations = len(user.reservations) if user.reservations else 0 if has_reservations > 0: user.is_active = False db.session.commit() return { 'status': 'success', 'message': 'El usuario tiene reservas asociadas. Se ha desactivado en su lugar.' } db.session.delete(user) db.session.commit() return { 'status': 'success', 'message': 'Usuario eliminado permanentemente.' } # ========================================================= # ROLES & RBAC ENDPOINTS # ========================================================= @admin_router.get("/roles") @admin_router.get("/admin/roles") def get_roles( current_user: User = Depends(get_current_user) ): """Lista todos los roles institucionales y sus matrices de permisos por módulo.""" with flask_app.app_context(): roles = Role.query.order_by(Role.id.asc()).all() modules = [ {'id': 'dashboard', 'name': 'Dashboard', 'icon': 'bi-speedometer2'}, {'id': 'classrooms', 'name': 'Aulas y Espacios', 'icon': 'bi-door-open'}, {'id': 'schedule', 'name': 'Cronograma', 'icon': 'bi-calendar3'}, {'id': 'subjects', 'name': 'Asignaturas', 'icon': 'bi-book'}, {'id': 'careers', 'name': 'Carreras', 'icon': 'bi-mortarboard'}, {'id': 'commissions', 'name': 'Comisiones', 'icon': 'bi-diagram-3'}, {'id': 'users', 'name': 'Usuarios', 'icon': 'bi-people'}, {'id': 'roles', 'name': 'Roles (RBAC)', 'icon': 'bi-shield-check'}, {'id': 'optimizer', 'name': 'Optimizador IA', 'icon': 'bi-cpu'}, {'id': 'audit', 'name': 'Auditoría', 'icon': 'bi-clipboard-data'} ] roles_data = [] for r in roles: perms_map = {} for p in r.permissions: perms_map[p.module] = p.access_level roles_data.append({ 'id': r.id, 'name': r.name, 'description': r.description or f'Rol institucional de {r.name}', 'is_system': getattr(r, 'is_system', True), 'users_count': len(r.users) if r.users else 0, 'users': [{'id': u.id, 'name': u.name} for u in (r.users or [])], 'permissions': perms_map }) return { 'status': 'success', 'roles': roles_data, 'modules': modules } @admin_router.post("/roles", status_code=status.HTTP_201_CREATED) async def create_role( request: Request, current_user: User = Depends(require_roles(["ADMIN"])) ): """Crea un nuevo rol y configura sus permisos iniciales.""" data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) with flask_app.app_context(): name = (data.get('name') or '').strip() description = (data.get('description') or '').strip() raw_perms = data.get('permissions', {}) if isinstance(raw_perms, str): try: import json permissions = json.loads(raw_perms) except Exception: permissions = {} elif isinstance(raw_perms, dict): permissions = raw_perms else: permissions = {} if not name: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="El nombre del rol es obligatorio.") if Role.query.filter(Role.name.ilike(name)).first(): raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=f"Ya existe un rol llamado {name}.") role = Role(name=name, description=description, is_system=False) db.session.add(role) db.session.flush() for mod, level in permissions.items(): role.set_permission(mod, level) db.session.commit() return { 'status': 'success', 'message': 'Rol creado exitosamente.', 'role': role.to_dict() } @admin_router.delete("/roles/{id}") def delete_role( id: int, current_user: User = Depends(require_roles(["ADMIN"])) ): """Elimina un rol del sistema.""" with flask_app.app_context(): role = Role.query.get(id) if not role: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Rol con ID {id} no encontrado.") if getattr(role, 'is_system', False): raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="No se pueden eliminar roles protegidos del sistema.") db.session.delete(role) db.session.commit() return { 'status': 'success', 'message': 'Rol eliminado permanentemente.' } # ========================================================= # IMPERSONATION ENDPOINTS # ========================================================= @admin_router.post("/admin/impersonate") async def impersonate_user( request: Request, current_user: User = Depends(require_roles(["ADMIN"])) ): """Permite a un administrador auditar el sistema bajo la perspectiva de otro usuario.""" data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) with flask_app.app_context(): user_id = data.get('user_id') if not user_id: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Se requiere el user_id para impersonar.") target_user = User.query.get(int(user_id)) if not target_user: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Usuario destino #{user_id} no encontrado.") AuditService.log( action='IMPERSONATE_START', module='admin', entity_id=target_user.id, user=current_user, details=f"Administrador {current_user.email} inició sesión como {target_user.email} ({target_user.role})" ) return { 'status': 'success', 'message': f"Iniciando impersonación de {target_user.name} ({target_user.email})", 'user': { 'id': target_user.id, 'name': target_user.name, 'email': target_user.email, 'role': target_user.role } } @admin_router.post("/admin/stop-impersonating") def stop_impersonating( current_user: User = Depends(get_current_user) ): """Restaura la sesión administrativa original.""" with flask_app.app_context(): AuditService.log( action='IMPERSONATE_STOP', module='admin', entity_id=current_user.id, user=current_user, details=f"Finalizó la sesión de impersonación. Sesión restaurada a {current_user.email}." ) return { 'status': 'success', 'message': 'Sesión de impersonación finalizada exitosamente.' } # ========================================================= # SYSTEM RESET ENDPOINT # ========================================================= @admin_router.post("/system/reset") @admin_router.post("/admin/system/reset") @admin_router.post("/admin/settings/reset_system") async def reset_system( request: Request, current_user: User = Depends(require_roles(["ADMIN"])) ): """ Reinicializa el sistema depurando historiales, reservas, espacios y datos académicos. Preserva intactas las cuentas de usuario, roles RBAC y configuraciones institucionales. """ data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) password = str(data.get('password') or '').strip() if not password: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="Debe ingresar la contraseña de su usuario administrador para autorizar la reinicialización." ) with flask_app.app_context(): # Validar contraseña del administrador admin = User.query.get(current_user.id) if not admin or not admin.check_password(password): try: AuditService.log( action='SYSTEM_RESET_FAILED', module='admin', entity_id=current_user.id, user=current_user, details="Intento de reinicialización del sistema cancelado: contraseña incorrecta." ) except Exception: pass raise HTTPException( status_code=status.HTTP_401_UNAUTHORIZED, detail="Contraseña de administrador incorrecta. Operación cancelada por seguridad." ) from app.models.reservation import Reservation from app.models.grade import MilestoneGrade from app.models.enrollment import StudentEnrollment from app.models.classroom import Classroom, ClassroomResource from app.models.building import Building from app.models.subject import Subject, Commission, CommissionTeacher from app.models.career import Career from app.models.academic_term import AcademicTerm reservations_deleted = Reservation.query.delete() grades_deleted = MilestoneGrade.query.delete() milestones_deleted = AcademicMilestone.query.delete() enrollments_deleted = StudentEnrollment.query.delete() teachers_deleted = CommissionTeacher.query.delete() commissions_deleted = Commission.query.delete() subjects_deleted = Subject.query.delete() careers_deleted = Career.query.delete() resources_deleted = ClassroomResource.query.delete() classrooms_deleted = Classroom.query.delete() buildings_deleted = Building.query.delete() terms_deleted = AcademicTerm.query.delete() moodle_deleted = MoodleSyncTask.query.delete() db.session.commit() AuditService.log( action='SYSTEM_RESET_SUCCESS', module='admin', entity_id=current_user.id, user=current_user, details=f"Sistema reinicializado. Purgados: {reservations_deleted} reservas, {classrooms_deleted} aulas, {subjects_deleted} materias." ) return { 'status': 'success', 'message': 'El sistema ha sido reinicializado exitosamente. Todos los usuarios, roles y configuraciones fueron preservados.', 'purged': { 'reservations': reservations_deleted, 'grades': grades_deleted, 'milestones': milestones_deleted, 'enrollments': enrollments_deleted, 'teachers_assignments': teachers_deleted, 'commissions': commissions_deleted, 'subjects': subjects_deleted, 'careers': careers_deleted, 'classrooms': classrooms_deleted, 'buildings': buildings_deleted, 'academic_terms': terms_deleted, 'sync_tasks': moodle_deleted } } # ========================================================= # AUDIT LOGS ENDPOINTS # ========================================================= @admin_router.get("/audit-logs") @admin_router.get("/audit_logs", include_in_schema=False) @admin_router.get("/admin/audit-logs", include_in_schema=False) def get_audit_logs( module: Optional[str] = Query(None), action: Optional[str] = Query(None), user_id: Optional[int] = Query(None), limit: int = Query(50), current_user: User = Depends(require_roles(["ADMIN"])) ): """Consulta la bitácora inmutable de auditoría del sistema.""" with flask_app.app_context(): logs = AuditService.get_logs(module=module, action=action, user_id=user_id, limit=limit) return { 'status': 'success', 'total': len(logs), 'logs': [log.to_dict() for log in logs] } # ========================================================= # USER AUXILIARY ENDPOINTS # ========================================================= @admin_router.get("/users/document-types") @admin_router.get("/admin/users/document-types") def get_document_types(): """Retorna los tipos de documentos válidos.""" return { 'status': 'success', 'document_types': DOCUMENT_TYPES } @admin_router.post("/users/{id}/password") @admin_router.put("/users/{id}/password") @admin_router.post("/admin/users/{id}/password") @admin_router.put("/admin/users/{id}/password") async def reset_user_password( id: int, request: Request, current_user: User = Depends(require_roles(["ADMIN"])) ): """Permite a los administradores institucionales restablecer la contraseña de un usuario.""" data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) new_password = str(data.get('password') or data.get('new_password') or '').strip() if not new_password or len(new_password) < 6: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="La nueva contraseña debe contener al menos 6 caracteres." ) with flask_app.app_context(): user = User.query.get(id) if not user: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Usuario con ID {id} no encontrado.") user.set_password(new_password) db.session.commit() AuditService.log( action='RESET_PASSWORD', module='users', entity_id=user.id, user=current_user, details=f"Contraseña restablecida para el usuario {user.email}" ) return { 'status': 'success', 'message': f'Contraseña restablecida exitosamente para {user.name}.', 'user_id': user.id } # ========================================================= # GLOBAL SYSTEM SETTINGS (SMTP, AUTH, GOOGLE, MOODLE, UI) # ========================================================= @admin_router.get("/settings/all") @admin_router.get("/admin/settings/all") def get_all_settings(current_user: User = Depends(require_roles(["ADMIN"]))): """Retorna todas las configuraciones agrupadas por módulo, enmascarando contraseñas.""" with flask_app.app_context(): smtp_config = { 'host': SystemSetting.get_value('smtp_host', 'smtp.gmail.com'), 'port': int(SystemSetting.get_value('smtp_port', 587) or 587), 'user': SystemSetting.get_value('smtp_user', ''), 'password': SystemSetting.get_masked_value('smtp_password', ''), 'security': SystemSetting.get_value('smtp_security', 'STARTTLS'), 'sender_email': SystemSetting.get_value('smtp_sender_email', 'notificaciones@unicaba.edu.ar'), 'sender_name': SystemSetting.get_value('smtp_sender_name', 'Edu-Space UniCABA'), 'enabled': SystemSetting.get_value('smtp_enabled', 'true') in ['true', 'True', '1', True] } auth_providers = { 'local': SystemSetting.get_value('auth_local_enabled', 'true') in ['true', 'True', '1', True], 'local_enabled': SystemSetting.get_value('auth_local_enabled', 'true') in ['true', 'True', '1', True], 'google': SystemSetting.get_value('auth_google_enabled', 'false') in ['true', 'True', '1', True], 'google_enabled': SystemSetting.get_value('auth_google_enabled', 'false') in ['true', 'True', '1', True], 'moodle': SystemSetting.get_value('auth_moodle_enabled', 'false') in ['true', 'True', '1', True], 'moodle_enabled': SystemSetting.get_value('auth_moodle_enabled', 'false') in ['true', 'True', '1', True] } google_oauth = { 'client_id': SystemSetting.get_value('google_client_id', ''), 'client_secret': SystemSetting.get_masked_value('google_client_secret', ''), 'callback_url': SystemSetting.get_value('google_callback_url', '/auth/google/callback'), 'allowed_domains': SystemSetting.get_value('google_allowed_domains', 'unicaba.edu.ar,lasalle.edu.ar') } moodle_config = { 'server_url': SystemSetting.get_value('moodle_server_url', 'http://10.0.0.207/moodle'), 'ws_token': SystemSetting.get_masked_value('moodle_ws_token', ''), 'timeout': int(SystemSetting.get_value('moodle_timeout', 10) or 10), 'auto_sync_enabled': SystemSetting.get_value('moodle_auto_sync_enabled', 'true') in ['true', 'True', '1', True], 'sync_interval_minutes': int(SystemSetting.get_value('moodle_sync_interval_minutes', 15) or 15) } ui_config = { 'show_role_banner': SystemSetting.get_value('dashboard_role_banner_enabled', 'true') in ['true', 'True', '1', True] } return { 'status': 'success', 'settings': { 'smtp': smtp_config, 'auth_providers': auth_providers, 'google_oauth': google_oauth, 'moodle': moodle_config, 'ui': ui_config } } @admin_router.post("/settings/smtp") @admin_router.post("/admin/settings/smtp") async def update_smtp_settings( request: Request, current_user: User = Depends(require_roles(["ADMIN"])) ): """Actualiza la configuración del servidor de correo SMTP.""" data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) host = str(data.get('host', '')).strip() port = str(data.get('port', 587)).strip() user = str(data.get('user', '')).strip() password = str(data.get('password', '')).strip() security = str(data.get('security', 'STARTTLS')).strip().upper() sender_email = str(data.get('sender_email', '')).strip() sender_name = str(data.get('sender_name', 'Edu-Space UniCABA')).strip() enabled = 'true' if data.get('enabled') in [True, 'true', '1', 'on'] else 'false' with flask_app.app_context(): SystemSetting.set_value('smtp_host', host, 'Host del servidor SMTP', category='smtp') SystemSetting.set_value('smtp_port', port, 'Puerto del servidor SMTP', category='smtp') SystemSetting.set_value('smtp_user', user, 'Usuario o email de autenticación SMTP', category='smtp') if password and password != '••••••••••••': SystemSetting.set_encrypted_value('smtp_password', password, 'Contraseña de autenticación SMTP cifrada', category='smtp') SystemSetting.set_value('smtp_security', security, 'Protocolo de seguridad SMTP (NONE, SSL, STARTTLS)', category='smtp') SystemSetting.set_value('smtp_sender_email', sender_email, 'Email remitente oficial', category='smtp') SystemSetting.set_value('smtp_sender_name', sender_name, 'Nombre remitente oficial', category='smtp') SystemSetting.set_value('smtp_enabled', enabled, 'Habilitación del servicio SMTP', category='smtp') AuditService.log( action='UPDATE_SMTP_SETTINGS', module='settings', user=current_user, details=f"Configuración SMTP actualizada (Host: {host}:{port}, Remitente: {sender_email})" ) return { 'status': 'success', 'message': 'Configuración de servidor SMTP guardada exitosamente.' } @admin_router.post("/settings/smtp/test") @admin_router.post("/admin/settings/smtp/test") async def test_smtp_connection( request: Request, current_user: User = Depends(require_roles(["ADMIN"])) ): """Prueba en tiempo real la conexión al servidor SMTP.""" import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart data = {} try: data = await request.json() except Exception: form = await request.form() data = dict(form) test_recipient = str(data.get('test_email') or current_user.email).strip() with flask_app.app_context(): host = data.get('host') or SystemSetting.get_value('smtp_host', 'smtp.gmail.com') port = int(data.get('port') or SystemSetting.get_value('smtp_port', 587) or 587) user = data.get('user') or SystemSetting.get_value('smtp_user', '') password = data.get('password') if not password or password == '••••••••••••': password = SystemSetting.get_decrypted_value('smtp_password', '') security_val = data.get('security') or SystemSetting.get_value('smtp_security', 'STARTTLS') or 'STARTTLS' security = str(security_val).upper() sender_email = str(data.get('sender_email') or SystemSetting.get_value('smtp_sender_email', user) or 'notificaciones@unicaba.edu.ar') sender_name = data.get('sender_name') or SystemSetting.get_value('smtp_sender_name', 'Edu-Space UniCABA') if not host or not port: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Host y puerto SMTP son requeridos.") try: if security == 'SSL': server = smtplib.SMTP_SSL(host, port, timeout=10) else: server = smtplib.SMTP(host, port, timeout=10) if security == 'STARTTLS': server.ehlo() server.starttls() server.ehlo() if user and password: server.login(user, password) if test_recipient: msg = MIMEMultipart('alternative') msg['Subject'] = '✔ Prueba de Conexión SMTP - Edu-Space UniCABA' msg['From'] = f"{sender_name} <{sender_email}>" msg['To'] = test_recipient html_content = f"""
Este es un mensaje de prueba para confirmar que los parámetros del servidor de correo han sido configurados correctamente.
Enviado desde el Panel de Administración de UniCABA.