diff --git a/docs/images/05_nivel_2.png b/docs/images/05_nivel_2.png new file mode 100644 index 0000000..115bbab Binary files /dev/null and b/docs/images/05_nivel_2.png differ diff --git a/docs/images/05_sistema-general-caja-blanca.png b/docs/images/05_sistema-general-caja-blanca.png new file mode 100644 index 0000000..594f23c Binary files /dev/null and b/docs/images/05_sistema-general-caja-blanca.png differ diff --git a/docs/src/05_building_block_view.adoc b/docs/src/05_building_block_view.adoc index df5c29c..ef6e201 100644 --- a/docs/src/05_building_block_view.adoc +++ b/docs/src/05_building_block_view.adoc @@ -3,7 +3,7 @@ ifndef::imagesdir[:imagesdir: ../images] [[section-building-block-view]] -== Building Block View +== Vista de Bloques [role="arc42help"] **** @@ -40,7 +40,7 @@ See https://docs.arc42.org/section-5/[Building Block View] in the arc42 document **** -=== Whitebox Overall System +=== Nivel 1: Sistema General de Caja Blanca [role="arc42help"] **** @@ -63,150 +63,53 @@ In the best case you will get away with examples or simple signatures. **** -_****_ +image::05_sistema-general-caja-blanca.png["Sistema General de Caja Blanca"] -Motivation:: -__ +Motivación:: -Contained Building Blocks:: -__ +La motivación de este diagrama es ofrecer una representación clara y sencilla de cómo el sistema interactúa con los usuarios y los servicios externos. -Important Interfaces:: -__ -[role="arc42help"] -**** -Insert your explanations of black boxes from level 1: - -If you use tabular form you will only describe your black boxes with name and -responsibility according to the following schema: - -[cols="1,2" options="header"] -|=== -| **Name** | **Responsibility** -| __ | __ -| __ | __ +Bloques de construcción contenidos:: +[cols="e,2e" options="header"] |=== +|Nombre |Responsabilidad +|*Usuario* +|_Usuario que interactua con la aplicación._ +|*Administrador* +|_Persona(s) que tienen acceso completo a la aplicación y puede administrarla._ -If you use a list of black box descriptions then you fill in a separate black box template for every important building block . -Its headline is the name of the black box. -**** - - -==== - -[role="arc42help"] -**** -Here you describe -according the the following black box template: - -* Purpose/Responsibility -* Interface(s), when they are not extracted as separate paragraphs. This interfaces may include qualities and performance characteristics. -* (Optional) Quality-/Performance characteristics of the black box, e.g.availability, run time behavior, .... -* (Optional) directory/file location -* (Optional) Fulfilled requirements (if you need traceability to requirements). -* (Optional) Open issues/problems/risks - -**** - -__ - -__ - -_<(Optional) Quality/Performance Characteristics>_ - -_<(Optional) Directory/File Location>_ - -_<(Optional) Fulfilled Requirements>_ - -_<(optional) Open Issues/Problems/Risks>_ - - - - -==== - -__ - -==== - -__ - - -==== - -... - -==== - - - -=== Level 2 +|*WIQ* +|_La propia aplicación._ -[role="arc42help"] -**** -Here you can specify the inner structure of (some) building blocks from level 1 as white boxes. - -You have to decide which building blocks of your system are important enough to justify such a detailed description. -Please prefer relevance over completeness. Specify important, surprising, risky, complex or volatile building blocks. -Leave out normal, simple, boring or standardized parts of your system -**** - -==== White Box __ - -[role="arc42help"] -**** -...describes the internal structure of _building block 1_. -**** - -__ - -==== White Box __ - - -__ - -... - -==== White Box __ - - -__ - - - -=== Level 3 - -[role="arc42help"] -**** -Here you can specify the inner structure of (some) building blocks from level 2 as white boxes. - -When you need more detailed levels of your architecture please copy this -part of arc42 for additional levels. -**** - - -==== White Box <_building block x.1_> - -[role="arc42help"] -**** -Specifies the internal structure of _building block x.1_. -**** +|*Wikidata* +|_Servicio externo desde donde obtenemos los datos para generar las preguntas._ +|*Firebase* +|_Plataforma para el manejo de sesiones de los usuarios, asi como informacion sobre sus estadisticas._ +|=== -__ +=== Nivel 2: WIQ +image::05_nivel_2.png["Nivel 2 de la aplicación: WIQ"] -==== White Box <_building block x.2_> +Bloques de construcción contenidos:: +[cols="e,2e" options="header"] +|=== +|Nombre |Responsabilidad -__ +|*Webapp* +|_La interfaz con la que interactua el usuario._ +|*REST* +|_Manejo de datos de Wikidata._ +|*Users* +|_El manejo de las cuentas de los usuarios._ +|=== -==== White Box <_building block y.1_> -__