Articles / Requisits i especificacions

Requisits i especificacions: com organitzar les decisions i els canvis

És més fàcil parlar de les peticions quan anoteu què cal, per què és important i com comprovareu el resultat. La gestió de requisits i especificacions permet continuar fent servir aquestes decisions a mesura que avança la feina.

Què gestiones a més del document?

Un document és només una manera de deixar constància d'una decisió. També cal saber quins punts s'han acordat, quins encara són propostes, qui respondrà les preguntes i què canvia quan es revisa un punt. Això ajuda a evitar que es treballi a partir d'interpretacions diferents d'una mateixa sol·licitud.

El mateix enfocament pot ajudar en el desenvolupament d'aplicacions, les eines internes, les condicions del producte i les normes operatives. Comenceu per una funció o un flux de treball en lloc d'intentar documentar-ho tot alhora.

Connecta l'objectiu, el requisit, l'especificació i els criteris d'acceptació

Els equips fan servir aquests termes de maneres diferents. En aquest exemple, un requisit descriu un resultat necessari o una restricció, una especificació registra el comportament acordat i els criteris d'acceptació expliquen com comprovar-lo. Poseu-vos d'acord sobre aquests significats amb les persones amb qui treballeu.

Objectiu: reduir la transcripció manual

Actualment, el procés d'informes mensuals implica copiar registres a mà. L'objectiu de l'exportació és facilitar aquesta feina.

Requisit: exportar els registres necessaris per a l'informe

Un membre del personal ha d'exportar els registres d'un mes determinat, dins de l'àmbit al qual té permís d'accés.

Especificació: defineix el fitxer i el seu comportament

Acordeu les columnes, l'ordre, la codificació del text, el format de data, el comportament quan no hi ha resultats i els errors. Són decisions per a aquest exemple, no valors predeterminats universals.

Criteris d'acceptació: fes que el resultat es pugui comprovar

Prepara registres amb dates i permisos coneguts, exporta'ls i compara el resultat amb el que s'havia acordat.

D'un objectiu als criteris d'acceptació Obre ReqSpec AI

Escriu una idea comprovable per element

Una frase com «Fes que l'exportació sigui còmoda» deixa decisions importants obertes. Separa la selecció d'un període, la tria dels camps de sortida, la gestió dels casos sense coincidències i la comprovació de l'accés quan aquests elements es puguin modificar o verificar de manera independent.

Feu servir condicions concretes en lloc de paraules com «ràpid» o «fàcil». Si és important assolir un temps de resposta determinat, anoteu la càrrega de treball, l'entorn i el mètode de mesura, a més de la xifra. Marqueu visiblement com a pendents de decidir els valors que encara no s'han decidit.

Abans: “Permetre l'exportació a CSV.”

Després: «Exporta el mes seleccionat amb les columnes i l'ordre de classificació acordats. Defineix els resultats buits i les comprovacions d'accés en elements separats».

La redacció revisada identifica les decisions que cal acordar i facilita assignar i revisar la feina. Encara calen definicions concretes dels camps abans d'implementar-la.

Un petit conjunt de camps per començar

ID, títol i descripció

Assigneu a cada element un ID estable, com ara REQ-001. Indiqueu el tema, la condició i el resultat esperat. Un ID estable permet fer-hi referència fins i tot després de canviar-ne el títol.

Motiu i font

Registra quin problema resol l'element i d'on prové, com ara una conversa, una sol·licitud o un document de suport.

Prioritat i abast

Distingeix el que cal per a aquesta versió del que pot esperar. Explica el motiu de la prioritat; no assignis la màxima prioritat a tots els elements.

Responsable i estat de la decisió

Anoteu qui aclarirà l'element i si és un esborrany, està en revisió o està acordat. El responsable de la implementació i qui l'aprova poden ser persones diferents.

Criteris d'acceptació i informació relacionada

Vinculeu l'element a les especificacions, els dissenys, les tasques i els registres de verificació pertinents. Manteniu aquests enllaços actualitzats quan canviï el requisit.

Exemple: tres requisits per a una exportació mensual de CSV

El següent és un exemple il·lustratiu. Cal acordar els noms dels camps i el comportament segons el producte que esteu creant; l'exemple no és una especificació completa de totes les funcions d'exportació.

REQ-001: registres del mes seleccionat

Exemple d’especificació: feu servir el mes seleccionat en la zona horària empresarial acordada i exporteu l’ID, la data del registre i el títol en UTF-8, ordenats primer per data i després per ID. Exemple d’acceptació: tres registres coincidents generen una fila de capçalera i exactament aquelles tres files de dades, sense registres d’altres mesos.

REQ-002: no hi ha registres coincidents

Exemple d'especificació: exporta la fila de capçalera acordada encara que no hi hagi cap registre coincident. Exemple d'acceptació: el conjunt de prova buit genera un fitxer amb aquesta capçalera i sense files de dades. Si prefereixes un missatge en lloc d'un fitxer, acorda i documenta aquest comportament diferent.

REQ-003: es comprova l'accés abans d'exportar

Exemple d'especificació: els usuaris sense permís d'exportació no poden generar el fitxer i no s'hi inclouen registres fora de l'àmbit permès. Els exemples d'acceptació han d'incloure un usuari sense permís d'exportació i un usuari amb accés limitat als registres.

Fes servir jerarquies sense perdre les decisions individuals

Agrupeu els elements per finalitat o funcionalitat i situeu les condicions detallades dins del grup corresponent. Per exemple: Informes → Exportació mensual de CSV → Registres objectiu / Format del fitxer / Resultats buits / Accés. Poseu els antecedents i les qüestions pendents a les notes en lloc de barrejar-los en un únic requisit llarg.

Si una condició afecta diverses funcions, mantén una referència clara a la versió acordada en lloc de copiar versions diferents a cada secció. Comprova quines especificacions posteriors i quins elements de verificació en depenen abans de canviar-la.

Manteniu separats l'acord, la implementació i la verificació

«Acordat» vol dir que el contingut s’ha acceptat per a l’abast previst. No vol dir que la funcionalitat s’hagi implementat. «Implementat» no garanteix que s’hagin superat els criteris d’acceptació acordats ni que la funcionalitat s’hagi publicat. Mantén visibles aquestes distincions encara que utilitzis una llista d’estats senzilla.

Reviseu el cas normal, les entrades buides o absents, els permisos i les fallades externes quan correspongui. Decidiu quines proves cal conservar, qui les revisa i qui pot donar per resolta una qüestió pendent.

Registra un canvi i el seu impacte abans de considerar-lo acordat

Una sol·licitud nova és una proposta fins que les persones responsables acorden com gestionar-la. Registra el motiu del canvi, els ID afectats i l'impacte en la feina, les dates, les especificacions i la verificació. Considera també si el canvi s'aplica als registres o als usuaris que ja fan servir la funció.

Després de prendre la decisió, actualitza l'especificació actual i avisa les persones afectades. Conserva la versió acordada anteriorment o una nota de canvi quan hagis d'explicar què ha canviat. No donis per fet que una eina registra automàticament totes les aprovacions i revisions.

Tria un lloc que puguis mantenir actualitzat

Per a una llista petita, pot ser suficient un document o full de càlcul compartit. Si la discussió, la implementació i la verificació es reparteixen entre diverses eines, trieu una referència principal i enllaceu-hi el material relacionat. El més important és que tothom pugui identificar el contingut acordat vigent.

Fes servir AI per fer un esborrany i després confirma les decisions

La IA et pot ajudar a enumerar possibles requisits, organitzar un esborrany i suggerir preguntes que falten. Separa els fets confirmats de les suposicions a la instrucció i demana-li que deixi els valors pendents de decidir com a preguntes. Revisa el resultat amb les persones que coneixen l'ús previst.

A ReqSpec AI pots organitzar els requisits i les especificacions jeràrquicament i utilitzar la IA com a ajuda per crear-los, editar-los i revisar-los. Fes una pregunta concreta com ara «Quines condicions de resultat buit continuen sense definir-se?». Considera qualsevol resposta com un suggeriment que cal contrastar amb el contingut registrat, no com una prova d’aprovació o d’exhaustivitat.

Comença amb una funció i una revisió

Tria una funció, enumera els resultats necessaris, assigna ID als elements i afegeix criteris d'acceptació i preguntes pendents. Revisa-ho un cop amb una persona implicada i després registra les decisions i la persona responsable del pas següent. Un conjunt petit que es manté actualitzat és més útil que un document extens que ningú no actualitza.

Lectures addicionals

NASA: Com escriure un bon requisit

NASA: Gestió de requisits

Organitza requisits i especificacions amb ReqSpec AI

ReqSpec AI ofereix una manera senzilla d'organitzar requisits i especificacions al mòbil i al web. Descobreix-ne les funcions a la pàgina de l'aplicació.