### Kotlin, gRPC Web Application
### Getting Started
#### Client:
* The **html/javascript** client is generated from the **dodex-vertx/handicap/src/grpc/client** directory.
* Execute **`npm install`** to download the javascript dependencies.
* Execute **`./proto protos/handicap`** to generate the **proto3/gRPC** javascript modules. The proto3 configuration is in **./protos/handicap.proto**.
* Execute either **`npm run esbuild:build`** or **`npm run webpack:build`** to package the javascript development client. The output is located in **handicap/src/main/resources/static**. When making changes to javascript/html/css, simply rerun **`npm run esbuild:build`**, if the verticle is running, it will rebuild. For proto3 changes, rerun **`./proto protos/handicap`** first.
**Note:**
* **`esbuild`** is best for development(very fast) and **webpack** is better for production, e.g. **`npm run webpack:prod`**.
* See handicap/src/grpc/client/js/client.js to set up **`ipinfo.io`** so the form will default to local **country/state**.
#### Server:
* The server **./proto3/gRPC** classes are auto generated from the gradle build script to **handicap/build/classes/java/main/handicap/grpc/**.
* From the dodex-vertx directory, execute **`./gradlew run`** to build and execute the application. The **`./gradlew jooqGenerate`** task executes the **jooq** code generator. The generated code can be found in `handicap/src/main/kotlin/golf/handicap/generated`. Objects can then be used to define the queries. By default, the code is included with the project.
**Note**: The gradle configuration is a 3 level composite build, it does the following:
* compiles and executes the **jooq** java code generator located in **dodex-vertx/handicap/generate**, in development this can also create the database tables
* compiles the java and kotlin code located in `dodex-vertx/handicap`
* compiles and executes the java and kotlin code in `dodex-vertx` and `handicap`
* The next step is to install/startup the `envoy` proxy server. The javascript client needs a proxy to convert **http/1** to **http/2** as well as **CORS** processing. Assuming **envoy** is installed , execute the `start.envoy` script in `dodex-vertx`. The configuration for the proxy server is in **dodex-vertx/handicap/handicap.yaml**.
* If all goes well, only dodex-vertx at port `8087` should be started, the `handicap` application is turned off by default. **Note:** Setting **enableHandicap** to `true` in **.../resources/application-conf.json** will change the default startup.
* Kill **dodex-vertx**(ctrl-c), and set the environment variable **`export USE_HANDICAP=true`** and restart the server. In addition to the usual **8087** port display, there should also be a port `8888` display.
* For the standalone handicap application, view at **localhost:8888/handicap.html**, the **dodex** message client will not work from this port. For the complete application use port **8087**.
* The frontend html/gRPC javascript client should display. See operation section on how to use the form.
**Note:** Only `sqlite3`, `h2`, `mariadb` and `postgres` support the handicap application.
* The default database is `h2`. To change the default database, execute **`export DEFAULT_DB=mariadb`**, **`export DEFAULT_DB=postgres`** or **`export DEFAULT_DB=sqlite3`**.
* Gradle 8 configuration can now use jdk 19.
* Making database changes and using **jooqGenerate**
* Set **DEFAULT_DB** to either **sqlite3**, **postgres**, **h2** or ("mariadb" handles booleans and floats differently)
* If using **sqlite3** remove **handicap/dodex_tests.db**(Assumes that DbSqlite3.java has been changed as well as all other used databases)
* **Note:** In **..../dodex-vertx** directory run for each database, **`find . -name DbSqlite3.java`** to find the db schema
* Optionally remove **handicap/src/main/kotlin/golf/handicap/generated** directory
* Run **`./gradlew jooqGenerate`**
### Vert.x gRPC Server
* Implemented new gRPC server as described in the docs:
''Vert.x gRPC Server is a new gRPC server powered by Vert.x HTTP server superseding the integrated Netty based gRPC client.
This server provides a gRPC request/response oriented API as well as the generated stub approach with a service bridge.''
* see __.../handicap/src/main/kotlin/golf/handicap/vertx/HandicapGrpcServer.kt__, however, the Netty configuration is still default.
* To use the new gRPC Vert.x server, execute __`export GRPC_SERVER=true`__ or change __`"grpc.server": true`__ in .../src/main/resources/application-conf.json for a permanent change
### Production Build
* In **dodex-vertx/handicap/src/grpc/client** execute **`npm run webpack:prod`** or **`npm run esbuild:prod`**
* execute **`./gradlew clean`** and **`export USE_HANDICAP=true`**
* Make sure your database configurations are correct; **./src/main/resources/database...**, **./handicap/src/main/resources/database...**, **./handicap/generate/src/main/resources/database...**
* In **dodex-vertx** execute **`./gradlew shadowJar`** - **Note:** The default database should be **sqlite3**
* To start the production verticle, execute **`java -jar build/libs/dodex-vertx-3.1.0-prod.jar`**
* For the stand-alone handicap application execute `java -jar handicap/build/libs/handicap-0.0.1-fat.jar`
* Production runs on ports, **8880** and **8890**.
### Operation
The following are the steps to add golfer info, courses with tee data and golfer scores.
* First time login simply enter a **pin**(2 alpha characters with between 4-6 addition alphanumeric characters) with first and last name. Click the login button to create/login to the application. On subsequent logins only the `pin` is needed, don't forget it. The **Country** and **State** should also be selected before creating a **pin** as default values. However, you can change the defaults on any login. Also, **Overlap Years** and **Public** should be set.
* Overlap will use the previous year's scores for the handicap if needed.
* Public will allow your scores to show up in the **Scores** tab for public viewing.
* Add a course by entering its name with one radio button selected for the tee. You can also change the tee's color. The **rating**, **slope** and **par** values are also required. Click the **Add Tee** button. After the first added tee, the others can be added when needed.
* When re-logging in and selecting a previously added course the settings for the default tee(white) may not show. Simply select another radio button and then the default button.
**Note**: You can disable the course/tee add function by setting **handicap.enableAdmin** to **true** in the **...\resources\application-conf.json** file. And then use the default **`admin.pin`** to administer the courses/tees. When using this pin, a first and last name must be entered on initial use.
* To add a score, select a course and tee with values for **Gross Score**, **Adjusted Score** and **Tee Time**. Click the **Add Score** button to add the score. The **Remove Last Score** will remove the last entered score, multiple clicks will remove multiple scores.
**Note:** A handicap will be generated after 5 scores have been added.
### Handicap File Structure
```
dodex-vertx/handicap
├── db
├── generate
│ └── src
│ └── main
│ ├── java
│ │ └── dmo
│ │ └── fs
│ │ ├── db
│ │ └── utils
│ ├── kotlin
│ │ └── golf
│ │ └── handicap
│ └── resources
└── src
├── grpc
│ └── client
│ ├── config
│ ├── css
│ │ └── dtsel
│ ├── html
│ ├── js
│ │ ├── country-states
│ │ │ └── js
│ │ ├── dodex
│ │ ├── dtsel
│ │ ├── handicap
│ │ │ ├── json
│ │ │ └── protos
│ │ └── validate
│ ├── protos
│ └── static
├── main
│ ├── java
│ │ └── dmo
│ │ └── fs
│ │ ├── db
│ │ └── utils
│ ├── kotlin
│ │ └── golf
│ │ └── handicap
│ │ ├── db
│ │ ├── generated
│ │ │ ├── keys
│ │ │ └── tables
│ │ │ ├── records
│ │ │ └── references
│ │ ├── routes
│ │ └── vertx
│ ├── proto
│ └── resources
└── test
└── kotlin
├── golf
│ └── handicap
└── resources
```