Cómo escribir una descripción de requisitos de software

Cómo escribir un informe de análisis de requisitos (Especificación de requisitos de software GB856T-88)

Recientemente, se han solicitado nuevamente algunos proyectos de investigación científica en la escuela y algunos estudiantes han comenzado a Pídame información escrita sobre una pregunta de ingeniería de software. Lo resumí aproximadamente y lo escribí aquí. Este artículo implica la redacción de la parte de análisis de requisitos, que se basa principalmente en los requisitos de los documentos estándar nacionales.

En las empresas de Internet o en algunas empresas de desarrollo ágil, todos adoptan la actitud de centrarse en el desarrollo, la discusión y la documentación. Esta documentación liviana no significa que no haya documentación o casi no haya documentación, sino que se libera del estricto proceso de documentación y solo escribe las partes más prácticas. Esta característica está determinada por el corto ciclo de iteración de Internet y el rápido lanzamiento de versiones. Cuando se trata de proyectos reales a tiempo parcial, los estudiantes deben prestar atención. Lo más importante debe ser adjuntar el análisis de necesidades más claro al firmar el contrato, aunque esta declaración de necesidades puede no coincidir con algunos documentos estándar. Descripción clara del efecto logrado por cada función, y este efecto debe hacer que los clientes asientan con la cabeza para confirmar, en lugar de respuestas vagas como "debería ser", "puede ser" y "tal vez". De lo contrario, será más difícil más adelante en el proyecto. En proyectos solicitados por escuelas y desarrollo de proyectos en grandes empresas, el proceso de documentación se toma en serio, paso a paso. Por lo tanto, es mejor tratar la profundidad y el estándar del documento según la situación.

1. Tabla de contenido: la tabla de contenido debe utilizar la palabra “referencia” -> “tabla de contenido” para generar automáticamente una tabla de contenido, generalmente una tabla de contenido de tercer nivel. Por lo general, básicamente no es necesario cambiar la estructura de esta parte, simplemente actualice los números de página directamente.

2. Parte del contenido. ?Descargar la especificación de requisitos de software estándar nacional G856T-88

1 Introducción

1.1 Propósito de la redacción

Describa el propósito de escribir esta especificación de requisitos de software e indique el objetivo previsto. lectores.

(Esta parte describe la descripción general del informe de análisis de demanda, por ejemplo: Este informe de análisis de demanda X está escrito para el sistema S. Una descripción general de dos oraciones del sistema S. Este informe X está destinado a hacer que U1 (demandante) Aclare los requisitos y detalles del sistema S, deje que U2 (desarrolladores) comprenda la dificultad y la dificultad de cumplir los requisitos y finalmente proporciónelos a U3 (revisores, gerentes) para su discusión y revisión para lograr efectos de comunicación)

1.2 Antecedentes

Descripción:

a. ?El nombre del sistema de software a desarrollar;

b. ?El proponente de la tarea, desarrollador, usuario de este proyecto y el centro de cómputo o red informática que implementa el software;

c. ?La interrelación básica entre el sistema de software y otros sistemas u otras organizaciones.

(Esta parte se puede dividir en dos partes a, b y c. El ejemplo es el siguiente:

1.2.1 Descripción general del proyecto

¿Qué es? Lo esperado en este informe de análisis de demanda. El sistema de software desarrollado es: S. S es un determinado submódulo funcional del sistema SS, la relación entre S y S1, S2 y otros sistemas, así como una descripción general del estado de otros sistemas. , etc.

1.2.2 Asignación de tareas

a Proponente de tareas: xxx

b Desarrollador de software: xx

c. Usuario del producto: xx

d. Redactor del documento: xx

e. Usuarios previstos del producto: xx

)

1.3 Definición

Enumere las definiciones de los términos técnicos utilizados en este documento y las frases originales de las siglas extranjeras.

(Esta parte es muy simple, es para describir vocabulario profesional, como

1. XML (Extensible Markup Language) es un lenguaje de marcado extensible. Al igual que HTML, es SGML (Lenguaje de marcado generalizado estándar, Lenguaje de marcado general estándar)

2. Word2,?Explicación.

)

1.4 Materiales de referencia

Enumere materiales de referencia útiles, como por ejemplo:

a. ?La declaración de misión aprobada o contrato de este proyecto, y el documento de aprobación de la autoridad superior;

b. ?Otros documentos publicados pertenecientes a este proyecto;

c. ?Los documentos y materiales citados a lo largo de este documento incluyen los estándares de desarrollo de software que se utilizarán. ?Indique el título, número de documento, fecha de publicación y unidad de publicación de estos documentos e información, e indique la fuente de la cual se pueden obtener estos documentos e información.

2 Descripción general de la tarea

2.1 Objetivos

Describir la intención, los objetivos de la aplicación, el alcance del desarrollo de software y otra información sobre el desarrollo de software que se debe explicar a material de referencia de los lectores. Explicar la relación entre el software que se está desarrollando y otro software relacionado. Esto se indica si el Producto de software es un software independiente y es completamente autónomo. Si el producto definido es un componente de un sistema más grande, se debe describir la relación entre el producto y otros componentes del sistema. Para este propósito, se puede utilizar un diagrama de bloques para ilustrar los componentes del sistema y el producto. interfaces con otras partes. |

(

El desarrollo de este módulo es principalmente para servir el servicio general de SS y completar la parte XX del trabajo de SS y trabajos relacionados. Su alcance es desde la emisión A hasta la B Después del comando, vaya al proceso de dar el resultado C. Descripción específica: B1, para completar la función B11; B2, para completar la función B22, etc. Esta parte (no) está acoplada a otras partes del kit de herramientas de segmentación de palabras; , principalmente para El modo integrado y el modo secuencial interactúan entre sí

Figura

Figura 1. La relación y la interfaz entre los componentes del sistema y otras partes

)

2.2 Características de los usuarios

Enumere las características de los usuarios finales de este software, describa completamente el nivel de educación y experiencia técnica de los operadores y el personal de mantenimiento, y la frecuencia esperada de uso de este software. Estas son limitaciones importantes para el trabajo de diseño de software

(Por ejemplo: desarrollo secundario y personal de llamadas al sistema: tener un alto nivel de conocimiento profesional y comprender el mecanismo operativo de XX. Puede leer y analizar códigos abiertos para cumplir las necesidades únicas del sistema, abra el manual de API y el código fuente de la versión de depuración para estos usuarios, se espera que estos usuarios representen una gran proporción del total de usuarios de este sistema. Usuarios de xx: tienen ciertas capacidades y conocimientos de operación de computadoras, y comprenden los conceptos y usos relevantes en el campo de xx. Se espera que estos usuarios realicen principalmente operaciones de xx simples: tienen un alto nivel de experiencia en computadoras, pueden rastrear y analizar los comunes. errores del sistema y tienen ciertas capacidades de prueba? Este grupo de usuarios son principalmente mantenedores posteriores al trabajo después de adoptar este sistema

Etc.

)

2.3. Supuestos y restricciones

Enumere los supuestos y restricciones para el desarrollo de este software, como restricciones de financiación, plazos de desarrollo, etc.

(Esta parte se basa principalmente en suposiciones sobre su solidez técnica, situación financiera, recursos humanos, etc., para que pueda completar el trabajo en qué circunstancias y plazos. Limitaciones de tiempo de construcción, limitaciones financieras, se enumeran y explican las limitaciones de personal, las limitaciones geográficas, las limitaciones de equipo y otros aspectos)

3 Requisitos

3.1 Requisitos funcionales

Utilice una lista (por ejemplo, una tabla IPO tiene la forma de una tabla de entrada, procesamiento y salida). Describir los requisitos funcionales para el software elemento por elemento, cuantitativa y cualitativamente, explicar qué cantidad se ingresa, cómo se procesa, qué salida se obtiene y qué terminales debe admitir el software y la cantidad de usuarios que operan en paralelo que deben admitirse.

(Por ejemplo:

ENTRADA entrada

PROCESO procesamiento

SALIDA salida

CARGA carga

A

Preprocesamiento, qué acción tomar,

AA

CC

B

BBBB

Sib

v

C

CCCC

cc

v

Tabla 1, tabla IPO del módulo xx

Una descripción de texto simple de la tabla IPO

)

3.2 Requisitos de rendimiento< /p. >

3.2.1 Precisión

Explique los requisitos de precisión para los datos de entrada y salida del software, que pueden incluir precisión durante la transmisión.

(Por ejemplo:

Procesamiento de objetivos Xx: 1Byt–10M, incluidos los valores de límite izquierdo y derecho.

rango de precisión yy:….

Precisión de ZZ: debido a la particularidad de xx, este sistema utiliza el tipo xx para operaciones estadísticas de caracteres, y la precisión de la parte de probabilidad y otras partes de relación tiene una precisión de 0,0x

)

3.2.2 Requisitos de características de tiempo

Explique los requisitos de características de tiempo para el software, tales como:

a. ?Tiempo de respuesta;

b. ?Actualizar el tiempo de procesamiento;

c. ?Conversión de datos y tiempo de transmisión;

d. ?Requisitos de tiempo para la resolución de problemas; etc.

(Estas partes solo deben enumerarse una por una:

Dado que el proceso xxx requiere una gran cantidad de operaciones xxxx o algo así, el tiempo de resolución de problemas xx representa la mayor cantidad parte del tiempo total es la sobrecarga de conversión y almacenamiento de xx. Los requisitos de características de tiempo específicos son los siguientes:

a. ?xx tiempo de respuesta: aproximadamente xxms; ?yy tiempo de procesamiento de actualización: yy;

c. ?zz tiempo de conversión y transmisión de datos: zz; ?vv tiempo de resolución de problemas:

Esperando

)

3.2.3 Flexibilidad

Explique los requisitos para la flexibilidad del software, es decir, cuando ocurren ciertos cambios en los requisitos, la capacidad del software para adaptarse a estos cambios, como :

a. ?Cambios en los métodos operativos;

b. ?Cambios en el entorno operativo;

c. ?Cambios en las interfaces con otro software;

d. ?Cambios en la exactitud y el plazo de validez;

e. ?Cambios o mejoras planificadas.

Deben identificarse secciones especialmente diseñadas para proporcionar esta flexibilidad.

(Esta parte se puede enumerar como una lista. Dado que el primer propósito de este módulo es usarse para xxx, seguido de xxxx. Por lo tanto, la flexibilidad de este módulo depende de la aplicación real. Cuando ocurre cierta demanda La capacidad del software para adaptarse a estos cambios es la siguiente:

f. Cambios en el modo de operación: se adoptan dos modos: sistema operativo integrado y sistema operativo independiente. El módulo está integrado en el marco principal. del conjunto de herramientas de segmentación de palabras, que proporciona a los usuarios software operable con una determinada interfaz de usuario; el sistema de ejecución independiente es un modo de trabajo que puede ejecutarse de forma independiente en segundo plano y proporcionar modos para llamar a varios programas para mejorar su vitalidad. g. Cambios en el entorno operativo: utilice principalmente la versión compilada de la plataforma Windows para ejecutar y depurar. Cuando el tiempo lo permita, se desarrollará simultáneamente una versión del servidor que admita SUSE Linux.

h. con otro software: se permite la sobrecarga y la redefinición de interfaces mientras se intenta garantizar que las interfaces no se cambien;

Precisión y el cambio del límite de tiempo efectivo: la precisión puede fluctuar en 10 puntos porcentuales bajo el. condiciones que deben ajustarse; el límite de tiempo efectivo permite una gama ligeramente más amplia de cambios en función de la situación real de la prueba.

j. Cambios o mejoras en el plan: habrá ciertas fluctuaciones en el cronograma de trabajo. Esta parte debe negociarse con otros miembros del equipo de diseño del proyecto del kit de herramientas de segmentación de palabras. El plan inicial se puede cambiar ligeramente y los arreglos posteriores se deben implementar según corresponda. planificado.

Espera

)

3.3 Requisitos de entrada y salida

Explique cada tipo de datos de entrada y salida, y explique su medio, formato, rango de valores, precisión, etc. Explique y dé ejemplos de las salidas de datos y de control del software que deben etiquetarse, incluidas descripciones de informes impresos (salida de resultados normales, salida de estado y salida anormal) e informes gráficos o de visualización.

(Esta parte puede dividir la entrada y la salida en 3.3.1 requisitos de entrada y 3.3.2 requisitos de salida. A continuación se proporciona un ejemplo de una unidad.

XXX salida

Nombre de datos: XXX datos de salida

Significado real: utilizado para XX, que representa XXXX

Tipo de datos: carácter (cadena)

Formato de datos: XX

Restricciones de datos: debido a xxx, el tamaño está dentro de xx

)

3.4 Requisitos de capacidad de gestión de datos

Describa qué necesidades a gestionar El número de archivos y registros, el tamaño de tablas y archivos, y los requisitos de almacenamiento de los datos y sus componentes deben estimarse en función del crecimiento previsible.

Simplemente enumere según los requisitos reales del sistema

Nombre

Número cantidad

Tamaño

Aumentar crecimiento

Diccionario xx

xx

xxxx

Ejecutado en paralelo, su tamaño se basa en el texto real xx grande y crecimiento

)

3.5 Requisitos para la resolución de problemas

Enumere las posibles fallas de software y hardware, así como las consecuencias para cada rendimiento y el impacto de las fallas.

(Incluyendo presión de software, memoria insuficiente, daños en el hardware, etc., puede encontrar fallas comunes según Baidu).

3.6 Otros requisitos especiales

Tales Como usuario, la unidad tiene requisitos de seguridad y confidencialidad, requisitos de facilidad de uso, requisitos especiales de mantenibilidad, complementabilidad, legibilidad, confiabilidad y convertibilidad de los entornos operativos, etc.

(Por ejemplo, seguridad y confidencialidad: reemplazo de claves, etc.; expansión esperada: compatibilidad de extensiones, etc.; reemplazo de SO: Slackware a SUSE, etc.

)

4 Requisitos ambientales de ejecución

4.1 Equipo

Enumere el equipo de hardware necesario para ejecutar el software. Describa el nuevo equipo y sus funciones especializadas, incluyendo:

a. ?Modelo de procesador y capacidad de memoria;

b. ?Capacidad de almacenamiento externo, en línea o fuera de línea, medios y su formato de almacenamiento, modelo y cantidad del dispositivo;

c. ?Modelo y cantidad de dispositivos de entrada y salida, en línea o fuera de línea;

d. ?Modelo y cantidad de equipos de comunicación de datos;

e. ?Teclas de función y otro hardware especial

(Solo indique la descripción)

4.2 Software de soporte

Enumere el software de soporte, incluido el sistema operativo que se utilizará. Programas compilados (o ensamblados), software de soporte de pruebas, etc.

(Sistema operativo y versión: xxxx

Entorno y versión de soporte: xxxx

Entorno y versión IDE alternativos: xxxx

Con este Componentes de software relacionados con el software: xxxx

Posible entorno de expansión posterior: xxxx

)

Interfaz 4.3

Indica que el software es el igual que otras interfaces de software, protocolos de comunicación de datos, etc.

(Por ejemplo:

a. Interfaz de llamada de usuario y programa principal (interfaz 1 en la figura).

Esta interfaz adopta la forma de API encapsulada y llamada de función, y proporciona a diferentes usuarios acceso a esta herramienta mecánica de segmentación de palabras a través de llamadas externas y llamadas internas, respectivamente. Por ejemplo, llame a archivos DLL en modo xxxx y llame a funciones en modo xxxx. Como se muestra en la Figura 2 a continuación.

Figura 2. Diagrama de llamada de la interfaz del software

Interfaz b.xx (interfaz 2 en la figura). Aquí está el proceso de llamada a la interfaz de xxx. xxxx

)

4.4 Control

Describa los métodos y señales de control para controlar el funcionamiento del software y explique las fuentes de estas señales de control.

(Por ejemplo:

El siguiente es un diagrama de los métodos operativos, señales de control y fuentes de estas señales de control de este módulo y los módulos de software involucrados en este módulo. flechas La señal de control del módulo correspondiente a la dirección señalada proviene del módulo en la otra dirección de la flecha. La situación específica es la siguiente:

Figura 3. Diagrama de flujo de control

La descripción específica de la Figura 3 se muestra en la siguiente tabla Pantalla:

Nombre del módulo

Modo de ejecución del método

Señal de control de señal

Dirección de control de avance

Módulo de programa principal

Ejecutar marco

Llamada de usuario o ejecución

Llamar módulo xx

p>

2. Llamar al método xx

3. Llamar al módulo de salida estándar

módulo xxx

xxx

llamada xxx.

Módulo xxx

)

Apéndice:? Estándar nacional para documentos de diseño de software (GB8567–88) Estándar nacional para documentos de diseño de software (GB8567–88) GB8567 ——88

Manual de operación (GB8567——88 ).doc Especificación de diseño de base de datos (GB8567-88).doc

Informe de análisis de prueba (GB8567-88).doc Especificación de requisitos de datos (GB856T-88).doc

Plan de prueba (GB8567-88).doc Figura 1.doc

Instrucciones de diseño esquemáticas (GB8567-88).doc Ejemplo de regulaciones de implementación de documentación ( GB8567-88).doc

Informe mensual de progreso del desarrollo (GB8567-88).doc Instrucciones detalladas de diseño (GB8567-88).doc

Informe del estudio de viabilidad (GB8567-88). doc Plan de desarrollo del proyecto (GB856T ——88).doc

Dossier de desarrollo del módulo (GB8567——88).doc Informe resumido del desarrollo del proyecto (GB8567——88).doc

Software especificación de requisitos (GB856T—— 88).doc Manual del usuario (GB8567——88).doc