astrale-os/astrale-domain

Dominio Astrale

Carga conocimiento detallado del dominio desde las referencias que coinciden con el objetivo.

Límite del núcleo

• Usa el Esquema, la evidencia ejecutable y el linter de Dominio del SDK como barreras de seguridad.
• El código fuente del Dominio importa valores de autoría de Core y DSL solo a través del subpath semántico correspondiente de @astrale-os/sdk/*. No importes @astrale-os/kernel-core ni @astrale-os/kernel-dsl directamente, y no los reemplaces con un barrel raíz plano del SDK.
• Mantén la autorización en la Política propiedad del Esquema y el modo auth invocable; los manejadores ejecutan solo llamadas admitidas y no definen un segundo modelo de autorización.
• Elige deliberadamente la extensión de cada Nodo de Política existencial: node() para coincidencia propiedad de la topología, node(Class) para una familia polimórfica de Clases, o node.exact(Class) para identidad exacta.
• Trata las exportaciones públicas del SDK instalado y el código fuente actual del Dominio como autoritativas para la sintaxis de la API.

Enrutador de intenciones

Usa este enrutador para cargar solo las referencias propias de la tarea actual. Para nuevos Dominios, usa también el flujo de trabajo por fases a continuación; un andamio público existente ya satisface su fase de fundación.

• Andamiar, desplegar, instalar, probar o configurar TypeScript para un dominio: lee references/development.md.
• Redactar esquema, vocabulario, propiedades, elecciones de Clase/Edge, o revisar un esquema: lee references/schema.md primero. Léelo siempre para trabajar con esquemas.
• Implementar manejadores, enlaces invocables, llamadas al núcleo, lecturas/escrituras del grafo, o llamadas entre dominios: lee references/runtime.md.
• Envolver una API externa, definir una Integración/Proveedor, recibir webhooks, o diseñar comportamientos de efecto secundario/reintento: lee references/integrations.md.
• Decidir si reutilizar/importar un dominio Astrale nativo en lugar de modelar una capacidad tú mismo: lee references/domains.md.
• Modelar usuarios que inician sesión, invitar/registrar personas existentes, o asignar grupos de Shell: lee references/users.md.
• Asegurar un Dominio, Función, Vista, llamada de cliente, endpoint público, identidad, delegación, modo de autenticación o Política: lee references/policies.md.
• Construir o revisar vistas del navegador, UI montada, acceso a Vistas, resolución de Vistas o diseño frontend: lee references/views.md y aplica astrale-frontend-design para el diseño, interacción y copia de la interfaz de producto.
• Planificar o calificar una revisión de Esquema instalada, transición de datos o relleno: lee references/migration.md.
• Optimizar el acceso al grafo, reducir viajes de ida y vuelta, elegir índices/consultas, o revisar patrones de llamada por latencia: lee references/performance.md.
• Redactar o actualizar datos de demostración — los Conjuntos de Datos bajo tests/ que el Studio dibuja y prueba políticas: lee references/datasets.md.
• Escribir pruebas, fixtures, flujos de demostración o escenarios de prueba de humo: lee references/testing.md.
• Diagnosticar un dominio en vivo que falla, confusión de emisor/descubrimiento, enrutamiento de invocación o desviación en tiempo de ejecución: lee references/debugging.md.

Flujo de trabajo para creación de nuevo Dominio

Para una solicitud de crear, construir, prototipar o hacer un POC de un Dominio, sigue las fases aplicables en orden y carga una referencia solo cuando su fase comience.

1. Fundación: Inspecciona el espacio de trabajo primero. Cuando no exista un andamio público, lee references/development.md; lee references/domains.md solo al decidir si reutilizar un Dominio nativo. Cuando el espacio de trabajo ya declare el SDK, el adaptador de despliegue, la Aplicación y el Tiempo de ejecución, conserva esa plomería y pasa directamente a Esquema.
2. Esquema: Antes de redactar el esquema, lee references/schema.md; para usuarios que inician sesión y grupos, lee también references/users.md antes de inventar vocabulario de identidad o incorporación.
3. Invocables: Antes de implementar invocables, lee references/runtime.md y references/policies.md. Si un sistema externo está involucrado, lee también references/integrations.md.
4. Vistas: Cuando el Dominio posea una superficie de navegador, lee references/views.md antes de diseñar o implementarla. Las Vistas son declaraciones de Esquema, no campos en la definición de Dominio del SDK.
5. Datos de demostración: Para un Dominio con un grafo de muestra significativo, redacta un Conjunto de Datos pequeño bajo tests/, referenciado desde astrale.config.ts. Lee references/datasets.md primero; no inventes datos de grafo para un Dominio solo de API ni expandas una edición enfocada a trabajo de demostración no relacionado.
6. Finalización: Lee references/testing.md; ejercita los invocables públicos entregados con entradas de éxito representativas y entradas de denegación aplicables, luego ejecuta las pruebas relevantes, verificación de tipos, linting y compilación. Verifica el empaquetado al entregar un paquete consumible y el comportamiento en vivo al reclamar éxito en despliegue o integración.

Lee references/migration.md, references/performance.md y references/debugging.md solo cuando el ciclo de vida del dominio o el problema actual lo requiera.

Flujo de trabajo siempre activo

1. Inspecciona el repositorio o andamio actual antes de confiar en la sintaxis de la API desde la memoria.
2. Para comportamiento en vivo, usa references/debugging.md y prueba la ruta desplegada/instalada/tiempo de ejecución antes de tratar las ediciones del código fuente como efectivas.
3. Cuando un cambio en el Esquema afecte a Conjuntos de Datos existentes, mantenlos válidos y representativos en el mismo cambio. Lee references/datasets.md; los ejemplos complementan las pruebas en lugar de agotar cada caso.