diff --git a/docs/src/01_introduction_and_goals.adoc b/docs/src/01_introduction_and_goals.adoc index 8da1133..42cd2cf 100644 --- a/docs/src/01_introduction_and_goals.adoc +++ b/docs/src/01_introduction_and_goals.adoc @@ -1,95 +1,95 @@ -ifndef::imagesdir[:imagesdir: ../images] - -[[section-introduction-and-goals]] -== Introduction and Goals - -[role="arc42help"] -**** -Describes the relevant requirements and the driving forces that software architects and development team must consider. -These include - -* underlying business goals, -* essential features, -* essential functional requirements, -* quality goals for the architecture and -* relevant stakeholders and their expectations -**** - -=== Requirements Overview - -[role="arc42help"] -**** -.Contents -Short description of the functional requirements, driving forces, extract (or abstract) -of requirements. Link to (hopefully existing) requirements documents -(with version number and information where to find it). - -.Motivation -From the point of view of the end users a system is created or modified to -improve support of a business activity and/or improve the quality. - -.Form -Short textual description, probably in tabular use-case format. -If requirements documents exist this overview should refer to these documents. - -Keep these excerpts as short as possible. Balance readability of this document with potential redundancy w.r.t to requirements documents. - - -.Further Information - -See https://docs.arc42.org/section-1/[Introduction and Goals] in the arc42 documentation. - -**** - -=== Quality Goals - -[role="arc42help"] -**** -.Contents -The top three (max five) quality goals for the architecture whose fulfillment is of highest importance to the major stakeholders. -We really mean quality goals for the architecture. Don't confuse them with project goals. -They are not necessarily identical. - -Consider this overview of potential topics (based upon the ISO 25010 standard): - -image::01_2_iso-25010-topics-EN.drawio.png["Categories of Quality Requirements"] - -.Motivation -You should know the quality goals of your most important stakeholders, since they will influence fundamental architectural decisions. -Make sure to be very concrete about these qualities, avoid buzzwords. -If you as an architect do not know how the quality of your work will be judged... - -.Form -A table with quality goals and concrete scenarios, ordered by priorities -**** - -=== Stakeholders - -[role="arc42help"] -**** -.Contents -Explicit overview of stakeholders of the system, i.e. all person, roles or organizations that - -* should know the architecture -* have to be convinced of the architecture -* have to work with the architecture or with code -* need the documentation of the architecture for their work -* have to come up with decisions about the system or its development - -.Motivation -You should know all parties involved in development of the system or affected by the system. -Otherwise, you may get nasty surprises later in the development process. -These stakeholders determine the extent and the level of detail of your work and its results. - -.Form -Table with role names, person names, and their expectations with respect to the architecture and its documentation. -**** - -[options="header",cols="1,2,2"] -|=== -|Role/Name|Contact|Expectations -| *Students* | Andrés Cadenas Blanco, Christian Fernandez Noriega , Adrián González Guadalupe and Luis Salvador Ferrero | Are the ones in charge of web development. They will work together to make the application. -| *Teachers* | Pablo González | In charge of supervising the student's teamwork, ensuring the work accomplishes the goals in the best way possible and helping in the development and solving doubts. -| *Bussineses* | RTve has hired software development company HappySw | Emphasis the SOLID part of the web and have a high understanding of this area -| *Users | Anyone that wants to use the web | They should be able to understand how to use and move around the web with ease -|=== +ifndef::imagesdir[:imagesdir: ../images] + +[[section-introduction-and-goals]] +== Introduction and Goals + +[role="arc42help"] +**** +Describes the relevant requirements and the driving forces that software architects and development team must consider. +These include + +* underlying business goals, +* essential features, +* essential functional requirements, +* quality goals for the architecture and +* relevant stakeholders and their expectations +**** + +=== Requirements Overview + +[role="arc42help"] +**** +.Contents +Short description of the functional requirements, driving forces, extract (or abstract) +of requirements. Link to (hopefully existing) requirements documents +(with version number and information where to find it). + +.Motivation +From the point of view of the end users a system is created or modified to +improve support of a business activity and/or improve the quality. + +.Form +Short textual description, probably in tabular use-case format. +If requirements documents exist this overview should refer to these documents. + +Keep these excerpts as short as possible. Balance readability of this document with potential redundancy w.r.t to requirements documents. + + +.Further Information + +See https://docs.arc42.org/section-1/[Introduction and Goals] in the arc42 documentation. + +**** + +=== Quality Goals + +[role="arc42help"] +**** +.Contents +The top three (max five) quality goals for the architecture whose fulfillment is of highest importance to the major stakeholders. +We really mean quality goals for the architecture. Don't confuse them with project goals. +They are not necessarily identical. + +Consider this overview of potential topics (based upon the ISO 25010 standard): + +image::01_2_iso-25010-topics-EN.drawio.png["Categories of Quality Requirements"] + +.Motivation +You should know the quality goals of your most important stakeholders, since they will influence fundamental architectural decisions. +Make sure to be very concrete about these qualities, avoid buzzwords. +If you as an architect do not know how the quality of your work will be judged... + +.Form +A table with quality goals and concrete scenarios, ordered by priorities +**** + +=== Stakeholders + +[role="arc42help"] +**** +.Contents +Explicit overview of stakeholders of the system, i.e. all person, roles or organizations that + +* should know the architecture +* have to be convinced of the architecture +* have to work with the architecture or with code +* need the documentation of the architecture for their work +* have to come up with decisions about the system or its development + +.Motivation +You should know all parties involved in development of the system or affected by the system. +Otherwise, you may get nasty surprises later in the development process. +These stakeholders determine the extent and the level of detail of your work and its results. + +.Form +Table with role names, person names, and their expectations with respect to the architecture and its documentation. +**** + +[options="header",cols="1,2,2"] +|=== +|Role/Name|Contact|Expectations +| *Students* | Andrés Cadenas Blanco, Christian Fernandez Noriega , Adrián González Guadalupe and Luis Salvador Ferrero | Are the ones in charge of web development. They will work together to make the application. +| *Teachers* | Pablo González | In charge of supervising the student's teamwork, ensuring the work accomplishes the goals in the best way possible and helping in the development and solving doubts. +| *Bussineses* | RTve has hired software development company HappySw | Emphasis the SOLID part of the web and have a high understanding of this area +| *Users | Anyone that wants to use the web | They should be able to understand how to use and move around the web with ease +|=== diff --git a/docs/src/02_architecture_constraints.adoc b/docs/src/02_architecture_constraints.adoc index 77732ae..2908f75 100644 --- a/docs/src/02_architecture_constraints.adoc +++ b/docs/src/02_architecture_constraints.adoc @@ -1,70 +1,70 @@ -ifndef::imagesdir[:imagesdir: ../images] - -[[section-architecture-constraints]] -== Architecture Constraints - - -[role="arc42help"] -**** -.Contents -Any requirement that constraints software architects in their freedom of design and implementation decisions or decision about the development process. These constraints sometimes go beyond individual systems and are valid for whole organizations and companies. - -.Motivation -Architects should know exactly where they are free in their design decisions and where they must adhere to constraints. -Constraints must always be dealt with; they may be negotiable, though. - -.Form -Simple tables of constraints with explanations. -If needed you can subdivide them into -technical constraints, organizational and political constraints and -conventions (e.g. programming or versioning guidelines, documentation or naming conventions) - - -.Further Information - -See https://docs.arc42.org/section-2/[Architecture Constraints] in the arc42 documentation. - -**** - -Architects need a clear understanding of the areas where they have creative freedom in their design choices and where they are bound by constraints. These constraints must be addressed comprehensively, as they are non-negotiable factors within the project. However, it's important to recognize that while constraints are rigid, there may be room for negotiation and adaptation within them. - -|=== -| Constraints | Explanation - -| *Privacy (by SOLID)* -| The web application must be able to save in a secure and persistence way. - -| *GitHub* -| It will be used to coordinate the projects work, tracks changes and manage workflow. - -| *Time* -| The web application will be developed along this course, that means our time is limited and we require an efficient time management. - - -| *Documentation* -| In order to keep it clean, efficient and simple it will follow Arc42 method. - - -| *Time* -| Since the project will be done in this semester our time is limited, and we need to stick to the deadlines and manage our time in an efficient way. - - -| *Code* -| The code requires a small description of what it does. In addition, we must build it in a clean way and that is easy to expand and can adapt to changes in an easy way. - - -| *Test* -| The test has to be correctly tested in order to accomplish the desired behavior. - - -| Node.js -| Open-source, cross-platform JavaScript runtime environment and library for running web applications outside the client’s browser. - -| *Ruby* -| Dynamic, open source programming language with a focus on simplicity and productivity. - -| *JavaScript* -| Programming language that allows you to implement complex features on web page. -|=== - - +ifndef::imagesdir[:imagesdir: ../images] + +[[section-architecture-constraints]] +== Architecture Constraints + + +[role="arc42help"] +**** +.Contents +Any requirement that constraints software architects in their freedom of design and implementation decisions or decision about the development process. These constraints sometimes go beyond individual systems and are valid for whole organizations and companies. + +.Motivation +Architects should know exactly where they are free in their design decisions and where they must adhere to constraints. +Constraints must always be dealt with; they may be negotiable, though. + +.Form +Simple tables of constraints with explanations. +If needed you can subdivide them into +technical constraints, organizational and political constraints and +conventions (e.g. programming or versioning guidelines, documentation or naming conventions) + + +.Further Information + +See https://docs.arc42.org/section-2/[Architecture Constraints] in the arc42 documentation. + +**** + +Architects need a clear understanding of the areas where they have creative freedom in their design choices and where they are bound by constraints. These constraints must be addressed comprehensively, as they are non-negotiable factors within the project. However, it's important to recognize that while constraints are rigid, there may be room for negotiation and adaptation within them. + +|=== +| Constraints | Explanation + +| *Privacy (by SOLID)* +| The web application must be able to save in a secure and persistence way. + +| *GitHub* +| It will be used to coordinate the projects work, tracks changes and manage workflow. + +| *Time* +| The web application will be developed along this course, that means our time is limited and we require an efficient time management. + + +| *Documentation* +| In order to keep it clean, efficient and simple it will follow Arc42 method. + + +| *Time* +| Since the project will be done in this semester our time is limited, and we need to stick to the deadlines and manage our time in an efficient way. + + +| *Code* +| The code requires a small description of what it does. In addition, we must build it in a clean way and that is easy to expand and can adapt to changes in an easy way. + + +| *Test* +| The test has to be correctly tested in order to accomplish the desired behavior. + + +| Node.js +| Open-source, cross-platform JavaScript runtime environment and library for running web applications outside the client’s browser. + +| *Ruby* +| Dynamic, open source programming language with a focus on simplicity and productivity. + +| *JavaScript* +| Programming language that allows you to implement complex features on web page. +|=== + + diff --git a/package-lock.json b/package-lock.json index c0143ea..d5acb4a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ -{ - "name": "wiq_en1a", - "lockfileVersion": 3, - "requires": true, - "packages": {} -} +{ + "name": "wiq_en1a", + "lockfileVersion": 3, + "requires": true, + "packages": {} +}