Documentacion Tecnica

Hosting Administrado

Servicio integral de alojamiento web con soporte personalizado

Descripcion General

El servicio de Hosting Administrado de De Anda Tech es una solucion integral que permite gestionar, crear y alojar sitios web de manera profesional y sin complicaciones. Actualmente somos un equipo de una sola persona (Daniel de Anda) que brinda soporte personalizado y atencion directa.

Infraestructura Tecnica

• Plataformas de despliegue:
  • AWS (Amazon Web Services) a traves de instancias EC2/VPS
• Registro de dominios:
  • GoDaddy (registro y gestion de dominios)
• Tecnologias soportadas:
  • Sitios estaticos (HTML, CSS, JavaScript)
  • Aplicaciones dinamicas (Node.js, Python, PHP)
  • Bases de datos (MySQL, PostgreSQL, MongoDB)

Equipo y Soporte

• Equipo actual: 1 desarrollador / administrador (Daniel de Anda)
• Soporte: Atencion personalizada y directa
• Disponibilidad: Lunes a viernes, horario flexible

Servicios Incluidos

• Configuracion inicial: Configuracion del entorno de hosting
• Despliegue: Publicacion de sitios web y aplicaciones
• Mantenimiento: Actualizaciones y monitoreo basico
• Soporte tecnico: Asistencia para resolver incidencias
• Gestion de dominios: Configuracion de DNS y redirecciones
• Certificados SSL: Configuracion automatica mediante Let's Encrypt

Costos

Proyeccion a Futuro

• Crecimiento del equipo: Se planea incorporar mas empleados para escalar el servicio a un servidor propio.
• Rentabilidad: El modelo de negocio esta disenado para ser escalable y rentable a medida que crezca la cartera de clientes.
• Expansion: Posibilidad de ofrecer planes adicionales con mayor capacidad y recursos.

Flujo de Trabajo

1. El cliente solicita el servicio de hosting
2. Se configura la infraestructura (AWS)
3. Se registra o transfiere el dominio (GoDaddy)
4. Se despliega el sitio web
5. Se envian las credenciales de GoDaddy y se le dan credenciales para accseder al panel de administracion de el servidor
6. Se realiza mantenimiento continuo
7. Soporte y atencion personalizada

Requisitos Tecnicos

• Dominio: Debe estar registrado o ser transferible
• Contenido: Codigo fuente del sitio web (HTML/CSS/JS, backend)
• Acceso: Credenciales para gestion de DNS si aplica

MIpunto - Sistema POS

Sistema de punto de venta desarrollado en Python con Tkinter

Descripcion General

MIpunto es un sistema de punto de venta (POS) desarrollado en Python con Tkinter para la interfaz grafica. Esta disenado para la gestion de ventas, inventario, empleados y facturacion en pequenas y medianas empresas.

Estructura del Sistema

Total de archivos: 13 archivos Python

Flujo de Trabajo del Sistema

1. Inicio de la aplicacion -> dashboard.py carga la GUI y verifica actualizaciones
2. config.py se conecta a la API (mipunto-server.vercel.app/api)
3. Verificacion de update.json -> Comprueba que archivos necesitan actualizarse
4. Descarga de lms.db -> Si no existe o esta desactualizada, se descarga desde la API
5. actualizaciones.py -> Actualiza el ejecutable (.exe) o paquete (.deb) si es necesario
6. Gestion de datos -> Los modulos trabajan con la base de datos descargada

Requisitos del Sistema

Modulos y Funcionalidades

Dashboard (dashboard.py)

• Carga la interfaz principal
• Gestiona actualizaciones de imagenes y archivos
• Controla la GUI central del sistema

Configuracion (config.py)

• Punto de conexion con la API
• Verifica update.json para nuevos archivos
• Descarga la base de datos lms.db

Actualizaciones (actualizaciones.py)

• Actualiza el archivo ejecutable (.exe en Windows)
• Actualiza el paquete (.deb en Linux)

Gestion de Datos

• categoria.py -> CRUD de categorias de productos
• producto.py -> CRUD de productos e inventario
• proveedor.py -> Gestion de proveedores
• empleados.py -> Gestion de empleados
• ventas.py -> Registro y gestion de ventas
• factura.py -> Emision y gestion de facturas
• recargas.py -> Gestion de recargas
• registros.py -> Logs y registros del sistema

Rutas (paths.py)

• Define las rutas de archivos y directorios del sistema

Base de Datos (lms.db)

• Almacena toda la informacion del sistema
• Se descarga automaticamente desde la API
• Critica: Sin este archivo, la aplicacion falla

Dependencias

• Python 3.x
• Tkinter (interfaz grafica)
• SQLite3 (base de datos)
• Requests (para conexion con la API)
• Internet (para actualizaciones y descarga de la DB)

Instalacion

1. Descargar el ejecutable (.exe) o paquete (.deb) desde el repositorio o la API
2. Ejecutar el instalador
3. La aplicacion verificara automaticamente la conexion a la API
4. Descargara la base de datos lms.db si es necesario
5. El sistema estara listo para usar

Nova Alfa - Asistente Inteligente

Asistente inteligente offline-first con IA local, voz y automatizacion

Descripcion General

Nova Alfa es un asistente inteligente de tipo "alexa" desarrollado en Python diseñada para ser 100% offline. El proyecto combina:

• Un modelo local de lenguaje usando llama-cpp-python
• Una capa de intencion basada en un clasificador serializado (joblib/pickle)
• Un motor de voz con respaldo offline (pyttsx3) y voz natural mediante edge-tts cuando hay internet
• Reconocimiento de voz local mediante pipeline
• Deteccion de wakeword "okay nabu" con OpenWakeWord
• Funcionalidades de automatizacion diaria: musica, notas, alarmas, listas, agenda, clima, investigacion, traduccion y control de dispositivos
• Un arranque/bootstrapping robusto con creacion de carpetas, configuracion, verificacion de red, actualizacion y recuperacion

Flujo del Sistema

┌─────────────────────────────────────────────────────────────────────────────────────┐
│                              INICIO DEL SISTEMA                                       │
└─────────────────────────────────────────────────────────────────────────────────────┘
                                          │
                                          ▼
┌─────────────────────────────────────────────────────────────────────────────────────┐
│  inicio.py (BOOTSTRAP)                                                                │
│  • Crea directorios (txt/, tmp/, notas/, listas/, calendario/, backup/, sonidos/)    │
│  • Inicializa archivos de configuracion                                              │
│  • Verifica conexion a internet (DNS: 8.8.8.8, 1.1.1.1)                             │
│  • Si no hay red, intenta conectar Wi-Fi con nmcli                                   │
│  • Verifica actualizaciones                         │
│  • Actualiza archivos de estado (txt/estado_red.txt, txt/version.txt)                │
│  • Carga personalizacion (txt/personalizacion.txt)                                   │
└─────────────────────────────────────────────────────────────────────────────────────┘
                                          │
                                          ▼
┌─────────────────────────────────────────────────────────────────────────────────────┐
│  main.py (SERVIDOR FASTAPI - Puerto 8000)                                            │
│  • Se ejecuta en segundo plano (subprocess)                                          │
│  • Endpoints: /v1/completions, /health                                               │
│  • ORQUESTADOR PRINCIPAL - Gestiona todo el flujo                                    │
└─────────────────────────────────────────────────────────────────────────────────────┘
                                          │
                    ┌─────────────────────┴─────────────────────┐
                    │                                           │
                    ▼                                           ▼
    ┌──────────────────────────┐              ┌──────────────────────────────┐
    │  wake.py (DETECTOR)      │              │  cliente.py (INTERFAZ)        │
    │  • Escucha "okay nabu"   │              │  • Cliente de consola         │
    │  • OpenWakeWord + PyAudio│              │  • Envia prompts al servidor  │
    │  • Envia POST a /wake    │              │  • Muestra respuestas         │
    └──────────────────────────┘              └──────────────────────────────┘
                    │                                           │
                    │ (deteccion)                               │ (entrada usuario)
                    ▼                                           ▼
    ┌──────────────────────────┐              ┌──────────────────────────────┐
    │  POST /wake_detected     │              │  POST /chat                  │
    │  • main.py recibe evento  │              │  • main.py recibe texto      │
    │  • Activa cliente_voz()   │              │  • Modo texto o voz          │
    └──────────────────────────┘              └──────────────────────────────┘
                          │                                   │
                          └───────────────┬───────────────────┘
                                          ▼
                    ┌─────────────────────────────────────────────────┐
                    │  intencion.py (CLASIFICADOR)                    │
                    │  • Carga modelos/medin_alfa.pkl (joblib)        │
                    │  • Predice intencion del texto                  │
                    │  • Retorna: hora, clima, musica, alarma, etc.   │
                    └─────────────────────────────────────────────────┘
                                          │
                                          ▼
                    ┌─────────────────────────────────────────────────┐
                    │  ifs.py (RUTEADOR DE INTENCIONES)                │
                    │  • Switch/case de intenciones                   │
                    │  • Redirige a funcion especifica                │
                    │  • Maneja errores y fallbacks                   │
                    └─────────────────────────────────────────────────┘
                                          │
                    ┌─────────────────────┼─────────────────────┐
                    │                     │                     │
                    ▼                     ▼                     ▼
        ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
        │  funciones.py   │  │  audio.py       │  │  comunicacion.py│
        │  • Musica USB   │  │  • Grabar       │  │  • Serial       │
        │  • Clima        │  │  • Transcribir  │  │  • GPIO         │
        │  • Notas        │  │  • ASR local    │  │  • Hardware     │
        │  • Alarmas      │  │                 │  │                 │
        │  • Listas       │  └─────────────────┘  └─────────────────┘
        │  • Agenda       │
        │  • IA local     │
        └─────────────────┘
                    │
                    ▼
        ┌─────────────────────────────────────────────────┐
        │  voz.py (SINTESIS DE VOZ)                        │
        │  • edge-tts (cloud - voz neural)                │
        │  • pyttsx3 (local - fallback)                   │
        │  • Reproduce respuesta al usuario               │
        └─────────────────────────────────────────────────┘
            

Objetivo del Proyecto

Nova Alfa actua como asistente personal que puede:

• Responder conversaciones generales con un modelo local
• Detectar la intencion del usuario para enrutar tareas
• Activarse por voz con la frase "okay nabu"
• Reproducir musica desde USB o streaming online
• Programar alarmas y recordatorios
• Guardar, leer y administrar notas
• Manejar listas de compras y eventos
• Consultar clima e investigar temas
• Traducir al ingles
• Emitir voz con sintesis local o con voces neuronales de Microsoft Edge TTS
• Transcribir audio desde el microfono usando un modelo local
• Controlar hardware o estados seriales
• Iniciar el sistema, verificar red y ejecutar actualizaciones
• Correr en una Raspberry Pi

Arquitectura General

archivos

1. inicio.py se encarga del arranque, estructura de directorios, archivos de estado, verificacion de conexion, Wi-Fi, actualizaciones y ejecucion del asistente principal
2. main.py levanta una API FastAPI en localhost:8000 con endpoint de completions
3. ifs.py actua como orquestador de la intencion del usuario y redirige hacia funciones especificas
4. funciones.py contiene la logica funcional del asistente: musica, notas, clima, IA conversacional, alarmas, listas, agenda, control de dispositivos, traduccion e investigacion
5. voz.py gestiona la reproduccion de audio y el fallback entre voz en la nube y voz local
6. intencion.py carga el modelo de clasificacion para inferir la intencion del usuario
7. audio.py gestiona la grabacion y transcripcion de audio con modelos locales de ASR
8. wake.py detecta la wakeword "okay nabu" usando OpenWakeWord
9. cliente.py proporciona un cliente interactivo de consola que consume la API del servidor
10. detener_musica.py monitoriza audio externo para detener reproduccion si hay sonido fuera del asistente
11. comunicacion.py envia señales seriales a hardware externo
12. hadware.py contiene la logica de hardware para Raspberry Pi

funcionalidades:

Musica

• musica_usb() reproduce musica desde la USB/local
• musica_online() usa servicios online si hay red
• reproduccion_especifica_usb() reproduce una cancion especifica
• detener() detiene audio

Notas y recordatorios

• tomar_nota() guarda texto en notas/
• leer_nota() devuelve contenido de notas
• programar_alarma() y nota_tiempo() gestionan alarmas y recordatorios

Listas y agenda

• agregar_a_lista(), leer_lista(), quitar_de_lista(), limpiar_lista() para compras
• agregar_evento(), consultar_agenda(), eliminar_evento() para calendario

Clima, investigacion y traduccion

• obtener_clima() consulta clima
• investigar_tema() realiza investigacion
• traductor_ingles() traduce contenido

Voz

voz.py:

1. Lee el idioma y preferencias desde txt/personalizacion.txt
2. Comprueba txt/estado_de_red.txt
3. Si hay red, intenta usar edge-tts con una voz neural
4. Si no hay red o falla la nube, usa pyttsx3 local
5. Reproduce el audio y limpia temporales

Hardware y serial

• hadware.py permite integracion con Raspberry Pi y botones fisicos
• comunicacion.py envia estados seriales (hablando, espera, pensando)
• detener_musica.py detecta audio externo a traves de sounddevice

Preguntas Frecuentes

Hosting Administrado

Que incluye el costo base de $215 MXN?

El costo base incluye hosting administrado, dominio .com/.mx, certificado SSL, configuracion inicial, mantenimiento basico y soporte tecnico.

Puedo migrar mi sitio web existente?

Si, ofrecemos servicio de migracion. El costo depende de la complejidad del sitio actual.

Que pasa si el sitio web crece y necesito mas recursos?

Se pueden escalar los recursos facilmente. Contactanos para cotizar un plan personalizado.

MIpunto POS

Que sistema operativo soporta MIpunto?

MIpunto soporta Windows (ejecutable .exe) y Linux (paquete .deb).

Necesito conexion a Internet para usar MIpunto?

Si, se requiere conexion a Internet para la descarga inicial de la base de datos y las actualizaciones. Una vez instalado, puede funcionar offline para ventas locales, pero necesita conectarse periodicamente para sincronizar datos.

Que pasa si se pierde el archivo lms.db?

La aplicacion descargara automaticamente una nueva copia de la base de datos desde la API al iniciar. Sin embargo, los datos locales no sincronizados podrian perderse.

Nova Asistente

Que es Nova Alfa?

Nova Alfa es un asistente inteligente offline-first que combina IA local, reconocimiento de voz, deteccion de wakeword y automatizacion del hogar.

Que hardware necesita Nova para funcionar?

Nova esta disenado para Linux y puede ejecutarse en una PC convencional o en una Raspberry Pi para integracion con GPIO y puertos seriales.

Nova requiere conexion a Internet?

No es obligatoria. Nova funciona en modo offline-first. La conexion a Internet se usa solo para servicios opcionales como voz neural (edge-tts), clima, investigacion y actualizaciones.

Como activo Nova por voz?

Nova utiliza la wakeword "okay nabu" con OpenWakeWord. Solo di "okay nabu" y el asistente se activara para escuchar tu comando.

Que modelos necesita Nova para funcionar?

Nova requiere tres modelos: modelos/kamutini-5b.gguf (LLM local), modelos/medin_alfa.pkl (clasificador de intenciones) y un modelo ASR en modelo/ para transcripcion de voz.