{"id":21178364,"url":"https://github.com/helsingborg-stad/helsingborg-io-sls-api","last_synced_at":"2025-07-09T22:31:38.382Z","repository":{"id":36958432,"uuid":"238229915","full_name":"helsingborg-stad/helsingborg-io-sls-api","owner":"helsingborg-stad","description":"Helsingborgs Stad API Platform using AWS Lambdas","archived":false,"fork":false,"pushed_at":"2024-01-10T11:43:02.000Z","size":5260,"stargazers_count":4,"open_issues_count":4,"forks_count":3,"subscribers_count":11,"default_branch":"dev","last_synced_at":"2024-04-08T00:16:59.878Z","etag":null,"topics":["aws-lambda","hacktoberfest","hacktoberfest-accepted","mitt-helsingborg","serverless","serverless-framework"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/helsingborg-stad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-02-04T14:46:55.000Z","updated_at":"2024-03-15T21:02:56.000Z","dependencies_parsed_at":"2023-02-19T10:01:19.684Z","dependency_job_id":"2576ee67-f776-4ae7-ba2d-0c2325970db6","html_url":"https://github.com/helsingborg-stad/helsingborg-io-sls-api","commit_stats":null,"previous_names":[],"tags_count":57,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsingborg-stad%2Fhelsingborg-io-sls-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsingborg-stad%2Fhelsingborg-io-sls-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsingborg-stad%2Fhelsingborg-io-sls-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsingborg-stad%2Fhelsingborg-io-sls-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helsingborg-stad","download_url":"https://codeload.github.com/helsingborg-stad/helsingborg-io-sls-api/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225598534,"owners_count":17494357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws-lambda","hacktoberfest","hacktoberfest-accepted","mitt-helsingborg","serverless","serverless-framework"],"created_at":"2024-11-20T17:20:59.288Z","updated_at":"2024-11-20T17:21:00.783Z","avatar_url":"https://github.com/helsingborg-stad.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- SHIELDS --\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![License][license-shield]][license-url]\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/helsingborg-stad/helsingborg-io-sls-api\"\u003e\n    \u003cimg src=\"images/hbg-github-logo-combo.png\" alt=\"Logo\" width=\"300\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ch3\u003eHelsingborg IO SLS\u003c/h3\u003e\n\u003cp\u003e\n  Services that run on Helsingborgs stads API platform \u003ca href=\"https://helsingborg.io/\"\u003ehelsingborg.io\u003c/a\u003e\n  \u003cbr /\u003e\n  \u003ca href=\"https://github.com/helsingborg-stad/helsingborg-io-sls-api/issues\"\u003eReport Bug\u003c/a\u003e\n  ·\n  \u003ca href=\"https://github.com/helsingborg-stad/helsingborg-io-sls-api/issues\"\u003eRequest Feature\u003c/a\u003e\n\u003c/p\u003e\n\n\n## Table of Contents\n- [Table of Contents](#table-of-contents)\n- [About Helsingborg IO SLS](#about-helsingborg-io-sls)\n  - [An example](#an-example)\n  - [Built With](#built-with)\n- [Getting Started](#getting-started)\n  - [Do first](#do-first)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Services](#services)\n- [Roadmap](#roadmap)\n- [Contributing](#contributing)\n- [License](#license)\n\n\n## About Helsingborg IO SLS\nA service is what you might call a Serverless project. It has a single serverless.yml file driving it.\n\n\n### An example\n\nOur app has two API services, each has their own well defined business logic:\n\n- forms-api service: Handles managing the forms data.\n- cool-api service: Handles making cool suff.\n\n```\n/\n  libs/\n  services/\n    forms-api/\n    cool-api/\n```\n\nWhy? Most of the code changes are going to happen in this repo. When your team is making rapid changes, you are likely to have many feature branches, bug fixes, and pull requests. A bonus with serverless is that you can spin up new environments at zero cost (you only pay for usage, not for provisioning resources).\n\nFor example, a team can have dozens of ephemeral stages such as: prod, staging, dev, feature-x, feature-y, feature-z, bugfix-x, bugfix-y, pr-128, pr-132, etc.\n\nThis ensures each change is tested on real infrastructure before being promoted to production.\n\n\n### Built With\n\n* [Serverless Framework](https://www.serverless.com/)\n* [AWS](https://aws.amazon.com)\n\n\n## Getting Started\n\n\n### Do first\n\nThe services are dependent on the resources that are created in this [accompanying repo](https://github.com/helsingborg-stad/helsingborg-io-sls-resources).\n\n### Prerequisites\n\n- AWS CLI\n- AWS Account\n- AWS IAM user\n- Homebrew (macOS)\n- NodeJS\n- NPM\n- [Serverless Framework](https://serverless.com/)\n\n\n### Installation\n\n\nClone repo\n```sh\ngit clone git@github.com:helsingborg-stad/helsingborg-io-sls-api.git\n```\n\nInstall shared npm packages\n```sh\ncd helsingborg-io-sls-api\nnpm install\n```\n\n## Services\nEvery service in this mono repo has its own documentation. Follow links below.\n\n- Auth\n  - [Token](/services/auth/token)\n- [Bankid API](/services/bankid-api)\n- [Booking API](/services/booking-api)\n- [Cases API](/services/cases-api)\n- [Forms API](/services/forms-api)\n- [Navet MS](/services/navet-ms)\n- [Search API](/services/search-api)\n- [Users API](/services/users-api)\n- [Users MS](/services/users-ms)\n- [Viva MS](/services/viva-ms)\n\n\n\n## Roadmap\nThis repo is part of a project called Mitt Helsingborg. See the [project backlog](https://share.clickup.com/l/h/6-33382576-1/763b706816dbf53) for a complete list of upcoming features, known issues and releases.\n\n\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\n\n## License\n\nDistributed under the [MIT License][license-url].\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/helsingborg-stad/helsingborg-io-sls-api.svg?style=flat-square\n[contributors-url]: https://github.com/helsingborg-stad/helsingborg-io-sls-api/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/helsingborg-stad/helsingborg-io-sls-api.svg?style=flat-square\n[forks-url]: https://github.com/helsingborg-stad/helsingborg-io-sls-api/network/members\n[stars-shield]: https://img.shields.io/github/stars/helsingborg-stad/helsingborg-io-sls-api.svg?style=flat-square\n[stars-url]: https://github.com/helsingborg-stad/helsingborg-io-sls-api/stargazers\n[issues-shield]: https://img.shields.io/github/issues/helsingborg-stad/helsingborg-io-sls-api.svg?style=flat-square\n[issues-url]: https://github.com/helsingborg-stad/helsingborg-io-sls-api/issues\n[license-shield]: https://img.shields.io/github/license/helsingborg-stad/helsingborg-io-sls-api.svg?style=flat-square\n[license-url]: https://raw.githubusercontent.com/helsingborg-stad/helsingborg-io-sls-api/master/LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelsingborg-stad%2Fhelsingborg-io-sls-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelsingborg-stad%2Fhelsingborg-io-sls-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelsingborg-stad%2Fhelsingborg-io-sls-api/lists"}