Enne kui asume objektorienteeritud analüüsi ja disaini teemasse (see on siis, kui enamik meist saab koodi kirjutamise kõrval oma tegemistest kõige rohkem naudingut), on oluline jälgida veel mõnda asja, mis puudutab kliendi nõuete mõistmist. .
Eelmises postituses mainisin:
Kui võtate algusest peale aega, et mõista, mida nad tahavad, siis ei pea nõuded olema 50-leheküljeline dokument, mis kirjeldab, kuidas iga moodul peab töötama.
Näiteks kui ma koostan nõudeid (või tööaruannet), nagu ma neid tavaliselt klientidele saates kutsun, ületan harva kümmet lehekülge ja sageli on see vähem.
Ja kuigi on aegu, mil see on pikem, arvan, et see on osaliselt põhjus, miks lühikese nõuete komplekti väljatöötamine tuleb koos eelnevate aruteludega, et veenduda, et teil ja kliendil (kliendil) on välja kujunenud ühine keel, millega saate töötada.
Kui teete seda, ei pea nõuded ja tööavaldus – olenemata sellest, kuidas te neid nimetate – olema nii pikad.
Tööaruande kirjutamine
Esiteks tahaksin selle postituse kontekstis eristada tööaruannet nõuetest.
- Nõuded on need, mida klient soovib ehitada.
- Tööaruanne kirjeldab üksikasjalikult, mida te kavatsete teha, kuidas ja kui palju teete.
Viimast käsitlen selles postituses lähemalt. Kuid piisab, kui öelda, et kliendi jaoks võivad nõuded esitada arutelude, dokumentatsiooni või mõlema vormis.
Enne tööaruandes sisalduva eri osade käsitlemist on mõned asjad, mis minu arvates väärivad mainimist.
- Ärge kirjutage tööaruannet enne, kui olete kliendilt kõik nõuded täitnud.
- Veenduge, et klient teaks, mida tööaruandelt oodata.
- Kui kavatsete võtta aega tööaruande kirjutamiseks, otsustage, kas võtate aja eest tasu või mitte, ja veenduge, et klient on teadlik, et ta peab selle eest maksma või mitte.
See on üks neist asjadest, mis on vabakutseliste või agentuuride kaupa. Seda öeldes on siin tööaruande osad, mida ma tavaliselt kaasan.
Tööaruande koostamine
Kui koostan tööaruande, on mul mall, mida ma kasutan. Ma annan jaotuse, mis hõlmab suure osa sellest siin.
Iga jaotis töötab järgmiselt.
1 Tööaruanne
Käesoleva dokumendi eesmärk on [määratleda PROJEKTI pakutav lahendus].
Projekti nõuded on esitanud [KLIENDI NIMI], [KLIENDI NIME ROLL OMA ÄRINIMI]. Lepingu tingimused on kombinatsioon nendest, milles on kokku lepitud [KLIENDI NIMI] ja [TEIE AGENTUURI NIMI].
2 Ülevaade nõuetest
Käesoleva dokumendi eesmärk on [määratleda PROJEKTI pakutav lahendus].
Projekti nõuded on esitanud [KLIENDI NIMI], [KLIENDI NIME ROLL OMA ÄRINIMI]. Lepingu tingimused on kombinatsioon nendest, milles on kokku lepitud [KLIENDI NIMI] ja [TEIE AGENTUURI NIMI].
3 Keeled ja tehnoloogia
Veebiserver, tarkvara, tööriistad ja lähenemisviis, mida lahenduse koostamisel kasutatakse.
4 toetatud brauserit
Kui tegemist on veebipõhise projektiga, siis katta toetatud brauserid, kas seal on responsive funktsionaalsus või mitte ja kuidas eelmisi punkte testitakse.
5 Keeled ja tehnoloogia
Veebiserver, tarkvara, tööriistad ja lähenemisviis, mida lahenduse koostamisel kasutatakse.
6 Projekti nõuded ja verstapostid
Tavaliselt on dokumendi pikim osa. See võtab kokku:
- Nõuded,
- Kuidas iga nõue koostatakse ja täidetakse,
- Kõik lisamärkused, millest klient peaks teadlik olema.
7 Kavandatud ajakava
See põhineb eelmises jaotises kirjeldatud verstapostidel ja kliendi tagasisidel.
8 Muud tegurid
Mitmesugused asjad, mida otsustate kaasata, näiteks see, mida teie või teie agentuur otsustab projekti kaasata, kuidas hilinenud tagasiside võib projekti mõjutada ja nii edasi.
9 Hinnanguline maksumus
See hõlmab projekti kogumaksumust ja maksegraafiku valikulist jaotust.
See on vajalik
Ma tean: olen seda varem selle sarja varasemates postitustes öelnud. See pole meie tegemiste kõige glamuursem osa. Selle asemel hüppaksime otse programmeerimise juurde.
Aga kuidas sa tead, mida ehitada (ja seda hästi ehitada), kui me pole probleemiga, mida püüame lahendada, korralikult tegelenud?
Ja seda kõik, mis viib objektorienteeritud analüüsi ja disainini, meile annab.
Objektorienteeritud analüüs
Nüüd, kui oleme paberimajanduse (või isegi "äriasjade", nagu mõned võivad viidata), teelt välja saanud, on aeg hakata programmeerimisega tegelema.
Enne seda on siiski oluline analüüsida nõudeid ja määrata, millised projekti osad ja millist eesmärki täidavad. Näiteks:
- Kas me vajame mingit olemasolevat tarkvara?
- Kas peame kirjutama adaptereid või andmekihi koodi?
- Kuidas me ehitame rakendusekihi ja selle sees olevad üksused?
- Mis saab esiotsast
Ja paljude jaoks algab see lõbu. Nii et ma tahan ka sellest läbi rääkida. Alustame järgmisest postitusest.