Olio-ohjelmointi WordPressissä: Työselostus

Ennen kuin siirrymme olio-analyysin ja suunnittelun aiheeseen (jolloin useimmat meistä saavat eniten hauskaa tekemistämme koodin kirjoittamisen lisäksi), on tärkeää seurata vielä muutamia asioita asiakkaiden vaatimusten ymmärtämiseksi. .

Edellisessä viestissä mainitsin:

Jos otat aikaa ymmärtääksesi, mitä he haluavat alusta alkaen, vaatimusten ei tarvitse olla 50-sivuinen asiakirja, jossa esitetään, kuinka jokaisen yksittäisen moduulin on toimittava.

Esimerkiksi aina kun kokoan vaatimuksia (tai työselvitystä), kuten yleensä kutsun niitä lähettäessäni niitä asiakkaille, ylitän harvoin kymmenen sivua, ja usein se on vähemmän.

Ja vaikka joskus se on pidempikin, mielestäni osa syynä siihen, että lyhyen vaatimussarjan kehittäminen tulee alustavien keskustelujen yhteydessä varmistaaksemme, että sinä ja asiakkaasi (asiakkaat) ovat kehittäneet yhteisen kielen, jolla voit työskennellä.

Kun teet niin, vaatimusten ja työselvityksen – kutsutpa niitä miksi tahansa – ei tarvitse olla niin pitkiä.

Työselosteen kirjoittaminen

Ensinnäkin haluaisin tehdä eron työselvityksen ja vaatimusten välillä tämän viestin yhteydessä.

• Vaatimukset ovat mitä asiakas haluaa rakentaa.
• Työselostuksessa kerrotaan yksityiskohtaisesti, mitä aiot tehdä, miten aiot tehdä ja kuinka paljon.

Käsittelen jälkimmäistä tarkemmin tässä postauksessa. Mutta riittää, kun todetaan, että asiakkaan kannalta vaatimukset voivat tulla keskustelujen, dokumentaation tai molempien muodossa.

Ennen kuin siirryn työselvitykseen sisällyttämäni eri osiin, on muutamia asioita, jotka mielestäni ovat mainitsemisen arvoisia:

1. Älä kirjoita työselvitystä ennen kuin olet täyttänyt kaikki asiakkaan vaatimukset.
2. Varmista, että asiakas tietää, mitä työselosteelta odottaa.
3. Jos aiot käyttää aikaa työselvityksen kirjoittamiseen, päätä, veloitatko ajasta vai et ja varmista, että asiakas tietää, että hänen on maksettava siitä vai ei.

Tämä on yksi niistä asioista, jotka ovat freelance-freelancer- tai virastokohtaisia. Tässä on työselostuksen osat, jotka yleensä sisällytän.

Työselosteen laatiminen

Aina kun laadin työselostusta, minulla on malli, jota käytän. Aion tarjota erittelyn, joka kattaa suuren osan tästä.

Näin kukin osio toimii:

1 Työselostus

Tämän asiakirjan tarkoituksena on [määrittää PROJEKTIIN ehdotettu ratkaisu].

Projektin vaatimukset on tarjonnut [ASIAKASNIMI], [ASIAKKAAN NIMEN ROOLI YRITYKSEN NIMESSÄ]. Sopimuksen ehdot ovat yhdistelmä niistä, joista [ASIAKAS NIMI] ja [TOIMISTON NIMI] ovat sopineet.

2 Vaatimusten yleiskuvaus

Tämän asiakirjan tarkoituksena on [määrittää PROJEKTIIN ehdotettu ratkaisu].

Projektin vaatimukset on tarjonnut [ASIAKASNIMI], [ASIAKKAAN NIMEN ROOLI YRITYKSEN NIMESSÄ]. Sopimuksen ehdot ovat yhdistelmä niistä, joista [ASIAKAS NIMI] ja [TOIMISTON NIMI] ovat sopineet.

3 Kielet ja tekniikka

Web-palvelin, ohjelmistot, työkalut ja lähestymistapa, joita käytetään ratkaisun rakentamiseen.

4 tuettua selainta

Jos tämä on verkkopohjainen projekti, ota huomioon tuetut selaimet, onko niissä responsiivisia toimintoja vai ei, ja kuinka aiemmat kohdat testataan.

5 Kielet ja tekniikka

Web-palvelin, ohjelmistot, työkalut ja lähestymistapa, joita käytetään ratkaisun rakentamiseen.

6 Projektin vaatimukset ja virstanpylväät

Tyypillisesti asiakirjan pisin osa. Se tiivistää:

• Vaatimukset,
• Miten kukin vaatimus rakennetaan ja toimitetaan,
• Kaikki lisähuomautukset, jotka asiakkaan tulee olla tietoisia.

7 Ehdotettu aikajana

Tämä perustuu edellisessä osiossa hahmoteltuihin virstanpylväisiin ja asiakkaan palautteeseen.

8 Muut tekijät

Sekalaisia ​​asioita, jotka haluat sisällyttää mukaan, kuten mitä sinä tai toimistosi päätät tuoda projektiin, kuinka viivästynyt palaute voi vaikuttaa projektiin ja niin edelleen.

9 Arvioidut kustannukset

Tämä sisältää hankkeen kokonaiskustannukset ja valinnaisen erittelyn maksuaikataulusta.

Se on välttämätöntä

Tiedän: Olen sanonut tämän aiemmin tämän sarjan aiemmissa viesteissä. Tämä ei ole toimintamme loistavin osa. Sen sijaan hyppäämme suoraan ohjelmointiin.

Mutta mistä tiedät mitä rakentaa (ja rakentaa se hyvin), jos emme ole kunnolla käsitelleet ongelmaa, jota yritämme ratkaista?

Ja sen kaikki, mikä johtaa olioanalyysiin ja suunnitteluun, antaa meille.

Olio-analyysi

Nyt kun olemme saaneet paperityöt (tai jopa "bisnesjutut", kuten jotkut saattavat viitata) pois tieltä, on aika aloittaa ohjelmointi.

Ennen kuin teet sen, on kuitenkin tärkeää analysoida vaatimukset ja määrittää, mitkä projektin osat palvelevat mitäkin tarkoitusta. Esimerkiksi:

• Tarvitsemmeko olemassa olevia ohjelmistoja?
• Pitääkö meidän kirjoittaa sovittimia tai tietokerroskoodia?
• Miten rakennamme sovelluskerroksen ja sen sisältämät kokonaisuudet?
• Entä etupää

Ja monille tästä hauskuus alkaa. Joten olen innokas aloittamaan keskustelun myös tästä. Aloitamme seuraavassa postauksessa.