Come progettare (solo il contorno) un'applicazione PHP di classe enterprise

0

Da un anno a questa parte, ho lavorato a un'applicazione molto grande. Sono attualmente in versione 17, e ogni volta, ricomincio con un po 'del codice di prima. Ma ora, questo sta iniziando a diventare ingestibile.

Quando eseguo il disegno per l'applicazione, generalmente inizio con un documento Word, delineando tutte le classi, con le funzioni, le descrizioni per ciascuna, le loro dipendenze, i dati di configurazione predefiniti e il modo in cui ciascun componente aumenta il resto dell'applicazione . Ma con quel metodo, in poche ore, posso facilmente raggiungere 20-30 pagine di documentazione, e il semplice schema semplice del software perché così complesso di per sé, usarlo come modello per scrivere il codice diventa difficile.

Quindi, ora, sto cercando di descrivere l'applicazione in un formato XML, costruito su un XSD che contiene la struttura di come verranno presentate le classi. Ma questo sta anche dimostrando i suoi problemi.

In questa fase, è stato progettato tutto ciò che precede l'applicazione di base (i diagrammi del database er, la funzionalità, ecc.), ma i problemi principali si trovano nella progettazione del software sottostante che esegue tutto.

Quindi qualcuno può consigliare quale percorso dovrei andare giù, sia con modi specifici per disporre un documento di Word per una facile lettura, un modello XML che farebbe lo stesso, o qualche altro pacchetto software che può farlo per me e aiutarmi a guidarmi attraverso lo sviluppo?

Qualsiasi aiuto sarebbe molto apprezzato, soprattutto perché una volta che questa parte è stata decifrata, la mia applicazione può finalmente essere compilata e completata.

Grazie

    
posta topherg 10.10.2013 - 15:54
fonte

2 risposte

2

Qual è lo scopo principale del documento che stai creando. Sei l'unico sviluppatore che lavora sull'app o c'è un team che lavora con te?

  1. Non sottovalutare il potere della presentazione visiva. Una foto è vale più di mille parole. Potresti utilizzare alcuni UML disponibili strumenti o uno strumento di diagramma di base.
  2. Utilizza convenzioni di denominazione - questo ridurrà la necessità di documentare. Ad esempio, con DAO per tutte le classi di accesso ai dati. Quindi sarà evidente che UserDAO esegue tutte le operazioni relative al salvataggio e al recupero delle informazioni utente dal database.
  3. Documenta in dettaglio solo ciò che non è ovvio.
  4. Una rapida ricerca su Google ha trovato PHPDoc . Questo potrebbe aiutare a implementare il codice implementato
risposta data 10.10.2013 - 16:38
fonte
1

Pensa a come puoi renderlo più piccolo! Roba Chuck! Assegna priorità alle funzionalità e pianifica solo le cose con priorità più alta. Implementare quel minimo. Ottenere qualcosa di piccolo ma funzionante potrebbe comunque cambiare tutti i tuoi piani.

    
risposta data 11.10.2013 - 20:42
fonte

Leggi altre domande sui tag