Í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.

[edit]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.

pair-a-new-device — registra un nuevo dispositivo y asígnale un nivel de emparejamiento (INPUT, USER o INTERFACE)
install-toolchain — instala el compilador de Rust y el asistente de confirmación del nivel de preparación en una VM del espacio de trabajo
open-first-totebox-session — abre una sesión de trabajo en un Archivo Totebox y navega por el ciclo de vida de la sesión
explore-the-console — 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

[edit]Trabajar en la consola

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

navigate-console-tui — definiciones de campos de la barra de estado, cambio de tecla de función, atajos de teclado universales
use-f-key-model — asignaciones de ranuras predeterminadas, modelo de compilación de Cartucho, Email / SLM / Máquina de Entrada
read-the-command-ledger — ver entradas del libro mayor WORM desde la pestaña LEDGER de F12, comprender tipos de entrada, exportar a formato C2SP
run-first-slm-query — enviar un prompt de inferencia en F9 y leer el panel de salud del Doorman

[edit]Registros y almacenamiento

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

read-write-totebox-archives — protocolo de lectura al inicio de sesión, flujo de confirmación, preparación de borradores, buzón entre archivos
verify-worm-ledger — confirmar la integridad de la cadena de hash mediante SHA-256 y validar contra un punto de control Sigstore firmado
query-the-datagraph — buscar entidades nombradas mediante consulta en texto plano, navegar relaciones, gestionar interrupciones del Nivel A
export-structured-data — cuatro rutas de exportación por caso de uso: DataGraph, Markdown wiki, GeoJSON, tiles del libro mayor

[edit]Autorización de máquinas

Estas guías cubren el emparejamiento criptográfico de dispositivos que controla el acceso a la plataforma.

pair-a-new-device — el flujo de registro principal; los cuatro tipos de emparejamiento (ADMIN, INPUT, USER, INTERFACE)
enroll-ppn-node — registrar un nodo de cómputo PPN con el controlador de flota y verificar el primer latido
issue-capability-token — generar un token Ed25519 con alcance para un dispositivo o servicio
rotate-keys — reemplazar un par de claves y su token mediante la secuencia de rotación en tres fases
authenticate-binary-downloads — verificar y descargar binarios firmados desde el punto de distribución privado

Para el modelo de autorización que sustenta todas estas operaciones, consulta machine-based-auth y pairing-as-permission.

[edit]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.

configure-tenant-namespace — registrar un espacio de nombres de tenant, establecer límites de cuota, verificar el aislamiento y emitir la credencial raíz
scale-user-tiers — promover usuarios entre los niveles READ / USER / INPUT y actualizar masivamente un equipo
add-a-fleet-node — inscribir un segundo nodo PPN en una flota en funcionamiento sin interrumpir los nodos existentes

[edit]Integración y datos

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

build-a-colocation-map — autentícate contra la API de tiles SIG y renderiza marcadores de clústeres con color por nivel en MapLibre
connect-osm-data-pipeline — escribir un YAML de ingestión de cadena, ejecutar el script de ingestión contra la API de Overpass y reconstruir la capa de clústeres
federate-archives-via-content-mounts — declara un montaje de contenido secundario en knowledge.toml y accede a artículos federados entre instancias
use-knowledge-mounts — añadir un repositorio de contenido secundario a una instancia wiki en ejecución y verificar el aislamiento de slugs

[edit]Autoalojamiento

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

self-host-a-deployment — aprovisiona una instancia de despliegue nombrada, inicia la pasarela y conéctala a la plataforma central
configure-doorman — configurar las direcciones de nivel superior, los umbrales del interruptor de circuito y verificar el punto de conexión de salud
deploy-knowledge-instance — compilar e iniciar app-mediakit-knowledge apuntando a una ruta de repositorio de contenido local
run-local-slm-inference — iniciar el servicio SLM local, verificar el Nivel B de Doorman y enviar solicitudes de inferencia desde la consola o la API

[edit]Véase también

machine-based-auth — el modelo de autorización por hardware que sustenta todo el acceso a la plataforma
totebox-orchestration-development — el modelo de orquestación de sesiones que rige el uso de los Archivos Totebox
app-mediakit-knowledge — el motor wiki que sirve esta instancia de documentación