AFFiNE per i servizi IT

Documentazione IT per i progetti dei clienti.

La documentazione IT spiega come un sistema viene costruito, configurato, gestito e trasferito a un altro team. Usa AFFiNE per collegare diagrammi di architettura a note di configurazione, decisioni e procedure di supporto. Un passaggio di consegne utile identifica il responsabile attuale, i riferimenti alle fonti, i problemi irrisolti e la prossima azione per il team destinatario.

Google Meet di 30 minuti Flusso di lavoro, distribuzione e necessità del team

Spazio di lavoro illustrativo: Sintesi della soluzione — migrazione del portale

Vista dello spazio di lavoro
Sintesi della soluzione — migrazione del portaleSpazio di implementazionePassaggio di consegne tecnicoNota di conoscenza per l'assistenzaNote della riunione

Pagina · team di soluzioni · esempio fittizio

Sintesi della soluzione — migrazione del portale

Ambito
Sostituire il punto di accesso ai documenti
Decisione
Mantenere il provider di identità attuale
Passaggio di consegne
Domande operative

Domanda progettuale aperta: confermare con il cliente le esigenze di conservazione.

Stesso progetto · area di disegno Edgeless
Sintesi della soluzione — migrazione del portale — area di disegno illustrativaNodi: Utenti, Nuovo portale, Archivio documenti, Provider di identità, Passaggio alle operazioni. Collegamenti: Utenti a Nuovo portale; Nuovo portale a Archivio documenti; Nuovo portale a Provider di identità (accesso · mantenuto); Provider di identità a Passaggio alle operazioni (domande).
Utenti
Nuovo portale
Archivio documenti
Provider di identità
Passaggio alle operazioni
accesso · mantenuto
domande
  • Il nuovo punto di accesso nell'ambito, tra utenti e archivio esistente.
  • La decisione di mantenere il provider di identità attuale, disegnata sul percorso di accesso.
  • Le domande per le operazioni sono collegate dal diagramma al passaggio di consegne.

Senza bordi

Spazio di implementazione

Disegna i componenti e i collegamenti. Spiega scelte, ipotesi e domande aperte in una sintesi della soluzione accanto al diagramma.

Ipotesi
Servizio di identità attuale
Opzione
Punto di accesso condiviso ai documenti
Domanda
Confermare le esigenze di conservazione
Stesso progetto · area di disegno Edgeless
Spazio di implementazione — area di disegno illustrativaNodi: Esigenza del cliente, Mappa del sistema, Opzioni, Decisione, Esigenze di conservazione?. Collegamenti: Esigenza del cliente a Mappa del sistema; Mappa del sistema a Opzioni; Opzioni a Decisione (scelta); Esigenze di conservazione? a Decisione (blocca).
Esigenza del cliente
Mappa del sistema
Opzioni
Decisione
Esigenze di conservazione?
scelta
blocca

Pagina + tabella

Passaggio di consegne tecnico

Riunisci ambito, note di configurazione e checklist di consegna. Usa una tabella di responsabili e questioni aperte aggiornata dal team.

VoceResponsabileStato
Progetto pilota di migrazione documentaleTeam di consegnaRivedere le ipotesi
Esigenze di conservazioneArchitetto di soluzioniDomanda aperta
Procedure operativeConsulenteIn redazione

Tabella gestita manualmente · senza automazione dei ticket

Stesso progetto · area di disegno Edgeless
Passaggio di consegne tecnico — area di disegno illustrativaNodi: Utenti, Nuovo portale, Archivio documenti, Provider di identità, Passaggio alle operazioni. Collegamenti: Utenti a Nuovo portale; Nuovo portale a Archivio documenti; Nuovo portale a Provider di identità (accesso · mantenuto); Provider di identità a Passaggio alle operazioni (domande).
Utenti
Nuovo portale
Archivio documenti
Provider di identità
Passaggio alle operazioni
accesso · mantenuto
domande
  • Il nuovo punto di accesso nell'ambito, tra utenti e archivio esistente.
  • La decisione di mantenere il provider di identità attuale, disegnata sul percorso di accesso.
  • Le domande per le operazioni sono collegate dal diagramma al passaggio di consegne.

Pagina

Nota di conoscenza per l'assistenza

Collega architettura, procedure operative e problemi aperti da una pagina di consegne. Verifica il metodo di condivisione o esportazione Markdown prima della consegna.

Contesto del sistema
Note di architettura
Operazioni
Procedure note
Questioni aperte
Domande per il team successivo

Esportazione Markdown disponibile · prova prima il metodo di condivisione

Cornice Edgeless incorporata

Esportazione Markdown — prova il risultato prima della consegna

Stesso progetto · area di disegno Edgeless
Nota di conoscenza per l'assistenza — area di disegno illustrativaNodi: Utenti, Nuovo portale, Archivio documenti, Provider di identità, Passaggio alle operazioni. Collegamenti: Utenti a Nuovo portale; Nuovo portale a Archivio documenti; Nuovo portale a Provider di identità (accesso · mantenuto); Provider di identità a Passaggio alle operazioni (domande).
Utenti
Nuovo portale
Archivio documenti
Provider di identità
Passaggio alle operazioni
accesso · mantenuto
domande
  • Il nuovo punto di accesso nell'ambito, tra utenti e archivio esistente.
  • La decisione di mantenere il provider di identità attuale, disegnata sul percorso di accesso.
  • Le domande per le operazioni sono collegate dal diagramma al passaggio di consegne.

Pagina

Note della riunione

Trasforma le domande ricorrenti dell'assistenza in pagine riutilizzabili. Includi configurazione, motivazione della scelta e un link alle note di implementazione.

Perché questa configurazione?

Motivazione progettuale, scritta una volta e collegata dalle note di assistenza.

Correlato
Nota di implementazione
Stesso progetto · area di disegno Edgeless
Note della riunione — area di disegno illustrativaNodi: Utenti, Nuovo portale, Archivio documenti, Provider di identità, Passaggio alle operazioni. Collegamenti: Utenti a Nuovo portale; Nuovo portale a Archivio documenti; Nuovo portale a Provider di identità (accesso · mantenuto); Provider di identità a Passaggio alle operazioni (domande).
Utenti
Nuovo portale
Archivio documenti
Provider di identità
Passaggio alle operazioni
accesso · mantenuto
domande
  • Il nuovo punto di accesso nell'ambito, tra utenti e archivio esistente.
  • La decisione di mantenere il provider di identità attuale, disegnata sul percorso di accesso.
  • Le domande per le operazioni sono collegate dal diagramma al passaggio di consegne.
Spazio di lavoro illustrativo con contenuti fittizi; non è una schermata del prodotto né un caso cliente. In Edgeless: trascina gli oggetti, usa Mano per spostarti o Ctrl/⌘ + scorrimento per lo zoom. Gli strumenti di disegno sono riferimenti visivi.
  • Spiegare le scelte architetturali accanto al diagramma

    Mostrato nel flusso 01

  • Mantenere visibili l'ambito e i responsabili dell'implementazione

    Mostrato nel flusso 02

  • Riutilizzare le risposte alle domande ricorrenti dell'assistenza

    Mostrato nel flusso 04

Dall'attività allo spazio di lavoro

Documentazione IT dall'architettura all'assistenza.

Crea una sintesi della soluzione, segui le note di implementazione, prepara un passaggio di consegne e riutilizza le risposte dell'assistenza.

Mappa di attività e funzioni dei quattro esempi di questa pagina
AttivitàDocumentiSenza bordiTabelleTeamEsportazioneRisultato
01 · Architetto di soluzioniScrivere documentazione di architettura softwareDocumentiSenza bordiSintesi della soluzione
02 · Responsabile della consegnaOrganizzare la documentazione di implementazioneDocumentiTabelleTeamSpazio di implementazione
03 · ConsulentePreparare un passaggio di consegne tecnicoDocumentiSenza bordiEsportazionePassaggio di consegne tecnico
04 · Team di assistenzaCreare una base di conoscenza ITDocumentiTeamNota di conoscenza per l'assistenza

01Architetto di soluzioni

Scrivere documentazione di architettura software

Disegna i componenti e i collegamenti. Spiega scelte, ipotesi e domande aperte in una sintesi della soluzione accanto al diagramma.

Attività
Spiegare al cliente un'architettura proposta
In AFFiNE
Relazioni del sistema disegnate in Edgeless; ogni scelta spiegata nella pagina
Risultato
Sintesi della soluzione

Funzioni utilizzate

Senza bordiEsempio fittizio

Sintesi della soluzione

Sintesi della soluzione — area di disegno illustrativaNodi: Esigenza del cliente, Mappa del sistema, Opzioni, Decisione, Esigenze di conservazione?. Collegamenti: Esigenza del cliente a Mappa del sistema; Mappa del sistema a Opzioni; Opzioni a Decisione (scelta); Esigenze di conservazione? a Decisione (blocca).
Esigenza del cliente
Mappa del sistema
Opzioni
Decisione
Esigenze di conservazione?
sceltablocca
Ipotesi
Servizio di identità attuale
Opzione
Punto di accesso condiviso ai documenti
Domanda
Confermare le esigenze di conservazione
Layout illustrativo con contenuti fittizi; non è una schermata del prodotto.

02Responsabile della consegna

Organizzare la documentazione di implementazione

Riunisci ambito, note di configurazione e checklist di consegna. Usa una tabella di responsabili e questioni aperte aggiornata dal team.

Attività
Avviare una consegna con la discussione attuale in un solo luogo
In AFFiNE
Pagina dell'ambito con una semplice tabella gestita dal team
Risultato
Spazio di implementazione

Funzioni utilizzate

Pagina + tabellaEsempio fittizio

Spazio di implementazione

VoceResponsabileStato
Progetto pilota di migrazione documentaleTeam di consegnaRivedere le ipotesi
Esigenze di conservazioneArchitetto di soluzioniDomanda aperta
Procedure operativeConsulenteIn redazione

Tabella gestita manualmente · senza automazione dei ticket

Layout illustrativo con contenuti fittizi; non è una schermata del prodotto.

03Consulente

Preparare un passaggio di consegne tecnico

Collega architettura, procedure operative e problemi aperti da una pagina di consegne. Verifica il metodo di condivisione o esportazione Markdown prima della consegna.

Attività
Lasciare al team del cliente consegne facili da consultare
In AFFiNE
Pagina di consegne con note architetturali e area di disegno collegate; esportazione Markdown provata prima della consegna
Risultato
Passaggio di consegne tecnico

Funzioni utilizzate

PaginaEsempio fittizio

Passaggio di consegne tecnico

Contesto del sistema

Note di architettura

Operazioni

Procedure note

Questioni aperte

Domande per il team successivo

Cornice Edgeless incorporata

Esportazione Markdownprova il risultato prima della consegna

Esportazione Markdown disponibile · prova prima il metodo di condivisione

Layout illustrativo con contenuti fittizi; non è una schermata del prodotto.

04Team di assistenza

Creare una base di conoscenza IT

Trasforma le domande ricorrenti dell'assistenza in pagine riutilizzabili. Includi configurazione, motivazione della scelta e un link alle note di implementazione.

Attività
Rispondere una volta a una domanda ricorrente, con il ragionamento
In AFFiNE
Pagina riutilizzabile nello spazio condiviso, collegata alla nota di implementazione
Risultato
Nota di conoscenza per l'assistenza

Funzioni utilizzate

PaginaEsempio fittizio

Nota di conoscenza per l'assistenza

Perché questa configurazione?

Motivazione progettuale, scritta una volta e collegata dalle note di assistenza.

CorrelatoNota di implementazione

Layout illustrativo con contenuti fittizi; non è una schermata del prodotto.

Dall'esempio alla valutazione

Parliamo della tua documentazione per i clienti.

Parliamo di note architetturali, passaggi di consegne e requisiti di accesso del team.

Prenota una demo

Scegli un orario con il team AFFiNE.

Uno spazio di lavoro connesso

Scrivi in una pagina. Passa lo stesso documento all'area di disegno.

Gli esempi precedenti usano gli stessi elementi di base.

  • Esempio illustrativo

    Documenti

    Pagine leggibili con riferimenti, immagini e blocchi avanzati.

    Esplora Docs
  • Esempio illustrativo

    Lavagna Edgeless

    Un'area di disegno per mostrare le relazioni tra idee e sistemi.

    Esplora Edgeless
  • Esempio illustrativo

    Tabelle e spazio del team

    Segui le questioni aperte e modificate insieme negli spazi condivisi.

    Esplora Teamhub

Esempi illustrativi di documenti, lavagne e tabelle; non sono schermate del prodotto né casi settoriali.

Distribuzione e valutazione

Scegli come eseguire lo spazio di lavoro.

Valuta carico di lavoro, infrastruttura e configurazione IA con chi gestirà lo spazio.

Illustrazione di uno spazio ospitato nel cloud

Spazio ospitato

Prova un flusso con materiale di esempio consentito prima di estenderne l'uso.

  • Applicazione web AFFiNE
  • Uno spazio del team
  • Nessun server da gestire
Parliamo della distribuzione cloud
Ospitare AFFiNE su infrastruttura propria

Prerequisiti

1 / Docker

Installa Docker e Docker Compose sul tuo computer.

2 / Scaricare il file Compose più recente

Scarica compose.yml dal repository AFFiNE.

3 / Preparare il file di ambiente

Verifica le variabili di ambiente della tua distribuzione.

Autogestito

Per AFFiNE con hosting autogestito, Docker Compose è la modalità di distribuzione documentata. I dati dello spazio e i file caricati utilizzano l'infrastruttura e l'archiviazione che configuri.

  • Docker Compose
  • PostgreSQL
  • Archiviazione file o S3
  • Accesso OIDC
  • Accedi tramite il tuo provider di identitàAFFiNE con hosting autogestito supporta OIDC. Verifica i ruoli dello spazio e l'accesso ai documenti rispetto ai tuoi requisiti.
  • L'IA è facoltativaL'IA nell'installazione autogestita richiede un provider configurato e può essere disattivata. L'uso di una chiave propria è indicato come sperimentale.
  • Licenze per reti limitateUna licenza installabile si attiva senza contattare i server di licenza AFFiNE. Questo non rende disponibili offline tutte le funzioni.
  • Backup e ripristinoIl processo è documentato, incluso un ripristino di prova. Eseguilo nel tuo ambiente.
  1. Il materiale dei clienti condividerà uno spazio con la conoscenza interna?
  2. Come verrà condiviso o esportato ogni passaggio di consegne?
  3. Quale provider di identità deve usare il progetto pilota?

Questa pagina non dichiara supporto per SAML, SCIM, certificazioni settoriali né approvazione per carichi di lavoro specifici.

Riferimenti del prodotto: AFFiNE Enterprise e documentazione in inglese per Docker Compose, accesso OIDC e configurazione dell'IA.

Continua a esplorare · Modello generale

Modello esistente di procedura operativa

Un modello generale per documentare un'attività operativa ripetibile.

Prima di iniziare

Le domande del tuo team.

Come possono i team di servizi usare AFFiNE per documentare l'IT?

Usa documenti per configurazioni e procedure, lavagne per l'architettura e tabelle per responsabili e domande aperte. Questi esempi riguardano la documentazione; rilevamento degli asset, casseforti delle password, RMM e automazione dei ticket restano negli strumenti specialistici.

Cosa includere nella documentazione di architettura software?

Registra lo scopo del sistema, gli utenti, i componenti, le interfacce e il contesto di distribuzione, poi spiega le decisioni di progettazione e le domande irrisolte. Etichetta gli elementi e i collegamenti del diagramma affinché un altro team possa leggerlo senza l'autore originale. In AFFiNE, mantieni il diagramma accanto alle ipotesi, ai riferimenti alle fonti e alle note sulle decisioni.

Riferimento per i diagrammi (in inglese): modello C4 per l'architettura software.

Possiamo separare le informazioni di clienti diversi?

Valuta membri dello spazio, accesso ai documenti e impostazioni di condivisione rispetto ai tuoi requisiti prima di usare materiale dei clienti. L'esempio non dimostra l'isolamento tra tenant.

Possiamo valutare l'hosting autogestito?

Sì. Docker Compose è la soluzione documentata per l'hosting autogestito, con accesso tramite il tuo provider di identità via OIDC. Esamina la documentazione Enterprise con il team infrastrutturale e prova un flusso rappresentativo prima di estendere la distribuzione.

Questo spazio richiede l'IA?

No. Questi flussi usano pagine, aree di disegno e tabelle senza richiedere l'IA. In AFFiNE con hosting autogestito, l'IA richiede un provider configurato e può essere disattivata. Verifica il provider e i flussi di dati prima di attivarla.

Da dove dovrebbe iniziare il team?

Scegli un'attività attuale di documentazione e un piccolo insieme di materiale consentito. Valuta se il team riesce a trovare, capire e trasferire il lavoro prima di estenderne l'uso.

Una conversazione sul tuo team

Valuta AFFiNE per la consegna ai clienti.

Parliamo di note architetturali, passaggi di consegne e requisiti di accesso del team.

Google Meet di 30 minuti · Scegli un orario disponibile

Preferisci l'e-mail? Contatta il reparto vendite