{"id":22894861,"url":"https://github.com/valtimo-platform/valtimo-backend-libraries","last_synced_at":"2025-05-07T19:23:45.477Z","repository":{"id":37088223,"uuid":"288515343","full_name":"valtimo-platform/valtimo-backend-libraries","owner":"valtimo-platform","description":"Welcome at the Valtimo repository. Valtimo is the less-code platform for Business Process Automation. Built on top of business process orchestrator Camunda. Valtimo's goal is to make implementing business process automation and case management easy. Valtimo is the server side component for business process automation.","archived":false,"fork":false,"pushed_at":"2025-05-06T15:35:21.000Z","size":21621,"stargazers_count":18,"open_issues_count":16,"forks_count":5,"subscribers_count":1,"default_branch":"next-minor","last_synced_at":"2025-05-06T16:51:04.490Z","etag":null,"topics":["bpa","business-process","business-process-automation","camunda","case","case-data","valtimo"],"latest_commit_sha":null,"homepage":"https://www.valtimo.nl","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valtimo-platform.png","metadata":{"files":{"readme":"README.md","changelog":"changelog/build.gradle","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.MD","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":"audit/.env","citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-08-18T17:04:56.000Z","updated_at":"2025-05-06T08:27:26.000Z","dependencies_parsed_at":"2023-09-29T07:11:00.001Z","dependency_job_id":"bfc7015e-2a30-4903-be8d-d7e85a730517","html_url":"https://github.com/valtimo-platform/valtimo-backend-libraries","commit_stats":null,"previous_names":[],"tags_count":91,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valtimo-platform%2Fvaltimo-backend-libraries","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valtimo-platform%2Fvaltimo-backend-libraries/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valtimo-platform%2Fvaltimo-backend-libraries/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valtimo-platform%2Fvaltimo-backend-libraries/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valtimo-platform","download_url":"https://codeload.github.com/valtimo-platform/valtimo-backend-libraries/tar.gz/refs/heads/next-minor","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252941995,"owners_count":21828980,"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":["bpa","business-process","business-process-automation","camunda","case","case-data","valtimo"],"created_at":"2024-12-13T23:20:12.006Z","updated_at":"2025-05-07T19:23:45.462Z","avatar_url":"https://github.com/valtimo-platform.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Welcome to Valtimo\n\n### What is Valtimo?\nValtimo is the low-code platform for Business Process Automation. Our goal is to make implementing business process automation and case management easy.\n\n### What does the Valtimo platform contain?\n- Valtimo consists of two services:\n    - A Spring Boot Java/Kotlin backend\n    - An Angular frontend\n- Valtimo depends on two services:\n    - Keycloak as an identity and access provider\n    - A database (default is PostgreSQL)\n\n\u003cimg src=\"images/valtimo-platform.png\" width=\"400\" alt=\"Valtimo platform\"/\u003e\n\n### What are the 'Valtimo backend libraries'?\nThis repository contains:\n- A collection of Java/Kotlin libraries that together form the Valtimo backend.\n- The `app:gzac` module, containing a Spring Boot application, used for library development.\n\n### Starting the Valtimo platform\nStarting up the Valtimo platform requires two steps:\n1. Starting the Valtimo backend. Instructions can be found [here](#starting-the-valtimo-backend-libraries-from-source).\n2. Starting the Valtimo frontend. Instructions can be found [here](https://github.com/valtimo-platform/valtimo-frontend-libraries/#starting-the-valtimo-frontend-libraries-from-source)\n\n### Starting the Valtimo backend libraries from source\n#### Prerequisites\n- Java 17\n- [Docker (Desktop)](https://www.docker.com/products/docker-desktop/)\n- (Optional) An IDE like [IntelliJ](https://www.jetbrains.com/idea/download/) or [Eclipse](https://www.eclipse.org/downloads/)\n\n#### Start Application\nRun the following command to start the Spring Boot application: `./gradlew :app:gzac:bootRunWithDocker`.\n\n### Test users\nKeycloak management can be accessed on http://localhost:8081 with the default credentials of username \u003cins\u003eadmin\u003c/ins\u003e and password \u003cins\u003eadmin\u003c/ins\u003e.\n\nKeycloak comes preconfigured with the following users.\n\n| Name         | Role           | Username  | Password  |\n|--------------|----------------|-----------|-----------|\n| James Vance  | ROLE_USER      | user      | user      |\n| Asha Miller  | ROLE_ADMIN     | admin     | admin     |\n| Morgan Finch | ROLE_DEVELOPER | developer | developer |\n\n### Code quality\n#### Running tests\n- Run the following command to run the unit tests: `./gradlew test`.\n- Run the following command to run the integration tests using a PostgreSQL database: `./gradlew integrationTestingPostgresql`.\n- Run the following command to run the integration tests using a MySQL database: `./gradlew integrationTestingMysql`.\n- Run the following command to run the security tests: `./gradlew securityTesting`.\n\n### Contributing\nContributions are welcome! To get you in the right direction, please consult the [Valtimo documentation](https://docs.valtimo.nl/contributing-to-valtimo/contributing-to-valtimo) for guidelines on how to contribute.\n\n#### Code guidelines\n\u003c!--- TODO: write the coding guidelines---\u003e\nFor contributing code, please refer to the [coding guidelines](CODING-GUIDELINES.md).\n\n#### Branching strategy\nFor more information on what branches to create while working in this project, please refer\nto [this page](https://docs.valtimo.nl/contributing-to-valtimo/branching-and-release-strategy).\n\n### License\nThe source files in this repo are licensed under the [EUPL 1.2](https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12).\nIf you have any questions about the use of this codebase in a larger work: please reach out through the [Valtimo website](https://www.valtimo.nl/contact/).\n\n### More information\n- Website: https://www.valtimo.nl\n- Documentation: https://docs.valtimo.nl\n- Academy: https://academy.valtimo.nl\n- Process Exchange (Dutch, GZAC edition only): https://exchange.gzac.nl/\n- Designer: https://designer.valtimo.nl/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaltimo-platform%2Fvaltimo-backend-libraries","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaltimo-platform%2Fvaltimo-backend-libraries","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaltimo-platform%2Fvaltimo-backend-libraries/lists"}