Zergcore.dev V2

Este proyecto, Zergcore, es una aplicación web full-stack moderna construida para una cartera profesional y una plataforma CMS. Presenta una arquitectura desacoplada con un backend de Python de alto rendimiento y un frontend reactivo de TypeScript, diseñado con un enfoque en integraciones de IA y gestión de activos. Resumen del proyecto Zergcore funciona como una sede digital, probablemente gestionando activos profesionales como currículums, proyectos de portafolio y funcionalidades impulsadas por IA (como el “AI CV Architect”). El proyecto está actualmente en transición de un sistema heredado de Django a una pila moderna de FastAPI + Next.js para mejorar el rendimiento, la escalabilidad y la experiencia del desarrollador. Visión general de la arquitectura 1. Backend (El "Cerebro") El backend está construido con FastAPI, enfatizando la velocidad y la seguridad de tipos. Framework: FastAPI para la capa REST API. Base de datos y ORM: SQLAlchemy 2.0 (Asíncrono) con PostgreSQL (a través de asyncpg). Migraciones: Alembic gestiona versiones del esquema de la base de datos. Seguridad: autenticación basada en JWT usando python-jose y bcrypt. Integraciones: - Cloudinary: Maneja el almacenamiento de imágenes y documentos (PDF). - Resend: Gestiona correos electrónicos transaccionales. - Herramientas AI/PDF: Utiliza pypdf para el procesamiento de documentos, con hooks para integraciones LLM. Ruta Legacy: Existe un directorio _legacy_django, que contiene la base de código original que está siendo eliminada. 2. Frontend (La "Cara") El frontend es una aplicación Next.js 15 de vanguardia. Framework: Next.js (App Router) con React 19. Estilado: Tailwind CSS v4 para un sistema de diseño moderno y centrado en utilidades. Animaciones: Framer Motion ofrece micro-animaciones y transiciones de alto nivel. Iconos: Lucide React y React Icons. Seguridad de tipos: Implementación estricta de TypeScript en toda la UI y capas del cliente API. 3. Infraestructura y flujo de trabajo Monorepo-lite: Organizado en directorios claros /backend y /frontend. Despliegue: Listo para Docker (a través del Dockerfile en backend) y optimizado para plataformas como Vercel (frontend) y proveedores de cloud tradicionales. Experiencia de desarrollo: Utiliza uvicorn con uvloop para el servidor de desarrollo del backend y Next.js Turbopack para el frontend. Aspectos destacados de los directorios backend/app/models/: modelos de base de datos SQLAlchemy. backend/app/routers/: endpoints API organizados por funcionalidad. frontend/app/: páginas y diseños del App Router de Next.js. frontend/components/: componentes UI reutilizables. docs/: documentación del proyecto (incluyendo contexto histórico como btw.txt).