Tuntikirjaus.fi
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.
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.
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ä.
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.