Documentación técnica para clientes — StateFlowAI

Esta sección reúne el material pensado para las personas que van a usar, operar, integrar o validar StateFlowAI desde una perspectiva técnica.

No está escrita solo para desarrollo. También sirve para equipos de operaciones, TI, producto técnico y responsables de implementación que necesitan entender cómo entrar a la plataforma con orden y sin ambigüedad.

Para quién es esta sección

Esta documentación te va a resultar útil si cumples alguno de estos perfiles:

• operas modelos o demos desde el portal,
• administras usuarios, permisos o accesos por tenant,
• integras StateFlowAI con sistemas propios,
• necesitas emitir o rotar app tokens,
• tienes que preparar una demo, una prueba de concepto o un piloto,
• quieres pasar de una validación controlada a una operación repetible.

Qué vas a encontrar aquí

• Guía de uso del portal
• explica cómo orientarte dentro del portal, qué revisar primero y cómo interpretar lo que ves según tu rol.
• Guía de integración API y tokens
• explica cuándo usar la API, cómo plantear una integración con menos riesgo y cómo manejar tokens de forma responsable.
• Guía rápida de operación
• sirve como checklist corto para el día a día, demos, validaciones y preparación de producción.

Orden recomendado según el caso

Quiero entender la plataforma antes de tocar nada

Empieza por la Guía de uso del portal. Te da el mapa general y te ayuda a no entrar a ciegas.

Quiero automatizar o integrar con backend

Empieza por la Guía de integración API y tokens. Ahí está la parte importante sobre alcance, permisos y patrón de implementación.

Tengo que operar rápido o preparar una demo

Ve directo a la Guía rápida de operación. Está escrita como una lista práctica para reducir olvidos.

Qué conviene tener claro antes de empezar

Antes de trabajar con la plataforma, conviene identificar cuatro cosas:

1. qué tenant o workspace corresponde al caso,
2. qué rol efectivo tienes,
3. si vas a trabajar desde UI o desde API,
4. qué parte del flujo es exploración, demo, piloto u operación real.

Parece básico, pero muchos problemas operativos empiezan justamente cuando estos cuatro puntos no están claros.

Qué no pretende reemplazar esta sección

Esta documentación técnica está pensada para adopción y operación práctica. Si necesitas detalle exhaustivo de endpoints, contratos o documentación interna más profunda, lo correcto es complementar esta lectura con la documentación general del proyecto en docs/index.md y la referencia técnica correspondiente.