🍶 🈳 🐓 Programme éducatif pour les spécifications techniques 🍿 🎺 🔹

Avantage: acquérir des connaissances sur les savoirs traditionnels et savoir comment les compiler. Enrichissez votre vocabulaire avec des mots: modèle conceptuel, flux de données, carte mentale, flux utilisateur. cas d'utilisation, wireframes, ER-modèle, client-serveur, API.

Pour qui: développeurs novices et ceux qui veulent être compris (par les clients, les startups et les managers).

Temps de lecture: 7 minutes.

Point de départ - exigences

Je veux un gâteau, puis une glace!
Vovka dans le royaume de Far Far Away

Il existe une idée fausse répandue selon laquelle il suffit de dire: "Vous avez besoin d’une demande pour un musée / chat / plante" et il deviendra immédiatement clair ce dont vous avez besoin.

Malheureusement, ce n'est pas si simple. Imaginez que vous ayez besoin de construire une maison. Vous allez chez le constructeur, et il se met au travail. Vous ne lui avez fourni aucun dessin ni intrigue, vous n'avez même pas dit de quelle couleur devait être la clôture. Mais ils ont tout donné sur tout pendant six mois et une somme d'argent importante.

Divulgacher

Terriblement vrai? Le budget a déjà été dépensé et le délai est expiré.

Pour éviter que cela ne se produise, toutes les exigences pour le produit sont fixes, c'est ce que tout développement commence par.

Type d'exigences pratique - TK

Pétrir et couper!
Vovka dans le royaume de Far Far Away

Bien. Il y a des exigences. Maintenant, les développeurs vous comprendront certainement. Mais voici le piège n ° 1: l'humanité n'a pas encore appris à lire dans les esprits. Par conséquent, il est nécessaire, sous une forme ou une autre, de transmettre des informations et la meilleure façon d'y parvenir est le mandat.

Il est également appelé TK, SRS, PRD - ce sont tous les noms du document dans lequel les exigences du produit sont fixées sous la forme correcte.

Piège n ° 2: la mémoire d'une personne n'est pas illimitée, il est toujours préférable d'avoir un endroit où tous vos souhaits et exigences sont fixes (pas la correspondance dans un télégramme ou un appel téléphonique). Par conséquent, les savoirs traditionnels sont un document texte imprimé avec l'application de diagrammes et d'infographies, non écrits à la main ou photographiés. Meilleur au format .PDF ou Google Docs.

Recette de savoirs traditionnels compétents

Les termes de référence pour les développeurs sont une sorte de recette pour un produit réussi. Un produit qui réussit est un produit facile à entretenir, qui peut être développé et modifié, il ne se désagrège pas lorsqu'un développeur change et fait des bénéfices sous toutes ses formes. Voulez-vous que votre projet soit terminé? Bien. Écrivez une bonne recette pour cela. Les ingrédients classiques (selon la norme internationale IEEE-830) sont:

Modèle conceptuel
Carte fonctionnelle
Chemin utilisateur
Interface utilisateur
Interfaces logicielles
Prérogatives non fonctionnelles

Les 2 derniers points sont spécifiques, je leur conseille de faire attention aux lecteurs proches du développement.

Ci-dessous, j'analyserai en détail chacun des éléments. Pour ceux qui ne veulent pas comprendre en détail, je laisse un lien vers la norme internationale avec un modèle de tâche technique: lien vers un document.

Modèle conceptuel

Cet article comprend une brève description du produit, il reflète l'objectif du projet et ses caractéristiques distinctives.

Par exemple: "Une application de rencontres où vous pouvez regarder de courtes vidéos dans les profils d'utilisateurs et discuter." Il est également agréable de dire quelques mots sur l'audience du produit, afin que l'équipe de projet puisse comprendre ses fonctionnalités et vous donner des conseils utiles. Parlez-nous de son âge, de son caractère et de sa situation territoriale, quelques caractéristiques qui devraient affecter le projet.

Par exemple: «Ce sont des jeunes qui partent à l'étranger pour leurs loisirs et qui s'intéressent à la communication en dehors de la barrière de la langue, qui aiment prendre des photos et des vidéos.»

Il vaut la peine de parler des types d'utilisateurs et de leurs principales différences.

Par exemple:«L'application devrait avoir des utilisateurs et des modérateurs réguliers qui reçoivent des plaintes des utilisateurs sur le contenu ou les profils. Les modérateurs peuvent consulter le chat des utilisateurs ordinaires après une plainte et bloquer un compte qui enfreint les règles du service. »

Et enfin, parlez-nous des composants de votre produit.

Par exemple: panneau d'administration utilisé par les modérateurs; Une application mobile que l'utilisateur utilise pour s'inscrire, ajouter du contenu, participer au chat, etc.

La voltige sera effectuée par le soi-disant flux de données ou tableau de contexte, qui reflétera la façon dont les utilisateurs interagissent avec le produit, ses composants et entre eux.

Carte fonctionnelle

La carte fonctionnelle affiche le concept général du projet avec le niveau de détail nécessaire pour évaluer l'étendue des travaux et établir les priorités. Dans un format traditionnel, une telle carte ressemble à une carte du site. Mais il est plus pratique de l'afficher sous la forme d'une carte mentale (cartes mentales, cartes d'intelligence). Souvent, les gestionnaires dessinent des mots lors de la réunion sur un tableau noir ou un morceau de papier et les liens entre eux, et donc, c'est la carte mentale. Cela peut être fait facilement dans les services gratuits (coggle, draw.io et mindmeister) ou simplement dans Office Word.

Il est très important de refléter toutes les fonctionnalités utilisateur dans la carte fonctionnelle. En première approximation, il s'agit simplement d'un ensemble de fonctionnalités du produit.

Par exemple: «L'application doit inclure l'enregistrement par courrier, la création et le remplissage de données de profil, la possibilité de télécharger et de modifier des photos et des vidéos, une liste des comptes des autres utilisateurs avec différents types de filtres, un chat textuel et un contact avec le support.

Chemin utilisateur

Le flux utilisateur, ou chemin utilisateur, est une liste séquentielle d'actions ou d'écrans que l'utilisateur peut parcourir lorsqu'il interagit avec le produit. Décrivez comment l'utilisateur va interagir avec le produit dans votre présentation. Très commodément, cela peut également être fait avec une carte mentale ou simplement une liste d'actions.

Par exemple: «Un utilisateur se connecte pour rencontrer des pairs. Il remplit son profil de données et télécharge des photos et des vidéos. Ensuite, l'utilisateur entre le flux et le filtre selon certains critères. En conséquence, il reçoit une liste de profils pertinents, peut les consulter et écrire à un autre utilisateur dans le chat.

Le chemin utilisateur est un algorithme général pour travailler avec le produit. Il existe également des cas d'utilisation (cas d'utilisation) - il s'agit d'un détail du flux d'utilisateurs. Dans le cas d'une application de rencontres mobiles, vous avez créé le chemin de l'utilisateur à travers les écrans, puis décrivez ce que l'utilisateur peut faire sur chaque écran.

Par exemple: sur l'écran d'inscription, l'utilisateur peut:
accéder à l' écran d' autorisation , s'inscrire via les réseaux sociaux (Facebook, Twitter), saisir l'e-mail, le mot de passe, puis le répéter et confirmer l'inscription dans l'e-mail.

Interface utilisateur

Le produit doit non seulement fonctionner, mais aussi être joli. Éloignons-nous un peu du sujet des candidatures pour ne pas vous forcer à les télécharger pour révision. Mieux vaut regarder des sites mignons:

Nous avons examiné un exemple de mauvaise conception, essuyez maintenant le sang des yeux et passons à la discussion de l'interface. Dans cette partie de la tâche technique, il est utile d'attacher des arbitres - des exemples de la façon dont vous voulez voir votre produit. Il peut s'agir d'analogues de développements similaires ou simplement d'exemples dont vous avez aimé la conception.

Décrivez en termes généraux comment vous voulez voir votre produit, quelles couleurs il doit avoir, quels éléments utiliser, quelle animation vous voulez, etc. Si vous avez une identité d'entreprise ou un livre de marque, excellent, référez-vous à eux.

Les concepteurs vous remercieront beaucoup si vous spécifiez un style de conception d'interface, tel qu'un design plat ou un design matériel.

La voltige ajoutera des wireframes (wireframes) - prototypes de l'interface du produit sous forme de circuits approximatifs.

Interfaces logicielles

Cette section est destinée aux professionnels. Si vous avez confiance en vos capacités, poursuivez votre lecture. La meilleure tâche technique décrit également l'architecture du produit, c'est-à-dire les composants logiciels qui le composent. Dans le cas d'une application de datation client-serveur, le service est divisé en une partie du serveur qui stocke les données et les traite, effectue certaines opérations logiques et une partie du client qui affiche les données.

Le serveur est décomposé en modules: bases de données, authentification, chat, etc. Le client communique avec le serveur via des API (interfaces de transfert de données), vous devez indiquer son type (REST, WEB, RPC, etc.) et décrire les méthodes, réponses et la gestion des erreurs.

Les données sont généralement stockées dans la base de données sous forme de structures spéciales, le plus souvent des tables (pour les bases de données relationnelles) et des structures json (pour les non relationnelles). Les développeurs vous remercieront beaucoup si dans la tâche technique vous spécifiez les entités de base de données (modèles ER) et décrivez les champs stockés, en indiquant leurs types de données (chaîne, int, etc.), les clés (primaires, étrangères), obligatoires (obligatoires) ) et annulable.

Prérogatives non fonctionnelles

Ce sont des exigences générales du produit. Ils peuvent être divisés en exigences techniques, exigences de sécurité et exigences de performances. Les exigences techniques indiquent les souhaits pour les appareils et l'environnement d'exploitation, par exemple pour les applications de datation, à savoir Android 7.0+ et JDK 8+, iOS 11.0+ et Swift 4.2.

Dans les exigences de sécurité, vous pouvez spécifier que le transfert de données dans le chat doit être effectué à l'aide du chiffrement SHA-1 et que lors de l'enregistrement, la complexité du mot de passe doit être d'au moins 8 bits. Les exigences de performances parlent de la connexion des composants et de la tolérance aux pannes, par exemple, indiquent que le délai d'expiration pour lire un message de discussion pendant au plus 1 s et que l'application stocke partiellement le cache et peut fonctionner hors ligne pendant une durée limitée.

Conseil

PDF, . , .
, , , .
-, , .
, , .
. , .
Préparez-vous à passer plus de quelques jours ou consultez un professionnel pour rédiger un article. Des termes de référence compétents vous éviteront de longues discussions sur les détails avec les développeurs et définiront des critères clairs pour la livraison du projet. Par exemple, un mandat à part entière selon la norme IEEE-830, joint au contrat de développement, est un argument devant les tribunaux en cas de non-respect des exigences.

Programme éducatif pour les spécifications techniques