Volver al inicio

Documentación

Última actualización:

Te damos la bienvenida a la documentación de SM Supports. Esta guía completa te ayudará a entender nuestro proceso de desarrollo, nuestro stack tecnológico, las integraciones de API y las buenas prácticas para trabajar con nuestros servicios.

Primeros pasos

Sigue estos pasos para empezar con los servicios y proyectos de SM Supports.

  1. Consulta inicial

    Reserva una llamada de consulta gratuita para hablar de los requisitos, los objetivos y los plazos de tu proyecto.

    Reserva una llamada

  2. Planificación del proyecto

    Elaboraremos un plan de proyecto detallado con el alcance, los hitos, los entregables y el calendario. Recibirás una propuesta completa que recoge todos los aspectos del proyecto.

  3. Desarrollo y colaboración

    Nuestro equipo inicia el desarrollo con reuniones de seguimiento y novedades periódicas. Tendrás acceso a entornos de pruebas para revisar el avance y darnos tu opinión durante todo el proceso.

  4. Lanzamiento y soporte

    Tras realizar pruebas exhaustivas y contar con tu aprobación, lanzamos tu proyecto. Ofrecemos soporte, mantenimiento y documentación continuos para garantizar el éxito a largo plazo.

Stack tecnológico

Usamos tecnologías modernas y líderes del sector para crear aplicaciones escalables y de alto rendimiento.

Desarrollo frontend

  • Next.js 15 - Framework de React con App Router
  • React 18 - Biblioteca de UI basada en componentes
  • TypeScript - JavaScript con tipado seguro
  • Tailwind CSS - Framework de CSS basado en utilidades
  • Framer Motion - Biblioteca de animaciones

Backend y API

  • Node.js - Entorno de ejecución de JavaScript
  • Next.js API Routes - Funciones serverless
  • API REST - Arquitectura RESTful
  • Cloudflare Workers - Computación en el edge
  • Resend - Servicio de envío de correo electrónico

Bases de datos y almacenamiento

  • Cloudflare D1 - SQLite serverless
  • PostgreSQL - Base de datos relacional
  • MongoDB - Base de datos NoSQL
  • Redis - Caché en memoria

Plataformas y herramientas

  • Wix - Plataforma de creación de sitios web
  • Velo (Wix Code) - Funcionalidades a medida
  • Git y GitHub - Control de versiones
  • Vercel - Plataforma de despliegue

Referencia de la API

Documentación de nuestros endpoints de API y servicios de integración.

POST /api/contact

Enviar una consulta desde el formulario de contacto

POST

Cuerpo de la solicitud:

{
  "name": "string",
  "email": "string",
  "subject": "string",
  "message": "string"
}

Respuesta (200):

{
  "success": true,
  "message": "Message sent successfully"
}

POST /api/schedule

Reservar una reunión de consulta

POST

Cuerpo de la solicitud:

{
  "name": "string",
  "email": "string",
  "company": "string",
  "date": "string",
  "time": "string",
  "timezone": "string",
  "projectType": "string",
  "description": "string"
}

GET /api/timeslots

Obtener las franjas horarias disponibles para reservar

GET

Parámetros de consulta:

?date=2025-10-02&timezone=America/New_York

Respuesta (200):

{
  "availableSlots": ["09:00", "10:00", "14:00"],
  "bookedSlots": ["11:00", "15:00"]
}

Despliegue y hosting

Desplegamos las aplicaciones en plataformas líderes del sector para lograr un rendimiento y una fiabilidad óptimos.

Vercel (plataforma principal)

Nuestra plataforma principal de despliegue para aplicaciones Next.js, con CI/CD automático, funciones edge y CDN global.

  • Despliegues automáticos desde Git
  • Despliegues de vista previa para cada pull request
  • Red edge con más de 100 ubicaciones
  • Analítica y supervisión integradas

Cloudflare Pages y Workers

Plataforma de computación en el edge para funciones serverless, la base de datos D1 y el alojamiento de sitios estáticos.

  • Base de datos SQLite D1 serverless
  • Workers para computación en el edge
  • Almacenamiento de objetos R2
  • Protección contra DDoS y seguridad

Soluciones de hosting a medida

También trabajamos con otros proveedores de hosting según los requisitos de cada proyecto.

  • AWS (EC2, S3, CloudFront, Lambda)
  • DigitalOcean (Droplets, App Platform)
  • Netlify (sitios estáticos, Edge Functions)
  • Heroku (despliegues en contenedores)

Buenas prácticas

Pautas y recomendaciones para trabajar en los proyectos de SM Supports.

Calidad del código

  • Usa TypeScript para tener seguridad de tipos y una mejor experiencia de desarrollo
  • Sigue las configuraciones de ESLint y Prettier para mantener un estilo de código coherente
  • Escribe mensajes de commit descriptivos siguiendo Conventional Commits
  • Mantén los componentes pequeños, específicos y reutilizables
  • Documenta la lógica compleja y las interfaces de la API

Optimización del rendimiento

  • Optimiza las imágenes con el componente Image de Next.js
  • Aplica carga diferida (lazy loading) al contenido que queda por debajo del pliegue
  • Usa React Server Components siempre que sea posible
  • Reduce el tamaño del bundle con code splitting y tree shaking
  • Almacena en caché de forma adecuada las respuestas de la API y los recursos estáticos

Seguridad

  • Nunca incluyas datos sensibles ni claves de API en el control de versiones
  • Usa variables de entorno para la configuración
  • Implementa una validación y un saneamiento adecuados de los datos de entrada
  • Usa HTTPS en todos los despliegues de producción
  • Mantén las dependencias actualizadas para corregir vulnerabilidades de seguridad

Accesibilidad (A11y)

  • Usa elementos HTML semánticos (nav, main, article, etc.)
  • Añade texto alternativo a todas las imágenes
  • Garantiza relaciones de contraste de color adecuadas
  • Haz que los elementos interactivos sean accesibles con el teclado
  • Haz pruebas con lectores de pantalla y herramientas de accesibilidad

Solución de problemas

Problemas habituales y cómo resolverlos.

Errores de compilación

Problema: La compilación falla con errores de TypeScript o ESLint

Solución:

  • Ejecuta npm run lint para identificar los problemas
  • Comprueba si faltan dependencias en package.json
  • Asegúrate de que todas las importaciones tengan los tipos correctos
  • Borra la carpeta .next y vuelve a compilar

Problemas de conexión con la API

Problema: Los endpoints de la API devuelven errores o agotan el tiempo de espera

Solución:

  • Verifica que las variables de entorno estén bien configuradas
  • Revisa los límites de solicitudes y las cuotas de la API
  • Revisa la configuración de CORS para las solicitudes entre orígenes
  • Supervisa la pestaña Red de las DevTools del navegador

Problemas de rendimiento

Problema: Carga lenta de las páginas o puntuaciones bajas en Lighthouse

Solución:

  • Optimiza las imágenes (usa el formato WebP y el tamaño adecuado)
  • Activa la carga diferida de imágenes y componentes
  • Reduce el tamaño del bundle de JavaScript
  • Usa caché en el edge para las respuestas de la API
  • Implementa estados de carga adecuados

¿Necesitas más ayuda?

¿No encuentras lo que buscas? Nuestro equipo está aquí para ayudarte con cualquier pregunta o con el soporte técnico.

Correo electrónico:
[email protected]
Teléfono:
(+880) 13013-60818
Horario de atención:
De lunes a viernes, de 9:00 a 18:00 (hora de Bangladés, BST)
Contacta con soporteReserva una llamada