← Portfolio

Tuntikirjaus.fi

Työajanseurannan SaaS-palvelu · 2024– · tuntikirjaus.fi (avautuu uuteen välilehteen)

Tuntikirjaus.fi – kuvakaappaus Tuntikirjaus.fi – kuvakaappaus

Työajan seuranta- ja laskutuspalvelu yrityksille ja freelancereille. Käyttäjät voivat kirjata tunteja projekteille puhelimella tai tietokoneella, seurata liukumasaldoaan ja laskuttaa asiakkaitaan viitenumerollisilla laskuilla. Palvelu on ollut tuotantokäytössä vuodesta 2024 lähtien. Se toimii suomeksi, ruotsiksi ja englanniksi.

Arkkitehtuuri. Tuntikirjaus on toteutettu AWS-pilvialustalle CDK-sovelluksena ja CloudFormation-pinoina. Se toimii Euroopassa eu-west-1-alueella.

Järjestelmän ydin muodostuu DynamoDB-tietokannasta, API Gateway -rajapinnoista ja Lambda-funktioista sekä CloudFrontin kautta jaettavasta Next.js-käyttöliittymästä. Käyttäjät rekisteröidään Cognito-käyttäjärekisteriin.

Tuntikirjaus.fi:n arkkitehtuurikaavio AWS:ssä Tuntikirjaus.fi:n arkkitehtuurikaavio AWS:ssä
Käyttöliittymä, rajapinnat, tietokanta ja tekoälyominaisuudet AWS:n eu-west-1-alueella.

Organisaatiot ja integraatiot. Tuntikirjauksen tietorakenne perustuu organisaatioihin. Kullekin käyttäjälle luodaan automaattisesti oma organisaatio, ja business-asiakkaat voivat kutsua muita käyttäjiä omaan organisaatioonsa. Tilaukset on toteutettu Stripe-integraatiolla.

Tekoäly. Tuntikirjaus sisältää Bedrock AgentCorella toteutetun tekoälyavustajan, joka kirjaa keskustelun perusteella työtunteja ja tarjoaa apua muissa asioissa. Avustajan työkalut on toteutettu AgentCore Gatewaylla ja Lambda-funktioilla.

Tuntikirjauksen avustaja kirjaa palaverin keskustelun perusteella Tuntikirjauksen avustaja kirjaa palaverin keskustelun perusteella
Avustaja kirjaa tunnit keskustelun perusteella ja näyttää tallentamansa kirjauksen.

MCP-palvelin. Tuntikirjaus sisältää MCP-palvelimen, jonka voi ottaa käyttöön Claudessa, ChatGPT:ssä tai muissa tekoälysovelluksissa. Kirjautuminen hoituu itse toteutetulla OAuth 2.1 -palvelimella, joka tukee PKCE:tä ja dynaamista rekisteröintiä. Tekoälyavustaja ja MCP-palvelin käyttävät yhteisiä työkalumäärittelyjä.

Tuntikirjaus.fi:n tekoälyavustajan ja MCP-palvelimen arkkitehtuurikaavio Tuntikirjaus.fi:n tekoälyavustajan ja MCP-palvelimen arkkitehtuurikaavio
Sovelluksen avustaja ja ulkoiset MCP-asiakkaat käyttävät yhteisiä työkaluja.

Tuotantokäytännöt. Tuntikirjaus koostuu noin kymmenestä CloudFormation-pinosta, jotka on julkaistu erikseen kehitys- ja tuotantoympäristöihin. Projekti sisältää myös kattavan joukon automaattisia yksikkö-, integraatio- ja rajapintatestejä. CI-järjestelmänä toimii GitHub Actions AWS OIDC -integraatiolla.

  • AWS Lambda
  • API Gateway
  • DynamoDB
  • Cognito
  • Bedrock AgentCore
  • MCP
  • OAuth 2.1
  • Stripe
  • Next.js
  • AWS CDK
  • GitHub Actions