Índice de Guías para Desarrolladores

Las guías operativas para despliegues de plataforma se mantienen por separado en el catálogo de despliegue de flota Woodfine. Son documentos operativos para operadores del sistema y no se enumeran aquí.

El Índice de Guías para Desarrolladores enumera las guías prácticas de la plataforma PointSav, organizadas por área de interés del desarrollador. Cada guía cubre una tarea específica que un desarrollador realiza al construir con la plataforma o desplegarla. Para la arquitectura subyacente en la que se basa cada guía, siga los enlaces a los artículos dentro de cada guía.

Los manuales operativos internos para el despliegue de flota Woodfine no se incluyen aquí — son documentos operativos para aprovisionamiento y mantenimiento, no guías públicas para desarrolladores.

Primeros pasos

Estas guías cubren los primeros pasos para un desarrollador nuevo en la plataforma: configurar el conjunto de herramientas, autenticar un dispositivo y abrir una sesión de trabajo.

• Cómo emparejar un dispositivo nuevo — registra un nuevo dispositivo con el servidor de emparejamiento y logra que se apruebe en la red
• Cómo instalar el conjunto de herramientas de desarrollo — instala el compilador de Rust y el asistente de confirmación del nivel de preparación en una VM del espacio de trabajo
• Abrir su primera sesión Totebox — abre una sesión de trabajo en un Archivo Totebox y navega por el ciclo de vida de la sesión
• Explorar la consola por primera vez — recorre el diseño de tres zonas de la TUI, la barra de estado y las ranuras de teclas de función por primera vez

Trabajar en la consola

Estas guías cubren la interfaz de terminal de la plataforma y sus ranuras de Cartucho integradas.

• Navegar la TUI de la consola — el diseño real de pantalla y los campos de la barra de estado, y cómo cambiar de ranura sin perder estado
• Usar el modelo de cartuchos de tecla de función — qué hacen realmente F3, F9 y F12, corrigiendo dos comportamientos inventados
• Leer el libro mayor de comandos — pagine entradas del libro mayor y obtenga un punto de control firmado a través de la API HTTP real de service-fs
• Ejecutar su primera consulta SLM — la ruta real hacia una primera solicitud de inferencia, ya que F9 no tiene ninguna interfaz de consulta

Registros y almacenamiento

Estas guías cubren el libro mayor de auditoría WORM y las operaciones con datos de entidades.

• Cómo leer y escribir en archivos Totebox — protocolo de lectura al inicio de sesión, flujo de confirmación, preparación de borradores, buzón entre archivos
• Verificar una entrada del libro mayor WORM — verifique una entrada del libro mayor contra un punto de control obtenido, usando solo curl y SHA-256
• Consultar el DataGraph — las herramientas reales query_datagraph/get_entity_context, y por qué la disponibilidad del DataGraph no es un nivel de Doorman
• Exportar datos estructurados de la plataforma — las tres rutas de exportación reales, ya que una cuarta en una versión anterior de esta guía no existía

Autorización de máquinas

Estas guías cubren los mecanismos de credenciales y admisión que determinan quién y qué puede actuar sobre la plataforma — emparejamiento de dispositivos, tokens de capacidad servicio a servicio, inscripción de nodos de flota y descargas de binarios firmadas. Son mecanismos separados, no un solo sistema con nombres diferentes.

• Cómo emparejar un dispositivo nuevo — registra un dispositivo con el servidor de emparejamiento y logra que se apruebe en la malla WireGuard
• Cómo emitir un token de capacidad — genera un token de capacidad firmado con Ed25519 y regístralo con un servicio par
• Cómo rotar claves y tokens de capacidad — reemplaza una credencial dentro de los límites reales de expiración de 24 horas del sistema; no existe mecanismo de revocación
• Cómo inscribir un nodo PPN — inicia el agente de latido por nodo y confírmalo en el controlador de la flota
• Cómo autenticar las descargas de binarios — confirma un pedido y sigue la ruta de descarga firmada de una versión

Para el modelo de autorización que sustenta todas estas operaciones, consulta Autorización basada en máquina y Emparejamiento como permiso.

Escala multi-entidad

Estas guías cubren la operación de la plataforma a través de múltiples tenants, usuarios y nodos de flota.

• Configurar un espacio de nombres de tenant — el aprovisionamiento real basado en configuración en service-vm-tenant, ya que no existe ninguna API de registro
• Escalar el acceso de usuarios — otorgue tokens con alcance de rol a medida que un equipo crece; no hay promoción/revocación, solo tokens nuevos
• Añadir un nodo a una flota en funcionamiento — inscribir un segundo nodo PPN en una flota en funcionamiento sin interrumpir los nodos existentes

Integración y datos

Estas guías cubren el consumo de datos de la plataforma y la conexión de aplicaciones externas.

• Construir un mapa de co-ubicación — carga un archivo PMTiles directamente en MapLibre; no existe API REST ni clave de API
• Conectarse al pipeline de datos OSM — ejecute el script real ingest-osm.py y registre una cadena en taxonomy.py
• Federar archivos mediante montajes de contenido — monte el contenido de un segundo repositorio en una instancia en ejecución
• Usar montajes de conocimiento declarativos — el esquema real de [[mount]], y el riesgo real (un espacio de nombres compartido y plano, no aislado por montaje)

Herramientas financieras y de construcción

Estas guías cubren las herramientas de dominio que se ejecutan sobre la plataforma — el libro mayor de costes, cronograma y calidad de construcción y sus herramientas hermanas de contabilidad y nóminas. Todas son herramientas de línea de comandos; ninguna tiene hoy una pantalla de consola.

• Generar un informe de estimación de costes de construcción — ejecute el binario real de informes sobre un directorio de datos CSV; no hay opciones, porque no analiza argumento alguno
• Generar un paquete de estados financieros — represente un paquete de estados consolidados para un ejercicio y un período; la ejecución se niega antes que publicar una cifra que no cuadra
• Generar un registro de nóminas — agregue las horas de mano de obra presupuestadas por división; no calcula salario bruto, ni frecuencia de pago, ni remisión

Autoalojamiento

Estas guías cubren el despliegue y la ejecución de componentes de la plataforma en infraestructura controlada por el operador.

• Cómo autoalojar un despliegue — aprovisiona una instancia de despliegue nombrada, inicia la pasarela y conéctala a la plataforma central
• Cómo configurar el gateway Doorman — configurar las direcciones de nivel superior, los umbrales del interruptor de circuito y verificar el punto de conexión de salud
• Cómo desplegar una instancia de conocimiento — compilar e iniciar app-mediakit-knowledge apuntando a una ruta de repositorio de contenido local
• Cómo ejecutar inferencia SLM local — iniciar el servicio SLM local, verificar el Nivel B de Doorman y enviar solicitudes de inferencia desde la consola o la API

Véase también

• Autorización basada en máquina — el modelo de autorización por hardware que sustenta todo el acceso a la plataforma
• Orquestación Totebox como entorno de desarrollo — el modelo de orquestación de sesiones que rige el uso de los Archivos Totebox
• Aplicación MediaKit Knowledge — el motor wiki que sirve esta instancia de documentación