From d48c875877b7108fc6701fb2da657fa74b67a435 Mon Sep 17 00:00:00 2001 From: narsuman <marko.rintamaki@jamk.fi> Date: Tue, 6 Apr 2021 11:11:56 +0300 Subject: [PATCH] talteen --- .../requirement-specification.md | 81 +++++++++---------- 1 file changed, 37 insertions(+), 44 deletions(-) diff --git a/docs/20-Requirement-management/requirement-specification.md b/docs/20-Requirement-management/requirement-specification.md index 2876857..725b7e2 100644 --- a/docs/20-Requirement-management/requirement-specification.md +++ b/docs/20-Requirement-management/requirement-specification.md @@ -250,9 +250,9 @@ an independent file is created. | Käyttötapaus | Osa-alue | Ominaisuus? | |:-:|:-:|:-:| -| [Käyttötapaus 1 - Tilauksen muokkaus](templates/template-kayttotapaus.md) | Tilausten hallinta | [Tilaushallinta-paneeli](templates/template-ominaisuus.md) | -| [Käyttötapaus 2 - Tilauksen tarkistaminen](templates/template-kayttotapaus.md) | Tilausten hallinta | [Tilaushallinta-paneeli](templates/template-ominaisuus.md) | -| [Käyttötapaus 2 - Tilauksen siirto](templates/template-kayttotapaus.md) | Tilausten hallinta | [Tilaushallinta-paneeli](templates/template-ominaisuus.md) | +| [Käyttötapaus 1 - Tilauksen muokkaus](templates/template-kayttotapaus.md) | Tilausten hallinta | [Tilaushallinta-paneeli](templates/template-feature.md) | +| [Käyttötapaus 2 - Tilauksen tarkistaminen](templates/template-kayttotapaus.md) | Tilausten hallinta | [Tilaushallinta-paneeli](templates/template-feature.md) | +| [Käyttötapaus 2 - Tilauksen siirto](templates/template-kayttotapaus.md) | Tilausten hallinta | [Tilaushallinta-paneeli](templates/template-feature.md) | ## Tärkeimmät ominaisuudet/toiminnallisuudet @@ -378,8 +378,8 @@ node3 --> node2 : Ack | Id | Category | Description | |:-:|:-:|:-:|:-:| -| CONSTRAINT-REQ-S00000 | Constrain | Palvelun kirjautumisprosessin on noudatettava XYZ-käytäntöjä | [Kirjautuminen ft1](templates/template-ominaisuus.md) | -| CONSTRAINT-REQ-S00001 | Constrain | On huomioitava Standardi ZZZ osana palvelun tapahtuma login talletusta | [Log-palvelin](templates/template-ominaisuus.md)| +| CONSTRAINT-REQ-S00000 | Constrain | Palvelun kirjautumisprosessin on noudatettava XYZ-käytäntöjä | [Kirjautuminen ft1](templates/template-feature.md) | +| CONSTRAINT-REQ-S00001 | Constrain | On huomioitava Standardi ZZZ osana palvelun tapahtuma login talletusta | [Log-palvelin](templates/template-feature.md)| | CONSTRAINT-REQ-S00002 | Constrain ||| | CONSTRAINT-REQ-S00003 | Constrain ||| @@ -409,23 +409,14 @@ This is not to say that this is one feature of the product software but a genera **Priorisoi oleelliset ominaisuudet/toiminnot** -* P1 = Pakollinen -* P3 = Tarpeellinen -* P5 = Tehdään, kun tarve ilmenee +* P1 = Mandatory +* P3 = Needed +* P5 = Nice to have -| Ominaisuus | Prioriteetti | Ominaisuuteen liittyvät vaatimukset/käyttötapaukset | +| Feature | Priority | Links | |:-:|:-:|:-:| -| [Feature 1 - raportti-generaattori](templates/template-ominaisuus.md) | P1 | Esim [FUNCTIONAL-REQ-C0001]() | -| [Feature 2 - lasku-arkisto](templates/template-ominaisuus.md) | P1 | Esim [FUNCTIONAL-REQ-C0011]() | -| [Feature 3 - avatar-valinta](templates/template-ominaisuus.md) | P2 | Esim [FUNCTIONAL-REQ-C0023]() | -| [Feature 4 - oikeushallinta](templates/template-ominaisuus.md) | P3 | Esim [FUNCTIONAL-REQ-C0133]() | -| [Feature 5](templates/template-ominaisuus.md) | P4 | Esim [FUNCTIONAL-REQ-C0231]() | -| [Feature 6](templates/template-ominaisuus.md) | P5 | Esim [FUNCTIONAL-REQ-C0221]() | -| [Feature 7](templates/template-ominaisuus.md) | P5 | Esim [FUNCTIONAL-REQ-C0021]() | -| [Feature 8](templates/template-ominaisuus.md) | P5 | EEsim [FUNCTIONAL-REQ-C0301]() | -| [Feature 9](templates/template-ominaisuus.md) | P5 | Esim [FUNCTIONAL-REQ-C0401]() | -| [Feature 10](templates/template-ominaisuus.md) | P5 | Esim [FUNCTIONAL-REQ-C0401]() | - +|[Example Feature 1](templates/template-feature.md) | P1 | [FUNCTIONAL-REQ-C0001]()| +|[Example Feature 2](templates/template-feature.md) | P1 | [FUNCTIONAL-REQ-C0011]()| ### Functional Requirements of service/system @@ -437,8 +428,8 @@ You can present them in a table or refer to [one](templates / template-Requireme | RequirementID | Category | Description | Related Functionality | |:-:|:-:|:-:|:-:| -| FUNCTIONAL-REQ-C0001 | Functional Requirement | Käyttäjänä (Asiakas Profiilit 1-4) voin kirjautua käyttäen Facebook-tunnuksia | [Kirjautuminen ft1](templates/template-ominaisuus.md) | -| FUNCTIONAL-REQ-C0002 | Functional Requirement | Käyttöliittymän on toimittava myös ääniohjattuna, koska käyttäjillä saattaa olla näkövammoja | [Kirjautuminen ft1](templates/template-ominaisuus.md), [Tilaushallinta](templates/template-ominaisuus.md) | +| FUNCTIONAL-REQ-C0001 | Functional Requirement | Käyttäjänä (Asiakas Profiilit 1-4) voin kirjautua käyttäen Facebook-tunnuksia | [Kirjautuminen ft1](templates/template-feature.md) | +| FUNCTIONAL-REQ-C0002 | Functional Requirement | Käyttöliittymän on toimittava myös ääniohjattuna, koska käyttäjillä saattaa olla näkövammoja | [Kirjautuminen ft1](templates/template-feature.md), [Tilaushallinta](templates/template-feature.md) | | FUNCTIONAL-REQ-C0003 | Functional Requirement ||| | FUNCTIONAL-REQ-C0004 | Functional Requirement ||| | FUNCTIONAL-REQ-C0005 | Functional Requirement ||| @@ -567,28 +558,29 @@ e01 |o..o{ e03 ### Palvelun/Ohjelmiston alustavat hyväksyntätestit ->Hyväksyntätesteissä keskitytään yleisesti asiakkaan/loppukäyttäjän näkökulmaan. Tavoitteena on kelpuuttaa, eli validoida , onko tuote asiakkaan toiveiden mukainen ja täyttääkö se asetetut vaatimukset. -Hyväksyntätesteillä voidaan selvittää onko tuote myös riittävän suorituskykyinen, käytettävä tai tietoturvallinen asiakkaiden käyttötarkoitukseen. +>Acceptance tests generally focus on the customer / end user perspective. The aim is to validate, ie to validate whether the product meets the customer's wishes and whether it meets the set requirements. +Acceptance tests can be used to determine whether a product is also sufficiently high-performance, usable, or secure for customer use. + [](http://www.youtube.com/watch?v=WfMrCdAr-GM "") ->Kiinnitetään alustavat hyväksyntätestit vaatimuksiin taulukon muodossa. +>Preliminary approval tests are attached to the requirements in tabular form. | Lähde | Testitapaus Id | Description | Category | |:-:|:-:|:-:|:-:| -| [Feature 1](templates/template-ominaisuus.md), [FUNCTIONAL-REQ-0001]() | [Testitapaus 1](templates/template-hyvaksyntatesti.md) | esim. Tarkista kirjautuminen palveluun uutena käyttäjänä | Hyväksyntätesti | -| [Feature 2](templates/template-ominaisuus.md), [FUNCTIONAL-REQ-0201](), [USE-CASE-017](templates/template-hyvaksyntatesti.md) | [Testitapaus 2](templates/template-testitapaus.md) | esim. Tarkista kenkilökohtaisten tietojen poisto | Hyväksyntätesti | -| [Feature 3](templates/template-ominaisuus.md), | [Testitapaus 101](templates/template-hyvaksyntatesti.md) | esim. Takista Kirjautuminen toimivalla salasanalla | Hyväksyntätesti | +| [Example Feature 1](templates/template-feature.md), [FUNCTIONAL-REQ-0001]() | [Example Test Case 1](templates/template-acceptence-test.md) | esim. Tarkista kirjautuminen palveluun uutena käyttäjänä | Hyväksyntätesti | +| [Example Feature 2](templates/template-feature.md), [FUNCTIONAL-REQ-0201](), [USE-CASE-017](templates/template-acceptence-test.md) | [Testitapaus 2](templates/template-testitapaus.md) | esim. Tarkista kenkilökohtaisten tietojen poisto | Hyväksyntätesti | +| [Feature 3](templates/template-feature.md), | [Testitapaus 101](templates/template-acceptence-test.md) | esim. Takista Kirjautuminen toimivalla salasanalla | Hyväksyntätesti | -## Julkaisusuunnitelma +## Release Plan -> Julkaisusuunnitelman visualisoidulla muodolla on helpompi esittää ominaisuuksien julkaisut kehityksen aikanan. -Alla oleva kuva on luotu hyödyntäen PlantUML-työkalua. Sen avulla on luoto ns. Gantt-kaavio ominaisuuksien julkaisuajankohdista. +> The visualized format of the release plan makes it easier to present feature releases during development. +The image below was created using the PlantUML tool. It allows credit to the so-called. Gantt chart of feature release times. -> Oletamme, että tuotteessa on muutamia ominaisuuksia, joiden järjestys on mietitty ennakkoon.. +> We assume that the product has a few features, the order of which has been thought out in advance. ```plantuml Project starts the 2019-5-15 @@ -604,26 +596,27 @@ Project starts the 2019-5-15 [](http://www.youtube.com/watch?v=Z1cSK_IMqMs "") ->Tuotteen/ohjelmiston eri ominaisuuksista kehitetään usein eri versioita ja tämä johtaa usein erilaisiin tuotekokonaisuuksiin. Puhutaan ns. tuotekonfiguraatiosta, jonka avulla kiinnitetään eri -ominaisuusversiot yhteen ohjelmiston julkaisu versionn. +>Different versions of different product / software features are often developed and this often leads to different product packages. Let's talk about the so-called. product configuration to attach different +feature versions into one software release version. + +> The table below shows the functionalities selected for "EarlyAdopter - Version 1.0" -> Alla olevassa taulukossa on esitelty julkaisuun "EarlyAdopter - Versio 1.0" valitut toiminnallisuudet | Ominaisuus/toiminnallisuus | Versio | Milloin testattavissa | Julkaisu | |:-:|:-:|:-:|:-:| -| [Feature 1](templates/template-ominaisuus.md) | 1.0 | 15.6.2019 | V1.0 | -| [Feature 2](templates/template-ominaisuus.md) | 1.0 | 1.7.2019 | V1.0 | -| [Feature 3](templates/template-ominaisuus.md) | 1.1 | 15.7.2019 | V1.0 | -| [Feature 4](templates/template-ominaisuus.md) | 1.1 | 20.7.2019 | V1.0 | -| [Feature 5](templates/template-ominaisuus.md) | 2.3 | 23.7.2019 | V1.0 | +| [Feature 1](templates/template-feature.md) | 1.0 | 15.6.2019 | V1.0 | +| [Feature 2](templates/template-feature.md) | 1.0 | 1.7.2019 | V1.0 | +| [Feature 3](templates/template-feature.md) | 1.1 | 15.7.2019 | V1.0 | +| [Feature 4](templates/template-feature.md) | 1.1 | 20.7.2019 | V1.0 | +| [Feature 5](templates/template-feature.md) | 2.3 | 23.7.2019 | V1.0 | -## Standardit ja lähteet +## Standards and references -> Requirementmäärittelyn osana on oleellista tuoda esiin tärkeät lähteet, joista on hyötyä tai merkitystä kokonaisuuden kannalta. Standardit ja ennalta jaetut ohjeistukset ovat hyödyllisiä lähteitä ja tarvittaessa -selkeyttävät Requirementten merkitystä. +> As part of the definition of requirements, it is essential to identify important sources that are useful or relevant to the whole. Standards and pre-distributed guidelines are useful sources and as needed +clarify the meaning of the Requirements. -| ID | Linkki | | +| DocumentID | Linkki | | |:-:|:-:|:-:| | JHS 165 ICT | http://www.jhs-suositukset.fi/c/document_library/get_file?uuid=b8118ad7-8ee4-459a-a12b-f56655e4ab9d&groupId=14 | Requirementmäärittely | | SO 9241-11 | https://fi.wikipedia.org/wiki/K%C3%A4ytett%C3%A4vyys | Käytettävyys | -- GitLab