Programmerare! Föredrar Du visuellbaserad kravspecifikation?

Sakfrågan är hur Du som programmerare inom (webb)appar föredrar att få kravspecifikation presenterad för att du skall känna att du skall kunna leverera godtyckliga resultat utifrån den erhållna kravspecifikationen.

För ett tag sedan hittade jag UX-skissverktyg där man då kan ta fram visuellt hur man vill att det skall se ut ((webb)appen ifråga) och sedan kan man skissa ut vilka variabler, databaser, funktioner, med mera som tillhör diverse fält, bilder, texter, knappar, per tillgänglig sida i appen? Självfallet genomsyras allt detta med säkerhetstänk också.

Jag skall nämligen ta fram en rätt exakt kravspecifikation av ett skräddarsytt CRM-system som ska vara lika lättanvänt i mobilen, på surfplattor som på vanliga datorer. Förstnämnda är utmaningen enligt mig medan det mesta går att få till på "vanliga datorer".

I princip tänker jag mig en "visualboard" för webbappen, typ ett flödesschema men som programmerare kan använda sig av för att faktiskt koda det önskade istället för att de skall försöka gissa sig fram hur det hela hänger ihop!

MEN! Det finns en hake i det hela som klurar till det: sekretess eftersom CRM-systemet är en del av affärshemligheterna från uppdragsgivaren som jag sköter de tekniska bitarna åt.

Tack för alla svar. Detta är återigen varför jag älskar Sweclockers "Wisdom of the Crowd"-grej! <3

Det hela rör sig om ett (tycker jag) enkelt CRM-affärssystem i form av back-office (för att 2-3 personer skall kunna använda det som sin arbetsplats istället för att behöva göra massa saker i Trello - där det tillkommer mycket manuella uppgifter som kan automatiseras - som det ser ut just nu)

Det jag skall ta fram då med Adobe XD (då jag har den UX-programvaran) är deras flödesschema för när de lägger upp en ny kund som de "bearbetar" (så att kunden skriver på ett kontrakt via Oneflow e-signering, vars API:er jag antar kan anropas av CRM-affärssystemet) eller om de tar upp en befintlig kund för att kanske förnya ett kontrakt eller göra andra ändringar.

Detta betyder då att det finns ett logiskt A->B->C arbetsflöde (ett antal skärmar/fönster) med olika variabler som i princip bara ska behöva matas in en gång (sådant sparar tid än när de nu måste mata in samma personuppgifter exempelvis först i ett Trello-kort, sedan i kontrakt som skickas ut, samt när de skall fakturera i Fortnox).

På tal om det: hur öppna är Fortnoxs API:er? (om de ens är det)

Sekretessdelen är just för att hela deras arbetsflöde (hur de fixar å gör affärer med nya och befintliga kunder) är en del av deras affärshemligheter vilket gör det hela lite klurigt. Deras nuvarande arbetsflöde innehåller dock många manuella uppgifter som skulle kunna automatiseras/effektiviseras helt enkelt.

En "gotcha!" jag kom på är att man bör också välja en databastyp (MongoDB eller dylikt) som är okej med att två är inne samtidigt och bearbetar olika kunder eller till och med samma kund i vissa fall. Då krävs det att det kan fungera i realtid av flera användare/sessioner samtidigt utan att det buggar ut. Jag har för mig att i webbapplikationer brukar ReactJS vara en lösning för detta ändamål?

Det finns redan en upprättad databas som är "den heliga graalen" i deras affärshemligheter. Och då detta är klassiskt Excel-dokument så ska det inte bli några problem att göra om till en utvald databas (MongoDB eller vad som anses fungera bäst för att kunna ha flera användare samtidigt som anropar databasen utan att det buggar/kraschar).

Grovjobbet i programmeringen sedan är att göra ett arbetsflöde som automatiserar mycket genom att läsa från och/eller skriva till denna omvandlade databas samtidigt den samverkar med exempelvis Automatiserade SMS/E-post, Fortnox (om det ens går), samt Oneflow. Och allt detta är som sagt var ännu back-office endast.

Jag har något språkligt problem med "godtycklig". Jag tänker "tycka är god/bra nog" när jag hör ordet!

Jag har nu skummat igenom en "Crash course" i Adobe XD (välsigna YT!) och skapat följande flöde av Artboards/Canvas än så länge:

Det hela skall kunna göras mobilt vilket är varför jag valt en iPhone som canvas för UX-flödet.

En brist jag ser just nu i Adobe XD är att det verkar inte finnas något slags verktyg för att kommentera olika element som man sedan kanske kan slå av och på för att se? Just nu måste man kolla under "All Items" och nyttja finurliga namn för alla element för att förstå vilka programmeringsvariabler de syftar till.

EDIT: Något som kanske fungerar tillsvidare är plugin "Notes and Annotations" då den låter mig lägga text utanför en Canvas/Artboard utan att det försvinner.

T.ex. "EditField.AdminUsername" innebär då klassiskt textredigeringsfält i webbläsare och syftar då givetvis på fältet under "Användarnamn"-texten. Men om jag vill lägga en kommentar för "Logga in"-knappen för att berätta vart den skall leda då? Nu visar förvisso blåa strecket det under "Prototype"-läget.

En annan brist är att Prototype och bland "Triggers" så verkar det inte finnas något om att kunna skriva in text i fält som sedan tas med till nästa ruta? Finns det andra UX-skissprogram som möjliggör sådan interaktionsnivå för att prototypa webbapplikationers flöden?

Fråga: Vad skulle programmerare vilja få kompletterat med här för känna att de vet mer exakt hur de skall gå tillväga med kodningen gällande Variabler, Funktioner, anropningar av valda databaser och externa API:er? (t.ex. från Oneflow) Skulle ett textdokument som förklarar varje Artboards/Canvas olika Items/Elements och hur de interagerar med varandra i olika Artboards/Canvas vara lämpligt?

Den databas som alla funktioner/API:er kommer att använda sig av (inkl. externa tjänster som bland annat Oneflow) innehåller ungefär 40 kolumner vilket betyder 40 datatyper/struct variabler som i sin tur skall interagera på olika vis (med hjälp av funktioner, API-anrop, läsa/skriva från/till databas).

Den bild jag visade bör ej ses som visuellt designkrav utan snarare bara göra det lättare. Men nu när jag läst andras svar så verkar Wireframing vara vad jag är ute efter att få fram "flödesskiss". Adobe XD och dylika verkar vara mer hur hela upplevelsen känns från ett mer visuellt perspektiv. I detta fall skall funktion gå före design även om "bra design underlättar användandet av funktionaliteten".

Även om det är detaljstyrt så är det snarare "detta är vad jag TROR då kommer innebära i form av variabler, funktioner, databaser" med mera. Sedan är de ju experterna som vet om det kanske behövs fler variabler, fler/färre funktioner, osv. Du får väl ändå vara glad att jag inte är bakom flötet när väl kommer till programmeringskritan jämfört med många andra så kallade "kravställare"!

Jag skall prova Figma. Går det att skapa wireframing där du inte bara kan klicka mellan "fönster"/canvas"/artboards"/"flöden" utan också mata in något eller kryssa i något vilket i sin tur påverkar vad som visas/sker i nästa steg i flödet? Alltså en viss "intelligent interaktion". Eller får man göra så text animeras fram "som om" de gjorde något mer interaktivt i föregående flöde?

Härifrån i detta videoklipp så visas vad som tycks vara "Design Document" i kodningssammanhang:

Då berättar snubben att "Design Document" skall kunna läsas av flera människor, inklusive de som inte är lika kunniga. Jag agerar i princip som en "översättare/brygga" mellan den som har den visuella helhetsvisionen över vad de vill ha för att sedan kunna förmedla detta på ett mer tekniskt sätt samtidigt som jag INTE är lika tekniskt kunnig som de som faktiskt skall sätta ihop det i slutändan. Och då får de berätta för mig vad som är tekniskt (o)möjligt och inte så får jag sedan föra vidare det till personen med "slutvisionen". Kompromisser görs och sedan går det framåt.

Antalet personer inblandade i detta är 3 personer exklusive faktiska programmerare. Detta är varför jag vill veta hur jag kan presentera det för programmerare så de lättare och snabbare kan få ett hum om vad som är tekniskt (o)möjligt. Sedan innebär det inte att det blir perfekt första gången (testkörningar, buggfixar, osv) trots all möjlig detaljstyrning.

Beträffande "hur" så är det snarare "förslag" från mitt håll då experterna vet bättre än mig om antalet nödvändiga datatyper, variabler, databaser, funktioner, API:er, osv. Kanske färre behövs, kanske fler behövs. Kodarna vet bättre än mig. Samtidigt vill jag påstå att jag kan troligen kravställa bättre och konkretare än diverse myndigheter *humblebrag*.

Utifrån antalet kolumner ur den enda databas som används som är "den största affärshemligheten" så har jag ett hum om hur många variabler det rör sig om exklusive "Påminnelsefunktioner" som ökar QoWL (Quality of Work Life).

Från en annan tråd har jag nu tagit den faktiska "Kravspecifikationen" som BOLAG försett WEBBYRÅ vilket är en del av bakgrunden bakom denna tråd - varför jag skapat den. Det är en del av en Offert. OBS: Jag vet INTE om kravspecifikationen nedan togs fram av BOLAG innan eller i samverkan med WEBBYRÅ och att det då kanske var sistnämnda som skrev ned Kravspecifikation nedan här:

Kravspecifikation i Offert[Det jag skriver inom dessa är mina egna kommentarer]:
- Frikoppla och förbättra BOLAGs kontaktformulär från nuvarande Wordpress-webbplats
- Koppla ihop leadgenereringen med deras nuvarande CRM-system (Trello) via dess öppna API med målet att alla leads landar i Trello direkt för vidare bearbetning och kvalificering
- Bygga bort redundans och spetsa till leadkonverteringen
- Förbättra och förfina UX-förfarandet av kontaktformulären på webben
- Fräscha upp och förtydliga deras befintliga webbplats
- Implementera Google Firebase för att bygga bort BOLAGs dependencies av G-suite (bilder & offerter)
- Implementera ett automatiskt skapande av offert för att dra ned manuella steg i nuvarande process
- Möjlighet att skapa offertrar direkt från BOLAGs system till en fristående signerspartner [idag används Oneflow]
- Se över befintliga CRM-system och bokföringssystem [idag används Fortnox] på marknaden för ett eventuellt byte i steg 2 (mini-förstudie)
- Se över signersspartner av offerter och avtal för integration. Implementationen och integreringen sker i steg 2.
- Implementera en kvalitativ e-posttjänst (förslagsvis Office 365 eller liknande lösning) [idag används diverse Googlekonton via Thunderbird med BOLAGs domänamn som ändelse tack vare webbhostingleverantören one.com]

Min fråga då är simpel: Hur tydlig eller otydlig är denna kravspecifikation ställd gentemot WEBBYRÅ från BOLAG?

Jag vill ta fram kravspecifikationer (=ska med), inte förslag (=vore kul om det kom med). Min nuvarande uppfattning är att det handlar om att eliminera så många "gissningslekar" som möjligt för att minimera mängden extraarbete vilket för oss till en viktig rosa elefant i det digitala rummet: Det finns en uppenbar ekonomisk intressekonflikt mellan uppdragsgivaren ("kunden") och uppdragsutföraren (programmerare).

Kunden vill mjölka så få arbetstimmar som möjligt och få det överenskomna enligt kravspecifikationen. Programmerare vill mjölka så många arbetstimmar som möjligt samtidigt som det inte skall framstå som så. Det hela är fullt förståeligt ur bådas ekonomiska perspektiv och egenintressen. Jag vill hitta den gyllene medelvägen här för jag orkar inte med massa trams, drama, och sociala maktekonomiska spel här i arbetslivet vilket dock är en oundviklig del.

T.ex. för ett par veckor sen skicka BOLAG en offert till en potentiell samarbetspartner inom ett mångmiljonprojekt som då svara med att, "Ert pris är 3 gånger högre än vad andras offerts är". Antingen stämmer detta eller så försöker den potentiella samarbetspartnern att pruta priset och det hela är förståeligt: ALLA VILL TJÄNA PENGAR TILL MINSTA MÖJLIGA KOSTNADER.

Just jag var ej med under denna framtagning av Kravspecifikation då det var under 2020 när jag inte konsulterade åt bolaget. Började tidigast med det slutet på 2021.

Och jag håller 100% med: det saknas operationella definitioner i kravspecifikationen som på så vis kan svara på avtalsfrågan (som också saknas) "Definitionen av färdig levererad IT-produkt".

Min fråga då som återkommer till kärnan av tråden: Vad för slags kriterier kan man ställa upp då UTAN att bli för alldeles detaljstyrd vilket jag uppenbarligen är? (självfallet är detta olika beroende på projekt och vad som i helhet kravställs, men ungefär/exempel?)

Tack för din input förresten!

Jag förstår. Jadu, snacka om två olika världar:

WEBBYRÅ vill endast göra det som ligger inom kravspecifikationen vilket är helt förståeligt.

BOLAGSchef säger känslomässigt nu att:

Jag vet inte dock hur man skall förklara för en BOLAGschef om begränsningar sett till vad WEBBYRÅ faktiskt kommer att göra utifrån vad de ska göra (utifrån Kravspecifikation) samt utifrån vad de faktiskt har för kompetens att kunna göra. Tydligen har det blivit 2 månaders fördröjning nu bara med att komma till ett videomöte om att gå igenom om vad som ska göras och inte göras.

Dessvärre tror jag att BOLAGschef förväntar sig att de skall göra allt som sägs tills "BOLAGET är nöjd" vilket knappast lär hända. Jag söker på "juridik tvister med webbyrå" för att se om liknande fall har inträffat och möjliga domstolsutfall för dessa tvister.

På tal om Agile så nämns just det i offert från "Avsändare WEBBYRÅ" (så jag antar att WEBBYRÅ skrev hela offerten, inklusive den superluddiga kravspecifikationen vilket borde klassas som något slags avtalsbrott) under "Förslag på arbetsätt":

Låter detta som "typisk branschpraxis" för kodningsbaserade projekt inom IT-världen eller är detta dylikt "superluddigt" som Kravspecifikation nämnt sedan tidigare i tråden?