Software Requirements Specification OefenHub
Doel
Dit document is de Software Requirements Specification van OefenHub.
De SRS vertaalt het actuele Functioneel Ontwerp, usecases en schermdocumentatie naar toetsbare requirements en acceptatiecriteria. Het document is bedoeld voor planning, testvoorbereiding, implementatie, acceptatie en baselinebeheer.
De SRS beschrijft niet opnieuw alle functionele uitleg uit het FO. De SRS legt vast:
- requirementconventies;
- requirement-ID's;
- prioriteiten;
- functionele requirements;
- niet-functionele requirements;
- acceptatiecriteria;
- traceability naar Functioneel Ontwerp, usecases, schermdocumentatie en waar relevant Technisch Ontwerp;
- open punten die nog SRS-detailuitwerking vragen.
Status
| Onderdeel | Waarde |
|---|---|
| Document | Software Requirements Specification OefenHub |
| Versie | SRS v1.0 |
| Status | Vastgestelde baseline |
| Bronbasis | Actueel Functioneel Ontwerp, actuele usecases en actuele schermdocumentatie |
| Wijzigingshistorie | Via Git commits en pull requests |
Baseline-inhoud
De SRS bevat naast de centrale functionele en niet-functionele requirements ook de traceerbaarheid naar schermdocumentatie, usecases, readmodeldefinities en meetbare niet-functionele grenzen. Deze onderdelen ondersteunen acceptatie, testvoorbereiding en baselinebeheer zonder een tweede normatieve requirementlaag te vormen.
De belangrijkste ondersteunende registers zijn:
- het schermrequirements-trace-register, waarin
REQ-SCH-*-ankers uit de schermdocumentatie gekoppeld zijn aan centrale SRS- en AC-items; - het usecase-requirements traceability-register, waarin usecase-afleidingen gekoppeld zijn aan centrale SRS- en AC-items;
- het readmodel- en tellerdefinitieregister, waarin per zichtbare teller, badge, samenvatting of readmodel staat wat functioneel meetelt;
- het NFR-meetwaardenregister, waarin meetbare grenzen voor bestaande niet-functionele requirements en acceptatiecriteria zijn gebundeld;
- het oefenmodule-eisenregister, waarin bijzondere module-eisen zijn geclassificeerd als moduleplatform-, modulecontract- of concrete module-eis.
Schermdocumentatie en usecases blijven context- en procesdocumentatie. Centrale requirementtekst, prioriteit, status en acceptatiecriteria staan uitsluitend in de SRS. Technische keuzes voor queryvorm, indexering, caching, materialisatie, infrastructuur, retrymechanismen, monitoring en tooling blijven onderdeel van het Technisch Ontwerp of beheerbeleid, tenzij de Software Requirements Specification expliciet een gebruikerszichtbare grens vastlegt.
Relatie tot Functioneel Ontwerp en Technisch Ontwerp
| Document | Rol |
|---|---|
| Functioneel Ontwerp | Beschrijft functionele samenhang, domeingrenzen, rollen, autorisatie en gebruikersgedrag. |
| Software Requirements Specification | Vertaalt Functioneel Ontwerp, usecases en schermdocumentatie naar toetsbare requirements, prioriteiten en acceptatiecriteria. |
| Technisch Ontwerp | Werkt technische realisatie, datamodellen, services, jobs, infrastructuur en integraties uit. |
Hoofdstukken
| Bestand | Doel |
|---|---|
| Bronnen en afbakening | Bronpositie, scope en interpretatieregels voor de SRS. |
| Requirementconventies | ID-conventies, prioriteiten, statussen en types. |
| Functionele requirements | Functionele eisen per domein. |
| Niet-functionele requirements | Security-, privacy-, performance-, audit-, beschikbaarheids- en toegankelijkheidseisen. |
| Acceptatiecriteria | Given/When/Then-criteria gekoppeld aan requirement-ID's. |
| Traceability | Koppeling tussen SRS-prefixen, FO-hoofdstukken en bronlagen. |
| Open punten | SRS-specifieke vervolgstappen. |
| Requirement-index | Requirementmatrix in markdownvorm. |
| Schermrequirements traceability | Koppeling van schermankers aan SRS/AC-items. |
| Usecase-requirements traceability | Koppeling van usecase-afleidingen aan SRS/AC-items. |
| NFR-meetwaarden | Meetbare grenzen voor bestaande niet-functionele requirements en acceptatiecriteria. |
| Oefenmodule-eisen | Classificatie van bijzondere module-eisen voor het moduleplatform, modulecontracten en concrete dynamische modules. |