{"id":15690223,"url":"https://github.com/pascalgrimaud/qualitoast","last_synced_at":"2025-05-07T23:32:00.344Z","repository":{"id":85169042,"uuid":"88826390","full_name":"pascalgrimaud/qualitoast","owner":"pascalgrimaud","description":":bread: Angular+Spring Boot application, made with JHipster :+1:","archived":false,"fork":false,"pushed_at":"2017-12-15T23:32:10.000Z","size":1830,"stargazers_count":8,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-26T05:41:27.383Z","etag":null,"topics":["angular","java","jhipster","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pascalgrimaud.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-20T05:55:59.000Z","updated_at":"2022-06-14T20:18:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"d6902709-69f4-462d-bf68-8de4bf2a9649","html_url":"https://github.com/pascalgrimaud/qualitoast","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgrimaud%2Fqualitoast","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgrimaud%2Fqualitoast/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgrimaud%2Fqualitoast/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgrimaud%2Fqualitoast/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pascalgrimaud","download_url":"https://codeload.github.com/pascalgrimaud/qualitoast/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243042903,"owners_count":20226720,"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":["angular","java","jhipster","spring-boot"],"created_at":"2024-10-03T18:08:21.790Z","updated_at":"2025-03-11T13:31:57.406Z","avatar_url":"https://github.com/pascalgrimaud.png","language":"Java","readme":"# QualiToast\n\n\n[![QualiToast Project][project-image]][project-url] [![codecov][codecov-image]][codecov-url] [![Docker Hub][docker-image]][docker-url]\n\n[![Build Status][travis-image]][travis-url] [![Docker Status][circleci-image]][circleci-url]\n\n\n## Description\n\nThis application was generated using JHipster 4.13.0, you can find documentation and help at [http://www.jhipster.tech/documentation-archive/v4.13.0](http://www.jhipster.tech/documentation-archive/v4.13.0).\n\nThere options are used:\n- Angular\n- Maven\n- PostgreSQL\n- ElasticSearch\n\nIt added:\n\n- A page for reindexing Elasticsearch, using this module [generator-jhipster-elasticsearch-reindexer](https://github.com/geraldhumphries/generator-jhipster-elasticsearch-reindexer)\n- Docker image at Docker Hub, using this module [generator-jhipster-docker](https://github.com/pascalgrimaud/generator-jhipster-docker) \n- bootswatch theme: [pulse](https://bootswatch.com/4-alpha/pulse/)\n- [PrimeNG](https://www.primefaces.org/primeng/#/) for charts, using this module [generator-jhipster-primeng-charts](https://github.com/pascalgrimaud/generator-jhipster-primeng-charts)\n- Custom 3D Banner, using this module [generator-jhipster-banner](https://github.com/PierreBesson/generator-jhipster-banner)\n\n\n## Development\n\nBefore you can build this project, you must install and configure the following dependencies on your machine:\n\n1. [Node.js][]: We use Node to run a development web server and build the project.\n   Depending on your system, you can install Node either from source or as a pre-packaged bundle.\n2. [Yarn][]: We use Yarn to manage Node dependencies.\n   Depending on your system, you can install Yarn either from source or as a pre-packaged bundle.\n\nAfter installing Node, you should be able to run the following command to install development tools.\nYou will only need to run this command when dependencies change in [package.json](package.json).\n\n    yarn install\n\nWe use yarn scripts and [Webpack][] as our build system.\n\n\nRun the following commands in two separate terminals to create a blissful development experience where your browser\nauto-refreshes when files change on your hard drive.\n\n    ./mvnw\n    yarn start\n\n[Yarn][] is also used to manage CSS and JavaScript dependencies used in this application. You can upgrade dependencies by\nspecifying a newer version in [package.json](package.json). You can also run `yarn update` and `yarn install` to manage dependencies.\nAdd the `help` flag on any command to see how you can use it. For example, `yarn help update`.\n\nThe `yarn run` command will list all of the scripts available to run for this project.\n\n\n### Service workers\n\nService workers are commented by default, to enable them please uncomment the following code.\n\n* The service worker registering script in index.html\n\n```html\n\u003cscript\u003e\n    if ('serviceWorker' in navigator) {\n        navigator.serviceWorker\n        .register('./sw.js')\n        .then(function() { console.log('Service Worker Registered'); });\n    }\n\u003c/script\u003e\n```\n\nNote: workbox creates the respective service worker and dynamically generate the `sw.js`\n\n### Managing dependencies\n\nFor example, to add [Leaflet][] library as a runtime dependency of your application, you would run following command:\n\n    yarn add --exact leaflet\n\nTo benefit from TypeScript type definitions from [DefinitelyTyped][] repository in development, you would run following command:\n\n    yarn add --dev --exact @types/leaflet\n\nThen you would import the JS and CSS files specified in library's installation instructions so that [Webpack][] knows about them:\nEdit [src/main/webapp/app/vendor.ts](src/main/webapp/app/vendor.ts) file:\n~~~\nimport 'leaflet/dist/leaflet.js';\n~~~\n\nEdit [src/main/webapp/content/css/vendor.css](src/main/webapp/content/css/vendor.css) file:\n~~~\n@import '~leaflet/dist/leaflet.css';\n~~~\nNote: there are still few other things remaining to do for Leaflet that we won't detail here.\n\nFor further instructions on how to develop with JHipster, have a look at [Using JHipster in development][].\n\n### Using angular-cli\n\nYou can also use [Angular CLI][] to generate some custom client code.\n\nFor example, the following command:\n\n    ng generate component my-component\n\nwill generate few files:\n\n    create src/main/webapp/app/my-component/my-component.component.html\n    create src/main/webapp/app/my-component/my-component.component.ts\n    update src/main/webapp/app/app.module.ts\n\n\n## Building for production\n\nTo optimize the QualiToast application for production, run:\n\n    ./mvnw -Pprod clean package\n\nThis will concatenate and minify the client CSS and JavaScript files. It will also modify `index.html` so it references these new files.\nTo ensure everything worked, run:\n\n    java -jar target/*.war\n\nThen navigate to [http://localhost:8080](http://localhost:8080) in your browser.\n\nRefer to [Using JHipster in production][] for more details.\n\n\n## Testing\n\n### Backend tests\n\nTo launch your application's tests, run:\n\n    ./mvnw clean test\n\n### Frontend tests\n\nUnit tests are run by [Karma][] and written with [Jasmine][]. They're located in [src/test/javascript/](src/test/javascript/) and can be run with:\n\n    yarn test\n\n### End-to-End tests\n\nUI end-to-end tests are powered by [Protractor][], which is built on top of WebDriverJS. They're located in [src/test/javascript/e2e](src/test/javascript/e2e)\nand can be run by starting Spring Boot in one terminal (`./mvnw spring-boot:run`) and running the tests (`yarn run e2e`) in a second one.\n\n### Other tests\n\nPerformance tests are run by [Gatling][] and written in Scala. They're located in [src/test/gatling](src/test/gatling) and can be run with:\n\n    ./mvnw gatling:execute\n\nFor more information, refer to the [Running tests page][].\n\n## Using Docker to simplify development (optional)\n\nYou can use Docker to improve your JHipster development experience. A number of docker-compose configuration are available in the [src/main/docker](src/main/docker) folder to launch required third party services.\nFor example, to start a PostgreSQL database in a docker container, run:\n\n    docker-compose -f src/main/docker/postgresql.yml up -d\n\nTo stop it and remove the container, run:\n\n    docker-compose -f src/main/docker/postgresql.yml down\n\nTo start a ElasticSearch in a docker container, run:\n\n    docker-compose -f src/main/docker/elasticsearch.yml up -d\n\nTo stop it and remove the container, run:\n\n    docker-compose -f src/main/docker/elasticsearch.yml down\n\nYou can also fully dockerize your application and all the services that it depends on.\nTo achieve this, first build a docker image of your app by running:\n\n    ./mvnw package -Pprod dockerfile:build\n\nThen run:\n\n    docker-compose -f src/main/docker/app.yml up -d\n\nFor more information refer to [Using Docker and Docker-Compose][], this page also contains information on the docker-compose sub-generator (`yo jhipster:docker-compose`), which is able to generate docker configurations for one or several JHipster applications.\n\n\n## Docker Hub\n\nThis project build this automated Docker image at:\n\n[![Docker Hub][docker-image]][docker-url]\n\nTry this image with dev profile:\n\n    docker run -d -p 8080:8080 -e SPRING_PROFILES_ACTIVE=dev,swagger pascalgrimaud/qualitoast\n\n\nOr, you can use the following docker-compose file to run the:\n\n- application: QualiToast\n- database: PostgreSQL\n- search engine: ElasticSearch\n\n```yaml\nversion: '2'\nservices:\n    qualitoast-app:\n        image: pascalgrimaud/qualitoast\n        environment:\n            - SPRING_PROFILES_ACTIVE=prod,swagger\n            - SPRING_DATASOURCE_URL=jdbc:postgresql://qualitoast-postgresql:5432/QualiToast\n            - JHIPSTER_SLEEP=10\n            - SPRING_DATA_ELASTICSEARCH_CLUSTER_NODES=qualitoast-elasticsearch:9300\n        ports:\n            - 8080:8080\n    qualitoast-postgresql:\n        image: postgres:9.6.2\n        #volumes:\n        #    - ~/volumes/jhipster/QualiToast/postgresql/:/var/lib/postgresql/\n        environment:\n            - POSTGRES_USER=QualiToast\n            - POSTGRES_PASSWORD=\n    qualitoast-elasticsearch:\n        image: elasticsearch:2.4.1\n        #volumes:\n        #    - ~/volumes/jhipster/QualiToast/elasticsearch/:/usr/share/elasticsearch/data/\n``` \n\n\n[JHipster Homepage and latest documentation]: http://www.jhipster.tech\n[JHipster 4.13.0 archive]: http://www.jhipster.tech/documentation-archive/v4.13.0\n\n[Using JHipster in development]: http://www.jhipster.tech/documentation-archive/v4.13.0/development/\n[Using Docker and Docker-Compose]: http://www.jhipster.tech/documentation-archive/v4.13.0/docker-compose\n[Using JHipster in production]: http://www.jhipster.tech/documentation-archive/v4.13.0/production/\n[Running tests page]: http://www.jhipster.tech/documentation-archive/v4.13.0/running-tests/\n[Setting up Continuous Integration]: http://www.jhipster.tech/documentation-archive/v4.13.0/setting-up-ci/\n\n[Gatling]: http://gatling.io/\n[Node.js]: https://nodejs.org/\n[Yarn]: https://yarnpkg.org/\n[Webpack]: https://webpack.github.io/\n[Angular CLI]: https://cli.angular.io/\n[BrowserSync]: http://www.browsersync.io/\n[Karma]: http://karma-runner.github.io/\n[Jasmine]: http://jasmine.github.io/2.0/introduction.html\n[Protractor]: https://angular.github.io/protractor/\n[Leaflet]: http://leafletjs.com/\n[DefinitelyTyped]: http://definitelytyped.org/\n\n[travis-image]: https://travis-ci.org/pascalgrimaud/qualitoast.svg?branch=master\n[travis-url]: https://travis-ci.org/pascalgrimaud/qualitoast/branches\n\n[circleci-image]: https://circleci.com/gh/pascalgrimaud/qualitoast/tree/master.png\n[circleci-url]: https://circleci.com/gh/pascalgrimaud/qualitoast\n\n[codecov]: https://codecov.io\n[codecov-image]: https://codecov.io/gh/pascalgrimaud/qualitoast/branch/master/graph/badge.svg\n[codecov-url]: https://codecov.io/gh/pascalgrimaud/qualitoast\n\n[docker-image]: https://img.shields.io/badge/docker%20hub-pascalgrimaud%2Fqualitoast-blue.svg?style=flat \n[docker-url]: https://hub.docker.com/r/pascalgrimaud/qualitoast/\n\n[project-image]: https://img.shields.io/badge/project-qualitoast-593196.svg\n[project-url]: https://github.com/pascalgrimaud/qualitoast\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpascalgrimaud%2Fqualitoast","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpascalgrimaud%2Fqualitoast","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpascalgrimaud%2Fqualitoast/lists"}