{"id":13552976,"url":"https://github.com/digitalfondue/lavagna","last_synced_at":"2025-04-03T04:31:35.736Z","repository":{"id":22625826,"uuid":"25968382","full_name":"digitalfondue/lavagna","owner":"digitalfondue","description":"Lavagna: issue tracker/project management tool","archived":false,"fork":false,"pushed_at":"2023-03-17T21:49:15.000Z","size":13202,"stargazers_count":636,"open_issues_count":28,"forks_count":110,"subscribers_count":41,"default_branch":"master","last_synced_at":"2024-08-01T12:29:47.773Z","etag":null,"topics":["bugtracker","issue-board","issue-tracker","java","kanban","project-management","project-planning"],"latest_commit_sha":null,"homepage":"http://lavagna.io","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digitalfondue.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE-GPLv3.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2014-10-30T11:46:26.000Z","updated_at":"2024-07-30T09:34:38.000Z","dependencies_parsed_at":"2022-07-27T03:17:13.097Z","dependency_job_id":"70990979-5076-497a-a4cf-1c80331f6cac","html_url":"https://github.com/digitalfondue/lavagna","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalfondue%2Flavagna","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalfondue%2Flavagna/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalfondue%2Flavagna/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalfondue%2Flavagna/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalfondue","download_url":"https://codeload.github.com/digitalfondue/lavagna/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222920968,"owners_count":17058103,"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":["bugtracker","issue-board","issue-tracker","java","kanban","project-management","project-planning"],"created_at":"2024-08-01T12:02:14.475Z","updated_at":"2024-11-04T00:31:11.181Z","avatar_url":"https://github.com/digitalfondue.png","language":"Java","funding_links":[],"categories":["Java","项目管理","java"],"sub_categories":[],"readme":"Lavagna\n======\n\n[![Java CI with Maven](https://github.com/digitalfondue/lavagna/workflows/Java%20CI%20with%20Maven/badge.svg)](https://github.com/digitalfondue/lavagna/actions?query=workflow%3A%22Java+CI+with+Maven%22)\n[![Maven Central](https://img.shields.io/maven-central/v/io.lavagna/lavagna.svg)](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22lavagna%22)\n[![Github All Releases](https://img.shields.io/github/downloads/digitalfondue/lavagna/total.svg)](https://github.com/digitalfondue/lavagna/releases)\n[![Docker Status](https://img.shields.io/docker/pulls/digitalfondue/lavagna.svg)](https://registry.hub.docker.com/u/digitalfondue/lavagna/)\n\n# Latest stable release is 1.1.9 (2021-12-30) #\n\n## About ##\n\n[Lavagna](http://lavagna.io) is a small and easy to use issue/project tracking software.\n\nIt requires Java 8 or better and optionally a database: MySQL, MariaDB or PostgreSQL. It can be deployed in a Java servlet container or as a self contained war.\n\nSee:\n\n - [roadmap](https://github.com/digitalfondue/lavagna/blob/master/ROADMAP.md)\n - [changelog](https://github.com/digitalfondue/lavagna/blob/master/CHANGELOG.md)\n - [download](http://lavagna.io/download/)\n\n\n## Install ##\n\nLavagna supports MySQL (at least 5.1), MariaDB (tested on 10.1), PostgreSQL (tested on 9.1) and HSQLDB (for small deploy).\n\nIt's distributed in 2 forms:\n\n - simple war for deploying in your preferred web container\n - self contained war with embedded jetty web server\n \nSee the documentation at http://help.lavagna.io\n\n### For testing purposes ###\n\nIf you want to test it locally, you can download the self contained war and run:\n\n```\nwget https://repo1.maven.org/maven2/io/lavagna/lavagna/1.1.9/lavagna-1.1.9-distribution.zip\nunzip lavagna-1.1.9-distribution.zip\n./lavagna-1.1.9/bin/lavagna.sh\n```\n\nGo to http://localhost:8080 and login with \"user\" (password \"user\").\n\nSee the README in the archive and the documentation at http://help.lavagna.io if you want to customize the scripts and set lavagna in production mode.\n\n### Docker ###\n\nLavagna is also available as a Docker image so you can try it on the fly:\n\n```\nhttps://registry.hub.docker.com/u/digitalfondue/lavagna/\n```\n\n## Develop ##\n\n### Java and Kotlin ###\n\nLavagna runs on a Java 8 jvm.\nSome parts of Lavagna are made with Kotlin.\n\n### IDE Configuration ###\n\nUse UTF-8 encoding and 120 characters as line width.\nYou will need a Java _and_ Kotlin aware IDE. (Currently tested with intellij and eclipse).\n\nFor eclipse: you will need to install the kotlin plugin and add the \"Kotlin nature\" to the project:\nRight click on the project -\u003e \"Configure Kotlin\" -\u003e \"Add Kotlin nature\"\n\n### Javascript\n\nInstall npm and run the following script to assure your code follows our guidelines\n\nFirst ensure that all the dependencies are ok with `npm install`.\n\nThen, for checking:\n\n```\nnpm run-script lint\n```\n\nFix any error or warning before opening a pull request\n\n### Execute ###\n\nLaunch the Web Server:\n\n```\nmvn jetty:run\n```\n\nFor launching Web Server + DB manager (HSQLDB only):\n\n```\nmvn jetty:run -DstartDBManager\n```\n\nfor launching Web Server with the MySQL database (use the mysql profile):\n\n```\nmvn jetty:run -Pdev-mysql\n```\n```\nmvn jetty:run -Pdev-pgsql\n```\n- go to http://localhost:8080\n  if you have a 403 error, you must configure the application,\n  go to http://localhost:8080/setup, select demo + insert user \"user\".\n\n- enter\n\tusername: user\n\tpassword: user\n\nFor debugging:\n\n```\nmvnDebug jetty:run\n```\n\nFor running the test cases:\n\n```\nmvn test\n```\n\nFor running the test cases with MySQL or PostgreSQL:\n\n```\nmvn test -Ddatasource.dialect=MYSQL\n```\n```\nmvn test -Ddatasource.dialect=PGSQL\n```\n\nFor running with jetty-runner:\n\n```\nmvn clean install\njava -Ddatasource.dialect=HSQLDB -Ddatasource.url=jdbc:hsqldb:mem:lavagna -Ddatasource.username=sa -Ddatasource.password= -Dspring.profiles.active=dev -jar target/dependency/jetty-runner.jar --port 8080 target/*.war\n```\n\nWhen adding new file, remember to add the license header with:\n\n```\nmvn com.mycila:license-maven-plugin:format\n```\n\n### Angular perfs ###\n\nUse the following stats for keeping an eye on the performances:\n\n - https://github.com/kentcdodds/ng-stats has a bookmarklet\n - https://github.com/mrdoob/stats.js/ has a bookrmarklet\n\n### Documentation ###\n\nThe documentation is written using stampo (see https://github.com/digitalfondue/stampo).\nIt currently reside in src/main/stampo .\n\nFor building the doc:\n\n```\nmvn clean stampo:build\n```\n\nThe output will be present in target/generated-docs\n\nFor testing the documentation run\n\n```\nmvn stampo:serve\n```\n\nAnd go to http://localhost:45001/\n\n### Vagrant ###\n\nIn order to make it easier to tests on different databases we included 3 Vagrant VMs.\nMake sure that you have installed Vagrant and VirtualBox before continuing.\n\n#### Initialization ####\n\nFetch the submodules:\n\n```\ngit submodule update --init\n```\n\nIf you are under windows you need to ensure that the pgsql submodule is not in a broken state,\ndouble check that the file puppet\\modules\\postgresql\\files\\validate_postgresql_connection.sh is using the\nunix end of line (run dos2unix).\n\nTo run the tests with Vagrant boot the VMs with:\n\n```\nvagrant up [optionally use pgsql / mysql to boot only one VM]\n```\n\nOnce that the VM is up and running run the tests:\n\n```\nmvn test -Ddatasource.dialect=PGSQL / MYSQL\n```\n\n\n#### Connecting manually: ####\n\nPGSQL: localhost:5432/lavagna as postgres / password\n\nMySQL: localhost:3306/lavagna as root\n\n## Notes about databases ##\n\nThe application uses UTF-8 at every stage and on MySQL you will need to create a database with the collation set to utf8_bin:\n\n```\nCREATE DATABASE lavagna CHARACTER SET utf8 COLLATE utf8_bin;\n```\n\n\n### Code Coverage ###\n\nJacoco plugin is used.\n\n```\nmvn clean test jacoco:report\n```\n\n-\u003e open target/site/jacoco/index.html with your browser\n\n\n## About Database migration ##\n\nCan be disabled using the following system property: datasource.disable.migration=true\n\n\n## Check for updated dependencies ##\n\n```\nmvn versions:display-dependency-updates\n```\n```\nmvn versions:display-plugin-updates\n```\n\n## Supported by ##\n\n[![Alt text](misc/jetbrains.png)](https://www.jetbrains.com/?from=Lavagna)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalfondue%2Flavagna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalfondue%2Flavagna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalfondue%2Flavagna/lists"}