Skip to content

Commit 10a13dc

Browse files
author
Shelson Ferrari
committed
README file
1 parent 075a335 commit 10a13dc

1 file changed

Lines changed: 34 additions & 35 deletions

File tree

README.md

Lines changed: 34 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -16,76 +16,75 @@
1616

1717
A Currency conversion project - server, database, access clients (input data and list data).
1818

19-
## In a nutshell
19+
## In a Nutshell
2020

21-
**Steps to download, install, configure, run and start the Java Rest API server, the database server, insert data into the database, as well as test and view the persisted data in the project:**
21+
Steps to download, install, configure, run and start the Java Rest API server, the database server, insert data into the database, as well as test and view the persisted data in the project:
2222

23-
- **Open the Command Prompt**
24-
25-
- **Clone the GitHub repository and access the project folder:**
23+
- **Open the Command Prompt and Clone the GitHub repository and access the project folder:**
2624

2725
```bash
2826
git clone https://github.com/33mestre/java_base.git
29-
cd shelson
27+
cd java_base
3028
```
3129

3230
### Procedures for Unix / Linux Environment
3331

34-
**Permissions:**
32+
**Define Scripts Permissions:**
3533

3634
```bash
3735
chmod +x index.sh
3836
chmod +x scripts/*.sh
3937
```
4038

41-
**Server:**
39+
### Procedures for MS Windows Environment
4240

43-
```bash
44-
bash server.sh
45-
```
41+
No special permissions are required.
4642

47-
**Access Client:**
43+
### Running the Project
4844

49-
```bash
50-
bash console.sh
51-
```
45+
**Execute the main script:**
5246

53-
**Data Listing:**
47+
For Unix / Linux:
5448

5549
```bash
56-
bash db.sh
50+
./index.sh
5751
```
5852

59-
### Procedures for MS Windows Environment
53+
For Windows:
6054

6155
```bash
62-
server.bat
56+
index.bat
6357
```
6458

65-
**Access Client:**
66-
67-
```bash
68-
console.bat
69-
```
59+
**Menu Options:**
7060

71-
**Data Listing:**
61+
When you run the main script (`index.sh` or `index.bat`), you will be presented with the following options:
7262

7363
```bash
74-
db.bat
64+
Selecione uma opção:
65+
[1] - Server
66+
[2] - Console
67+
[3] - DB
68+
[4] - Directory
69+
[5] - Changelog
7570
```
7671

77-
It's Ready. With just these simple steps, you should have:
72+
**Options Description:**
7873

79-
- A Java Spring server with the application running;
80-
- An H2 Database server running;
81-
- An access client to access the currency conversion application;
82-
- A data lister for the data persisted in the database.
74+
- **Server:** Starts the Java Spring server with the application running.
75+
- **Console:** Launches the access client to interact with the currency conversion application.
76+
- **DB:** Runs the data lister to view the data persisted in the H2 database.
77+
- **Directory:** Generates the `DIRECTORY.md` file (used for testing purposes, as this is also automated in the CI/CD pipeline).
78+
- **Changelog:** Updates the `CHANGELOG.md` file (used for testing purposes, as this is also automated in the CI/CD pipeline).
8379

84-
Only with Docker installed, without additional installations, working in MS Windows, Linux, and Unix environments.
80+
With just these simple steps, you should have:
8581

86-
When running the scripts, Docker is installed via terminal by the scripts if it is not already installed; in the case of MS Windows, you will be notified that it is necessary to download manually.
82+
- A Java Spring server with the application running.
83+
- An H2 Database server running.
84+
- An access client to access the currency conversion application.
85+
- A data lister for the data persisted in the database.
8786

88-
Next, an extensive documentation of all aspects of the project.
87+
This setup requires only Docker installed, without additional installations, working in MS Windows, Linux, and Unix environments. The scripts will handle the Docker installation if it's not already installed; for MS Windows, a notification will prompt you to download it manually.
8988

9089
## Project authorship
9190

@@ -99,7 +98,7 @@ Next, an extensive documentation of all aspects of the project.
9998

10099
> [Project Change Log](./CHANGELOG.md)
101100
102-
The generation of `CHANGELOG.md` is automated and occurs with each new commit to the repository, thanks to a CI/CD pipeline. This pipeline uses a Docker container that runs a Groovy script to extract commit information, such as hash, date, author, and message, organizing them in an incremental version format. Commits containing the keyword `"AUTO_COMMIT"` are ignored. The `Groovy script` is responsible for generating the changelog, continuously updating it to reflect all changes made to the project in a precise and detailed manner. The process begins with the CI/CD pipeline calling the Groovy script inside the Docker container, ensuring the changelog is generated correctly.
101+
The generation of `CHANGELOG.md` is automated and occurs with each new commit to the repository, thanks to a CI/CD pipeline. This pipeline uses a Docker container that runs a Groovy script to extract commit information, such as hash, date, author, and message, organizing them in an incremental version format. Commits containing the keyword `"AUTO_COMMIT"` are ignored. The Groovy script is responsible for generating the changelog, continuously updating it to reflect all changes made to the project in a precise and detailed manner. The process begins with the CI/CD pipeline calling the Groovy script inside the Docker container, ensuring the changelog is generated correctly.
103102

104103
## Project JavaDoc (Markdown format)
105104

0 commit comments

Comments
 (0)