# Scada-LTS
**Repository Path**: Ljango/Scada-LTS
## Basic Information
- **Project Name**: Scada-LTS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-02-10
- **Last Updated**: 2022-07-13
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# [Scada-LTS](http://scada-lts.org)
Open Source, web-based, multi-platform solution for building your own SCADA
(Supervisory Control and Data Acquisition) system.
Code released under [the GPL license](https://github.com/SCADA-LTS/Scada-LTS/blob/develop/LICENSE).
[](https://travis-ci.org/SCADA-LTS/Scada-LTS)
[](https://microbadger.com/images/scadalts/scadalts "Get your own version badge on microbadger.com")
[](https://microbadger.com/images/dockergb/scadalts-dev "Get your own image badge on microbadger.com")
---
See our [GitHub Wiki](https://github.com/SCADA-LTS/Scada-LTS/wiki) page to take the first steps inside
Scada-LTS project. There you can find **QuickStart Guide** how to run or build this application. Follow the latest changes and share your contribution with [our team](https://github.com/SCADA-LTS/Scada-LTS/wiki/The-Team)!
There is also a Scada-LTS users community so if you had a problem feel free to ask questions on StackOverflow or our GitHub Discussions.
For the developers we are preparing a complete code documentation that will contain all the REST API interfaces
described with example usage. To do that we use Open API specification in version 3 that is compatible with
most of the modern API tools like Swagger or Postman. Documentation file can be found in [Scada-LTS/doc](https://github.com/SCADA-LTS/Scada-LTS/tree/develop/doc/RESTAPI) directory.
To take your first steps inside Scada-LTS we suggest to get acquainted with video tutorials on YouTube or with [ScadaBR instructions](https://sourceforge.net/p/scadabr/wiki/Manual%20ScadaBR%20English%200%20Summary/).
Follow the [Release Section](https://github.com/SCADA-LTS/Scada-LTS/releases) to be up to date with the latest features and see the specific version changelogs.
We follow the [Semantic Versioning Guidelines](http://semver.org/) to organize changes in our application.
If you need support for deployment please contact us and find more information on [our website](http://scada-lts.comhttp://scada-lts.com/#support)
## Issues and ideas
Have you found a bug? Do you have idea for a new feature? Open a new [Issue](https://github.com/SCADA-LTS/Scada-LTS/issues) on our GitHub project site!
Please follow the [issue guidelines](https://github.com/twbs/bootstrap/blob/master/CONTRIBUTING.md#using-the-issue-tracker)
and make sure that your issue is not already reported. Try to write in english and explain what do you think in clear and understandable way.
---
# Development
## Building the application
To build the application on your own environment you can use **Gradle** or **Apache Ant** build tool.
Ant is now marked as `@depracated` because soon it will be removed from
that project. If you want to start the development of Scada-LTS find quick-start
tutorial on our [GitHub Wiki](https://github.com/SCADA-LTS/Scada-LTS/wiki/Prepare-environment-to-develop-(IntelliJ-Community)) page.
We provide example scripts that can be used inside Scada-LTS project to perform specific operations.
Commands with their explanations are listed below:
### Gradle Tasks
To run Gradle Task you have to use gradle version **6.8.1** or similar
with **Java version 11**. It should also work on other versions
but you have to change the targetVersion in `build.gradle` file.
| Command | Explanation |
| ---- | ---- |
| ```gradle war``` | Build Scada-LTS war file |
| ```gradle run``` | Launch Tomcat instance |
| ```gradle runDebug``` | Launch Tomcat instance in debug mode |
| ```gradle buildRun``` | Build and start Scada-LTS application |
| ```gradle buildRunDebug``` | Build and start Scada-LTS application in debug mode |
| ```gradle test``` | Launch Backend Unit Tests |
| ```gradle scadalts-ui::testUi``` | Launch Frontend Unit Tests |
| ```gradle -PskipUi=true buildRun``` | Build and start app without building UI |
Using parameter `-PskipUi=true` you can reduce the compilation time for example if you
made no change. More details how to build and develop the Frontend sub-project is described
in [readme.md file in scadalts-ui](./scadalts-ui/README.md) directory.
###Ant tasks
`@depracated`
#### Examples of run tasks
| Command | Explanation |
| ---- | ---- |
| ```ant run``` | Start Scada-LTS application using Tomcat server |
| ```ant build-run``` | Build and start Scada-LTS application |
| ```ant build-skip-test-run``` | Build and start Scada-LTS application without running Tests |
| ```ant build-no-ui-run``` | Build and start Scada-LTS application without building user interface |
| ```ant build-no-ui-skip-test-run``` | Build and start Scada-LTS application without building user interface but without Test task |
| ```ant run-debug``` | Start Scada-LTS application in debug mode on Tomcat server |
| ```ant build-run-debug``` | Build and start Scada-LTS application in debug mode |
| ```ant build-skip-test-run-debug``` | Build and start Scada-LTS application in debug mode without tests |
#### Examples of build tasks
| Command | Explanation |
| ---- | ---- |
| ```ant build``` | Build complete Scada-LTS application |
| ```ant build-skip-test``` | Build complete Scada-LTS application without testing |
| ```ant build-no-ui``` | Build just a core application without Vue.js user interface |
| ```ant build-no-ui-skip-test``` | Build just a core application without Vue.js user interface without testing |
| ```ant update-ui``` | Update running application with latest frontend application changes |
| ```ant create-war``` | Prepare WAR archive from existing resources
_we suggest to perform **ant build** task before_ |
#### Examples of test tasks
| Command | Explanation |
| ---- | ---- |
| ```ant test-junit``` | Launch Java Unit Tests |
| ```ant test-frontend-unit``` | Launch Vue.js tests |
## SeroUtils library license
Matthew Lohbihler has granted us permission to use the SeroUtils.jar library for ScadaLTS team. ScadaLTS team can use the code seroUtils without limitation.
Fragement with the correspondence of Grzegorz Bylica and Matthew Lohbihler:
> "(...) The good news is that you may hereby and without limitation use the seroUtils code as you like. (...)"
Project Documentation