goland debug stack

.run/[git] payroll server.run.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="[git] payroll server" type="GoApplicationRunConfiguration" factoryName="Go Application">
+    <module name="plugin" />
+    <working_directory value="$PROJECT_DIR$" />
+    <envs>
+      <env name="BASE_CONFIG_PATH" value="etc/vultisig" />
+      <env name="DATABASE_DSN" value="postgres://myuser:mypassword@localhost:5431/vultisig-plugin?sslmode=disable" />
+      <env name="SERVER_PORT" value="8081" />
+      <env name="VS_CONFIG_NAME" value="payroll.server.example" />
+    </envs>
+    <kind value="PACKAGE" />
+    <package value="github.com/vultisig/plugin/cmd/payroll/server" />
+    <directory value="$PROJECT_DIR$" />
+    <filePath value="$PROJECT_DIR$/cmd/payroll/server/main.go" />
+    <method v="2" />
+  </configuration>
+</component>

.run/[git] payroll worker.run.xml

@@ -0,0 +1,16 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="[git] payroll worker" type="GoApplicationRunConfiguration" factoryName="Go Application">
+    <module name="plugin" />
+    <working_directory value="$PROJECT_DIR$" />
+    <envs>
+      <env name="BASE_FILE_PATH" value="etc/vultisig" />
+      <env name="DATABASE_DSN" value="postgres://myuser:mypassword@localhost:5431/vultisig-plugin?sslmode=disable" />
+      <env name="VS_CONFIG_NAME" value="payroll.worker.example" />
+    </envs>
+    <kind value="PACKAGE" />
+    <package value="github.com/vultisig/plugin/cmd/payroll/worker" />
+    <directory value="$PROJECT_DIR$" />
+    <filePath value="$PROJECT_DIR$/cmd/payroll/worker/main.go" />
+    <method v="2" />
+  </configuration>
+</component>

.run/[git] plugin stack.run.xml

@@ -0,0 +1,8 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="[git] plugin stack" type="CompoundRunConfigurationType">
+    <toRun name="[git] payroll server" type="GoApplicationRunConfiguration" />
+    <toRun name="[git] payroll worker" type="GoApplicationRunConfiguration" />
+    <toRun name="[git] tx_indexer worker" type="GoApplicationRunConfiguration" />
+    <method v="2" />
+  </configuration>
+</component>

.run/[git] tx_indexer worker.run.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="[git] tx_indexer worker" type="GoApplicationRunConfiguration" factoryName="Go Application">
+    <module name="plugin" />
+    <working_directory value="$PROJECT_DIR$" />
+    <envs>
+      <env name="DATABASE.DSN" value="postgres://myuser:mypassword@localhost:5431/vultisig-plugin?sslmode=disable" />
+      <env name="RPC.BITCOIN.URL" value="https://bitcoin-rpc.publicnode.com" />
+      <env name="RPC.ETHEREUM.URL" value="https://ethereum-rpc.publicnode.com" />
+      <env name="VS_CONFIG_NAME" value="config-tx-indexer" />
+    </envs>
+    <kind value="PACKAGE" />
+    <package value="github.com/vultisig/plugin/cmd/tx_indexer" />
+    <directory value="$PROJECT_DIR$" />
+    <filePath value="$PROJECT_DIR$/cmd/tx_indexer/main.go" />
+    <method v="2" />
+  </configuration>
+</component>

README.md

@@ -89,9 +89,9 @@ Vultisigner / VultiServer consists of two components:
 - Docker and Docker Compose
 - MinIO client (mc)
 
-## 1. Start Infrastructure Services
+## 1. Start Services
 
-First, start the required infrastructure services using Docker Compose:
+First, start the services using Docker Compose, it has both db/infra and backend services:
 
 ```
 # create shared network in docker
@@ -102,6 +102,15 @@ make up
 make down
 ```
 
+To debug Docker containers in GoLand with breakpoints, [refer to this article](https://www.jetbrains.com/help/go/attach-to-running-go-processes-with-debugger.html).
+
+For convenient usage of debug breakpoints in GoLand, you can start only infra/db with Docker, and backend services outside Docker. Configs shared in `.run` directory, all envs already configured correctly. It will run:
+- Payroll Server;
+- Payroll Worker;
+- Tx Indexer Worker;
+
+![goland-run.png](readme-static/goland-run.png)
+
 ## 2. Access MinIO
 
 You can verify the buckets were created by visiting the MinIO Console:

docker-compose.yaml

@@ -100,7 +100,7 @@ services:
 volumes:
   db_data:
   redis_data:
-  minio_data: 
+  minio_data:
 networks:
   shared_network:
-    external: true
+    external: true