AFFiNE para servicios de TI

Documentación de TI para proyectos de clientes.

La documentación de TI explica cómo se construye, configura, opera y transfiere un sistema a otro equipo. Usa AFFiNE para conectar diagramas de arquitectura con notas de configuración, decisiones y procedimientos de soporte. Una entrega útil identifica al responsable actual, las referencias a fuentes, los problemas pendientes y la siguiente acción para el equipo receptor.

Google Meet de 30 minutos Flujo de trabajo, despliegue y necesidades del equipo

Espacio de trabajo ilustrativo: Resumen de solución — migración del portal

Vista del espacio de trabajo
Resumen de solución — migración del portalEspacio de implementaciónTraspaso técnicoNota de conocimiento de soporteNotas de reunión

Página · equipo de soluciones · ejemplo ficticio

Resumen de solución — migración del portal

Alcance
Sustituir el punto de acceso a documentos
Decisión
Mantener el proveedor de identidad actual
Traspaso
Preguntas de operaciones

Pregunta de diseño abierta: confirmar con el cliente las necesidades de conservación.

Mismo proyecto · lienzo Edgeless
Resumen de solución — migración del portal — lienzo ilustrativoNodos: Usuarios, Nuevo portal, Repositorio documental, Proveedor de identidad, Traspaso a operaciones. Conexiones: Usuarios a Nuevo portal; Nuevo portal a Repositorio documental; Nuevo portal a Proveedor de identidad (inicio de sesión · conservado); Proveedor de identidad a Traspaso a operaciones (preguntas).
Usuarios
Nuevo portal
Repositorio documental
Proveedor de identidad
Traspaso a operaciones
inicio de sesión · conservado
preguntas
  • El nuevo punto de acceso incluido en el alcance, entre usuarios y repositorio actual.
  • La decisión de mantener el proveedor de identidad actual, dibujada en la ruta de acceso.
  • Las preguntas para operaciones se enlazan del diagrama al traspaso.

Sin bordes

Espacio de implementación

Dibuja los componentes y sus conexiones. Explica decisiones, hipótesis y preguntas pendientes en un resumen de solución junto al diagrama.

Hipótesis
Servicio de identidad actual
Opción
Punto de acceso compartido a documentos
Pregunta
Confirmar necesidades de conservación
Mismo proyecto · lienzo Edgeless
Espacio de implementación — lienzo ilustrativoNodos: Necesidad del cliente, Mapa del sistema, Opciones, Decisión, ¿Necesidades de conservación?. Conexiones: Necesidad del cliente a Mapa del sistema; Mapa del sistema a Opciones; Opciones a Decisión (elegida); ¿Necesidades de conservación? a Decisión (bloquea).
Necesidad del cliente
Mapa del sistema
Opciones
Decisión
¿Necesidades de conservación?
elegida
bloquea

Página + tabla

Traspaso técnico

Reúne alcance, notas de configuración y lista de entrega. Usa una tabla de responsables y asuntos pendientes actualizada por el equipo.

ElementoResponsableEstado
Piloto de migración documentalEquipo de entregaRevisar hipótesis
Necesidades de conservaciónArquitecto de solucionesPregunta abierta
Procedimientos operativosConsultorEn redacción

Tabla mantenida manualmente · sin automatización de incidencias

Mismo proyecto · lienzo Edgeless
Traspaso técnico — lienzo ilustrativoNodos: Usuarios, Nuevo portal, Repositorio documental, Proveedor de identidad, Traspaso a operaciones. Conexiones: Usuarios a Nuevo portal; Nuevo portal a Repositorio documental; Nuevo portal a Proveedor de identidad (inicio de sesión · conservado); Proveedor de identidad a Traspaso a operaciones (preguntas).
Usuarios
Nuevo portal
Repositorio documental
Proveedor de identidad
Traspaso a operaciones
inicio de sesión · conservado
preguntas
  • El nuevo punto de acceso incluido en el alcance, entre usuarios y repositorio actual.
  • La decisión de mantener el proveedor de identidad actual, dibujada en la ruta de acceso.
  • Las preguntas para operaciones se enlazan del diagrama al traspaso.

Página

Nota de conocimiento de soporte

Enlaza arquitectura, procedimientos operativos y problemas pendientes desde una página de traspaso. Comprueba el método de compartir o exportar a Markdown antes de entregar.

Contexto del sistema
Notas de arquitectura
Operaciones
Procedimientos conocidos
Asuntos pendientes
Preguntas para el siguiente equipo

Exportación Markdown disponible · prueba primero cómo compartir

Marco Edgeless incrustado

Exportación Markdown — prueba el resultado antes de entregar

Mismo proyecto · lienzo Edgeless
Nota de conocimiento de soporte — lienzo ilustrativoNodos: Usuarios, Nuevo portal, Repositorio documental, Proveedor de identidad, Traspaso a operaciones. Conexiones: Usuarios a Nuevo portal; Nuevo portal a Repositorio documental; Nuevo portal a Proveedor de identidad (inicio de sesión · conservado); Proveedor de identidad a Traspaso a operaciones (preguntas).
Usuarios
Nuevo portal
Repositorio documental
Proveedor de identidad
Traspaso a operaciones
inicio de sesión · conservado
preguntas
  • El nuevo punto de acceso incluido en el alcance, entre usuarios y repositorio actual.
  • La decisión de mantener el proveedor de identidad actual, dibujada en la ruta de acceso.
  • Las preguntas para operaciones se enlazan del diagrama al traspaso.

Página

Notas de reunión

Convierte las preguntas recurrentes de soporte en páginas reutilizables. Incluye la configuración, por qué se eligió y un enlace a las notas de implementación.

¿Por qué esta configuración?

Justificación del diseño, escrita una vez y enlazada desde las notas de soporte.

Relacionado
Nota de implementación
Mismo proyecto · lienzo Edgeless
Notas de reunión — lienzo ilustrativoNodos: Usuarios, Nuevo portal, Repositorio documental, Proveedor de identidad, Traspaso a operaciones. Conexiones: Usuarios a Nuevo portal; Nuevo portal a Repositorio documental; Nuevo portal a Proveedor de identidad (inicio de sesión · conservado); Proveedor de identidad a Traspaso a operaciones (preguntas).
Usuarios
Nuevo portal
Repositorio documental
Proveedor de identidad
Traspaso a operaciones
inicio de sesión · conservado
preguntas
  • El nuevo punto de acceso incluido en el alcance, entre usuarios y repositorio actual.
  • La decisión de mantener el proveedor de identidad actual, dibujada en la ruta de acceso.
  • Las preguntas para operaciones se enlazan del diagrama al traspaso.
Espacio de trabajo ilustrativo con contenido ficticio; no es una captura del producto ni un caso de cliente. En Edgeless: arrastra objetos, usa Mano para desplazarte o Ctrl/⌘ + desplazamiento para cambiar el zoom. Las herramientas de dibujo son referencias visuales.
  • Explicar las decisiones de arquitectura junto al diagrama

    Se muestra en el flujo 01

  • Mantener visibles el alcance y los responsables de implementación

    Se muestra en el flujo 02

  • Reutilizar respuestas a preguntas recurrentes de soporte

    Se muestra en el flujo 04

De la tarea al espacio de trabajo

Documentación de TI desde la arquitectura hasta el soporte.

Crea un resumen de solución, sigue notas de implementación, prepara un traspaso y reutiliza respuestas de soporte.

Mapa de tareas y funciones de los cuatro ejemplos de esta página
TareaDocumentosSin bordesTablasEquipoExportaciónResultado
01 · Arquitecto de solucionesRedactar documentación de arquitectura de softwareDocumentosSin bordesResumen de solución
02 · Responsable de entregaOrganizar documentación de implementaciónDocumentosTablasEquipoEspacio de implementación
03 · ConsultorPreparar un traspaso técnicoDocumentosSin bordesExportaciónTraspaso técnico
04 · Equipo de soporteCrear una base de conocimiento de TIDocumentosEquipoNota de conocimiento de soporte

01Arquitecto de soluciones

Redactar documentación de arquitectura de software

Dibuja los componentes y sus conexiones. Explica decisiones, hipótesis y preguntas pendientes en un resumen de solución junto al diagrama.

Tarea
Explicar al cliente una arquitectura propuesta
En AFFiNE
Relaciones del sistema dibujadas en Edgeless; cada decisión explicada en la página
Resultado
Resumen de solución

Funciones utilizadas

Sin bordesEjemplo ficticio

Resumen de solución

Resumen de solución — lienzo ilustrativoNodos: Necesidad del cliente, Mapa del sistema, Opciones, Decisión, ¿Necesidades de conservación?. Conexiones: Necesidad del cliente a Mapa del sistema; Mapa del sistema a Opciones; Opciones a Decisión (elegida); ¿Necesidades de conservación? a Decisión (bloquea).
Necesidad del cliente
Mapa del sistema
Opciones
Decisión
¿Necesidades de conservación?
elegidabloquea
Hipótesis
Servicio de identidad actual
Opción
Punto de acceso compartido a documentos
Pregunta
Confirmar necesidades de conservación
Diseño ilustrativo con contenido ficticio; no es una captura del producto.

02Responsable de entrega

Organizar documentación de implementación

Reúne alcance, notas de configuración y lista de entrega. Usa una tabla de responsables y asuntos pendientes actualizada por el equipo.

Tarea
Iniciar una entrega con la discusión actual en un solo lugar
En AFFiNE
Página de alcance con una tabla sencilla mantenida por el equipo
Resultado
Espacio de implementación

Funciones utilizadas

Página + tablaEjemplo ficticio

Espacio de implementación

ElementoResponsableEstado
Piloto de migración documentalEquipo de entregaRevisar hipótesis
Necesidades de conservaciónArquitecto de solucionesPregunta abierta
Procedimientos operativosConsultorEn redacción

Tabla mantenida manualmente · sin automatización de incidencias

Diseño ilustrativo con contenido ficticio; no es una captura del producto.

03Consultor

Preparar un traspaso técnico

Enlaza arquitectura, procedimientos operativos y problemas pendientes desde una página de traspaso. Comprueba el método de compartir o exportar a Markdown antes de entregar.

Tarea
Dejar al equipo del cliente un traspaso fácil de consultar
En AFFiNE
Página de traspaso con notas de arquitectura y lienzo enlazados; exportación Markdown probada antes de entregar
Resultado
Traspaso técnico

Funciones utilizadas

PáginaEjemplo ficticio

Traspaso técnico

Contexto del sistema

Notas de arquitectura

Operaciones

Procedimientos conocidos

Asuntos pendientes

Preguntas para el siguiente equipo

Marco Edgeless incrustado

Exportación Markdownprueba el resultado antes de entregar

Exportación Markdown disponible · prueba primero cómo compartir

Diseño ilustrativo con contenido ficticio; no es una captura del producto.

04Equipo de soporte

Crear una base de conocimiento de TI

Convierte las preguntas recurrentes de soporte en páginas reutilizables. Incluye la configuración, por qué se eligió y un enlace a las notas de implementación.

Tarea
Responder una vez a una pregunta recurrente, con su razonamiento
En AFFiNE
Página reutilizable en el espacio compartido, enlazada a la nota de implementación
Resultado
Nota de conocimiento de soporte

Funciones utilizadas

PáginaEjemplo ficticio

Nota de conocimiento de soporte

¿Por qué esta configuración?

Justificación del diseño, escrita una vez y enlazada desde las notas de soporte.

RelacionadoNota de implementación

Diseño ilustrativo con contenido ficticio; no es una captura del producto.

Del ejemplo a la evaluación

Hablemos de tu documentación para clientes.

Hablemos de notas de arquitectura, traspasos de proyectos y requisitos de acceso del equipo.

Reserva una demo

Elige una hora con el equipo de AFFiNE.

Un espacio de trabajo conectado

Escribe en una página. Cambia el mismo documento a lienzo.

Los ejemplos anteriores usan los mismos elementos básicos.

  • Ejemplo ilustrativo

    Documentos

    Páginas legibles con referencias, imágenes y bloques enriquecidos.

    Explora Docs
  • Ejemplo ilustrativo

    Pizarra Edgeless

    Un lienzo para mostrar cómo se relacionan ideas y sistemas.

    Explora Edgeless
  • Ejemplo ilustrativo

    Tablas y espacio de equipo

    Sigue los asuntos pendientes y editad juntos en espacios compartidos.

    Explora Teamhub

Ejemplos ilustrativos de documentos, pizarras y tablas; no son capturas del producto ni casos sectoriales.

Despliegue y evaluación

Elige cómo ejecutar el espacio de trabajo.

Evalúa la carga de trabajo, la infraestructura y la configuración de IA con quienes operarán el espacio.

Ilustración de un espacio alojado en la nube

Espacio alojado

Prueba un flujo con material de muestra permitido antes de ampliar el uso.

  • Aplicación web de AFFiNE
  • Un espacio de equipo
  • Sin servidores que mantener
Hablemos del despliegue en la nube
Autoalojar AFFiNE

Requisitos previos

1 / Docker

Instala Docker y Docker Compose en tu equipo.

2 / Descargar el archivo Compose más reciente

Descarga compose.yml del repositorio de AFFiNE.

3 / Preparar el archivo de entorno

Revisa las variables de entorno de tu despliegue.

Autoalojado

Para AFFiNE autoalojado, Docker Compose es la vía de despliegue documentada. Los datos del espacio y los archivos subidos utilizan la infraestructura y el almacenamiento que configures.

  • Docker Compose
  • PostgreSQL
  • Almacenamiento de archivos o S3
  • Inicio de sesión OIDC
  • Inicia sesión con tu proveedor de identidadAFFiNE autoalojado admite OIDC. Revisa los roles del espacio y el acceso a documentos según tus propios requisitos.
  • La IA es opcionalLa IA en una instalación autoalojada requiere un proveedor configurado y se puede desactivar. El uso de tu propia clave está marcado como experimental.
  • Licencias para redes restringidasUna licencia instalable se activa sin contactar con los servidores de licencias de AFFiNE. Esto no hace que todas las funciones operen sin conexión.
  • Copias de seguridad y restauraciónEl proceso está documentado, incluida una restauración de prueba. Ejecútalo en tu entorno.
  1. ¿Compartirá el material de clientes un espacio con el conocimiento interno?
  2. ¿Cómo se compartirá o exportará cada traspaso?
  3. ¿Qué proveedor de identidad debe usar el piloto?

Esta página no afirma compatibilidad con SAML, SCIM, certificaciones sectoriales ni aprobación para una carga de trabajo concreta.

Referencias del producto: AFFiNE Enterprise y documentación en inglés sobre Docker Compose, inicio de sesión con OIDC y configuración de IA.

Sigue explorando · Plantilla general

Plantilla existente de procedimiento operativo

Una plantilla general para documentar una tarea operativa repetible.

Antes de empezar

Preguntas de tu equipo.

¿Cómo pueden los equipos de servicios usar AFFiNE para documentar TI?

Usa documentos para configuraciones y procedimientos, pizarras para arquitectura y tablas para responsables y preguntas abiertas. Estos ejemplos cubren documentación; el descubrimiento de activos, las bóvedas de contraseñas, RMM y la automatización de incidencias corresponden a herramientas especializadas.

¿Qué debe incluir la documentación de arquitectura de software?

Registra el propósito del sistema, sus usuarios, componentes, interfaces y contexto de despliegue; después, explica las decisiones de diseño y las preguntas pendientes. Etiqueta los elementos y las conexiones del diagrama para que otro equipo pueda interpretarlos sin el autor original. En AFFiNE, mantén el diagrama junto a sus hipótesis, referencias a fuentes y notas de decisiones.

Referencia para diagramas (en inglés): modelo C4 para arquitectura de software.

¿Podemos separar información de diferentes clientes?

Evalúa miembros del espacio, acceso a documentos y opciones de uso compartido según tus requisitos antes de usar material de clientes. El ejemplo no demuestra aislamiento entre clientes.

¿Podemos evaluar el autoalojamiento?

Sí. Docker Compose es la vía documentada de autoalojamiento, con acceso mediante tu proveedor de identidad por OIDC. Revisa la documentación Enterprise con el equipo de infraestructura y prueba un flujo representativo antes de ampliar el despliegue.

¿Este espacio requiere IA?

No. Estos flujos usan páginas, lienzos y tablas sin requerir IA. En AFFiNE autoalojado, la IA necesita un proveedor configurado y se puede desactivar. Revisa el proveedor y los flujos de datos antes de activarla.

¿Por dónde debería empezar el equipo?

Elige una tarea actual de documentación y un pequeño conjunto de material permitido. Evalúa si el equipo puede encontrar, entender y traspasar el trabajo antes de ampliar el uso.

Una conversación sobre tu equipo

Evalúa AFFiNE para la entrega a clientes.

Hablemos de notas de arquitectura, traspasos de proyectos y requisitos de acceso del equipo.

Google Meet de 30 minutos · Elige una hora disponible

¿Prefieres el correo? Contacta con ventas