# Arkkitehtuuri- ja alustapäätökset Canonical page: https://apiopscycles.com/fi/stations/api-platform-architecture Language: fi Entity ID: api-platform-architecture ## Description Käytä vaatimuksia ja rajoitteita oikean arkkitehtuurimallin ja tarvittavien alustakyvykkyyksien valintaan. ## Why it matters Arkkitehtuurivalintojen tulee perustua näyttöön liiketoimintavaikutuksesta, sijainneista, luottamusrajoista, kapasiteetista, viiveestä, datan omistajuudesta, yhdenmukaisuudesta, operoitavuudesta, tietoturvasta, tietosuojasta, hallintamallista ja kustannuksista. ## Apply in work Vertaa mahdollisia arkkitehtuurityylejä koottuihin vaatimuksiin ja dokumentoi valittu malli sekä sen perustelut. ## Outcomes - Perusteltu arkkitehtuurivalinta - Dokumentoidut riskit sekä sijainti-, kapasiteetti-, tietoturva-, tietosuoja- ja operoitavuusrajoitteet - Selkeä perustelu API-, tapahtuma-, tiedosto-, virta-, datatuote-, suora integraatio- tai hybriditoteutukselle ## Steps 1. Käytä Business Impact Canvas -pohjaa saatavuus-, tietoturva- ja datariskien tunnistamiseen, koska ne vaikuttavat arkkitehtuurivaihtoehtoihin. 2. Käytä Locations Canvas -pohjaa geopoliittisten, sääntelyyn liittyvien, verkko-, datan sijainti- ja luottamusrajarajoitteiden kuvaamiseen. 3. Käytä Capacity Canvas -pohjaa nykyisten ja tulevien volyymien, huippujen, viiveen, välimuistin, nopeusrajoitusten ja skaalautumisodotusten kuvaamiseen. 4. Käytä mittari- ja analytiikkaohjeistusta määrittelemään, miten valittua kyvykkyyttä seurataan ja parannetaan. ## Questions - Käytä Business Impact Canvas -pohjaa saatavuus-, tietoturva- ja datariskien tunnistamiseen, koska ne vaikuttavat arkkitehtuurivaihtoehtoihin. - Käytä Locations Canvas -pohjaa geopoliittisten, sääntelyyn liittyvien, verkko-, datan sijainti- ja luottamusrajarajoitteiden kuvaamiseen. - Käytä Capacity Canvas -pohjaa nykyisten ja tulevien volyymien, huippujen, viiveen, välimuistin, nopeusrajoitusten ja skaalautumisodotusten kuvaamiseen. - Käytä mittari- ja analytiikkaohjeistusta määrittelemään, miten valittua kyvykkyyttä seurataan ja parannetaan. - Vertaa mahdollisia arkkitehtuurityylejä koottuihin vaatimuksiin ja dokumentoi valittu malli sekä sen perustelut. - Arkkitehtuurivalintojen tulee perustua näyttöön liiketoimintavaikutuksesta, sijainneista, luottamusrajoista, kapasiteetista, viiveestä, datan omistajuudesta, yhdenmukaisuudesta, operoitavuudesta, tietoturvasta, tietosuojasta, hallintamallista ja kustannuksista. ## Evidence - architecture-decision - documentation - platform-config - metrics ## Completion criteria - Kyvykkyys vastaa selkeään liiketoimintatarpeeseen ja on uudelleenkäytettävissä tarkoitetuille hyödyntäjille. — The API meets a clear business need and is reusable for multiple API consumers. (ID: api-reusability) - Valittu rajapinta tarjoaa hyödyntäjille sopivan abstraktion. — The API is intended to shield consumers from backend complexity and inconsistencies. (ID: hide-backend-discrepancies) - Kyvykkyyden arvolupaus on validoitu liiketoiminnan ja hyödyntäjien sidosryhmien kanssa. — The API value proposition has been reviewed and validated with the relevant business and consumer stakeholders. (ID: value-prop-validated) - Hyödyntäjäsegmentit on tunnistettu. — API consumer segments (internal and external) are identified. (ID: consumer-segments-identified) - Ylätason toteutuksen etenemissuunnitelma on määritelty. — High-level roadmaps for API development are established. (ID: api-roadmap-defined) ## Role participation and responsibilities - [Alusta-arkkitehti](https://apiopscycles.com/fi/roles/platform-architect.md) (lead): Ohjaa alustan, integraation, skaalautuvuuden ja arkkitehtuurin päätöksiä, jotka määrittelevät, miten kyvykkyys tai API rakennetaan ja operoidaan.; suggested-answer-owner: [Kyvykkyysarkkitehtuurin päätöskanvas](https://apiopscycles.com/fi/resources/capability-architecture-decision-canvas.md) - [Alustan omistaja](https://apiopscycles.com/fi/roles/platform-owner.md) (core): Vastaa alustan kyvykkyyksistä, tiekartasta, operatiivisesta mallista ja palveluodotuksista. - [API-arkkitehti](https://apiopscycles.com/fi/roles/api-architect.md) (core): Vastaa API-arkkitehtuurista, suunnitteluperiaatteista ja rajapintasopimusten laadusta.; suggested-answer-owner: [Sijaintikanvas](https://apiopscycles.com/fi/resources/location-canvas.md); suggested-answer-owner: [Kapasiteettikanvas](https://apiopscycles.com/fi/resources/capacity-canvas.md) - [API-tuoteomistaja](https://apiopscycles.com/fi/roles/api-product-owner.md) (core): Ohjaa API-mahdollisuutta, priorisointia ja tuotetasolla tehtyjä päätöksiä elinkaaren aikana.; suggested-answer-owner: [Liiketoimintavaikutuskanvas](https://apiopscycles.com/fi/resources/business-impact-canvas.md) - [Automaatiokehittäjä](https://apiopscycles.com/fi/roles/automation-engineer.md) (core): Toteuttaa, testaa, integroi ja ylläpitää automaatioratkaisuja ja niitä tukevia työnkulkuja. - [Automaation omistaja](https://apiopscycles.com/fi/roles/automation-owner.md) (core): Vastaa automaation tavoitteista, liiketoiminta-arvosta, priorisoinnista, kontrolleista ja elinkaaren tuloksista. - [Integraatioarkkitehti](https://apiopscycles.com/fi/roles/integration-architect.md) (core): Suunnittelee integraatiotavat ja toteutustavat, joilla kyvykkyys tai API yhdistetään muihin järjestelmiin. - [Kyvykkyyden omistaja](https://apiopscycles.com/fi/roles/capability-owner.md) (core): Vastaa kyvykkyyden visiosta, arvosta, priorisoinnista, elinkaaresta ja uudelleenkäytöstä eri hyödyntäjille. - [Liiketoiminta-asiantuntija](https://apiopscycles.com/fi/roles/domain-specialist.md) (core): Tuo syvällistä tietoa liiketoiminta-alueesta, käsitteistä, säännöistä ja rajoituksista, joita kyvykkyyden tai rajapinnan täytyy heijastaa. - [Tuki- ja operaatioiden omistaja](https://apiopscycles.com/fi/roles/operations-specialist.md) (core): Edustaa tuotannon tukea, häiriönhallintaa, havainnoitavuutta ja operatiivista valmiutta kyvykkyydelle, APIlle tai automaatiolle. - [Turvallisuusasiantuntija](https://apiopscycles.com/fi/roles/security-specialist.md) (core): Varmistaa, että turvallisuusriskit, kontrollit ja luottamusrajat käsitellään koko elinkaaren aikana. - [Vaatimustenmukaisuus- ja lakiasiantuntija](https://apiopscycles.com/fi/roles/compliance-specialist.md) (core): Selventää juridiset, tietosuojaan liittyvät, sääntelyyn liittyvät ja sopimukselliset vaatimukset, jotka vaikuttavat kyvykkyyteen, APIin, rajapintaan tai automaatioon. - [API-hyödyntäjien edustaja](https://apiopscycles.com/fi/roles/api-consumer-specialist.md) (consulted): Edustaa kehittäjien, integraattoreiden tai muiden API-hyödyntäjien tarpeita, jotka käyttävät APIa suoraan. - [Liiketoiminnan omistaja](https://apiopscycles.com/fi/roles/business-owner.md) (consulted): Edustaa liiketoimintatavoitteita, rahoitusta ja odotettuja tuloksia kyvykkyys-, API- tai automaatiohankkeessa. - [Prosessin omistaja](https://apiopscycles.com/fi/roles/process-owner.md) (consulted): Vastaa automatisoitavasta liiketoimintaprosessista, mukaan lukien tavoitteet, säännöt, tulokset ja kehittämisen prioriteetit. - [Toimituskehittäjä](https://apiopscycles.com/fi/roles/api-engineer.md) (consulted): Vastaa toteutuksesta, automaatiosta, testauksesta ja julkaisun kulusta, joita kyvykkyyden, APIn tai automaation luotettava toimittaminen edellyttää. ## Cycle-specific guidance - [Kyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/capability-productization-cycle/stations/api-platform-architecture.md) - [API-tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/api-productization-cycle/stations/api-platform-architecture.md) - [Integraatiokyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/integration-productization-cycle/stations/api-platform-architecture.md) - [Automaatiosykli](https://apiopscycles.com/fi/cycles/automation-cycle/stations/api-platform-architecture.md)