Stiamo sviluppando un'applicazione web che sta ora crescendo fino a poche pagine, tutte con dati complessi e interazioni piuttosto complesse tra le pagine.
Ad esempio, il flusso di accesso comprende le seguenti diverse richieste possibili ai nostri controllori:
- Accedi - > Hai dimenticato la password - > Invia email [solo POST] - > Token di reimpostazione della password - > Nuova password invia - > Torna al Login
- Accedi - > Crea nuovo utente - > Registrati [solo POST] - > Invia email di attivazione
- Accedi - > Elabora nuove richieste di invito - > Pagina principale
... e un paio di altre varianti, tutte incluse l'invio di e-mail, che richiedono i token di verifica / attivazione; e questo non inizia nemmeno a sfiorare le molteplici pagine di tipo wizard per la connessione a applicazioni esterne e così via.
Esiste un buon modo per documentare tutti questi URL diversi, i loro parametri e i modi in cui questi interagiscono tra loro? Per applicazioni Web complesse, avere un modo per fare riferimento a tutte queste diverse richieste deve essere una risorsa piuttosto buona ... E soprattutto in termini di sicurezza, essere in grado di ispezionare visivamente il flusso di richieste e individuare potenziali problemi. (Ehi, perché questa pagina è GET? Dovrebbe essere un POST con protezione CSRF!)
Semplicemente non mi sento come se un documento Word fosse abbastanza ... UML? xmldoc?
Non è importante, ma è scritto in C #.