Релиз 2024.2

.github/workflows/publish-docker.yml

@@ -14,11 +14,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up JDK
-        uses: actions/setup-java@v3
+        uses: actions/setup-java@v4
         with:
-          java-version: '21'
+          java-version: '23'
           distribution: 'liberica'
           cache: maven
       - name: Publish

.github/workflows/unit-tests.yml

@@ -0,0 +1,47 @@
+name: Unit Tests
+
+on:
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - 'master'
+      - 'develop'
+  push:
+    branches:
+      - 'master'
+      - 'develop'
+
+jobs:
+  tests:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK
+        uses: actions/setup-java@v4
+        with:
+          java-version: '23'
+          distribution: 'liberica'
+          cache: maven
+
+      - name: Maven Tests
+        run: mvn --batch-mode clean test
+
+      - name: Test Coverage
+        uses: codecov/codecov-action@v4
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+      - name: SonarCloud Analyze
+        run: >
+          mvn --batch-mode sonar:sonar
+          -Dsonar.projectKey=spacious-team_investbook
+          -Dsonar.organization=spacious-team
+          -Dsonar.host.url=https://sonarcloud.io
+          -Dsonar.login=$SONAR_TOKEN
+          -Dsonar.coverage.jacoco.xmlReportPaths=./target/site/jacoco/jacoco.xml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

.mvn/wrapper/maven-wrapper.properties

@@ -14,5 +14,6 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.1/apache-maven-3.8.1-bin.zip
-wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar
+wrapperVersion=3.3.2
+distributionType=only-script
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.8/apache-maven-3.9.8-bin.zip

README.md

@@ -1,7 +1,12 @@
-[![java-version](https://img.shields.io/badge/java-21-brightgreen?style=flat-square)](https://openjdk.org/)
-[![spring-boot-version](https://img.shields.io/badge/spring--boot-3.0.7-brightgreen?style=flat-square)](https://github.com/spring-projects/spring-boot/releases)
+[<img src="https://github.com/spacious-team/investbook/assets/11336712/7b16c124-5230-403e-8df9-7652132e76dd" align="right"/>](README-en.md)
+[<img src="https://github.com/spacious-team/investbook/assets/11336712/14847ff5-827e-4d0f-a4e9-882cb0d1397c" align="right"/>](README.md)<br/>
+
+[![java-version](https://img.shields.io/badge/java-23-brightgreen?style=flat-square)](https://openjdk.org/)
+[![spring-boot-version](https://img.shields.io/badge/spring--boot-3.3.5-brightgreen?style=flat-square)](https://github.com/spring-projects/spring-boot/releases)
 [![hits-of-code](https://img.shields.io/badge/dynamic/json?style=flat-square&color=lightblue&label=hits-of-code&url=https://hitsofcode.com/github/spacious-team/investbook/json?branch=develop&query=$.count)](https://hitsofcode.com/github/spacious-team/investbook/view?branch=develop)
 [![github-closed-pull-requests](https://img.shields.io/github/issues-pr-closed/spacious-team/investbook?style=flat-square&color=brightgreen)](https://github.com/spacious-team/investbook/pulls?q=is%3Apr+is%3Aclosed)
+[![Unit tests](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fspacious-team%2Finvestbook%2Fbadge%3Fref%3Ddevelop&style=flat-square&label=test&logo=none)](
+https://github.com/spacious-team/investbook/actions/workflows/unit-tests.yml)
 [![github-workflow-status](https://img.shields.io/github/actions/workflow/status/spacious-team/investbook/publish-docker.yml?style=flat-square&branch=master)](https://github.com/spacious-team/investbook/actions/workflows/publish-docker.yml)
 [![github-all-releases](https://img.shields.io/github/downloads/spacious-team/investbook/total?style=flat-square&logo=github&color=lightblue)](https://github.com/spacious-team/investbook/releases/latest)
 [![docker-pulls](https://img.shields.io/docker/pulls/spaciousteam/investbook?style=flat-square&logo=docker&color=lightblue&logoColor=white)](https://hub.docker.com/r/spaciousteam/investbook)
@@ -156,16 +161,15 @@ Investbook также может быть запущен в [docker](docs/run-by
 будет открыт в сети интернет).
 
 ### Почему код приложения открыт
-Идея открытого исходного кода (open source) заключается в свободе разработки и использования программного обеспечения.
-Многие известные бренды используют open source, например [Instagram](https://github.com/Instagram),
+Для некоторых сфер решения с открытым исходным кодом подходят лучше других, например в сферах финансов и шифрования данных,
+т.к. этим решениям можно доверять вследствие того, что вы или любой другой желающий может посмотреть код и убедиться
+в безопасности программы. Многие известные бренды используют open source, например [Instagram](https://github.com/Instagram),
 [Android](https://ru.wikipedia.org/wiki/Android#%D0%98%D1%81%D1%85%D0%BE%D0%B4%D0%BD%D1%8B%D0%B9_%D0%BA%D0%BE%D0%B4),
 [Telegram](https://ru.wikipedia.org/wiki/Telegram), [Twitter](https://opensource.twitter.dev/),
 [Google Chrome](https://ru.wikipedia.org/wiki/Google_Chrome),
 [Mozilla Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Source_Code/Downloading_Source_Archives),
 сайты с защищенным соединением [https](https://ru.wikipedia.org/wiki/OpenSSL), такие как https://vk.com и др.
-Для некоторых сфер решения с открытым исходным кодом подходят лучше других, например в сферах финансов и шифрования данных,
-т.к. этим решениям можно доверять вследствие того, что вы или любой другой желающий может посмотреть код и убедиться
-в безопасности программы.
+Идея открытого исходного кода (open source) заключается в свободе разработки и использования программного обеспечения.
 
 <details>
 <summary>Мнение Илона Маска об открытом исходном коде.</summary>

checkerframework.astub

@@ -0,0 +1,76 @@
+/*
+ * InvestBook
+ * Copyright (C) 2024  Spacious Team <[email protected]>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import org.checkerframework.checker.nullness.qual.Nullable;
+import org.checkerframework.checker.nullness.qual.EnsuresNonNull;
+import org.checkerframework.checker.nullness.qual.EnsuresNonNullIf;
+
+package java.util;
+public class Objects {
+
+    @EnsuresNonNull("#1")
+    static <T> T requireNonNull(@Nullable T obj);
+
+    @EnsuresNonNull("#1")
+    static <T> T requireNonNull(@Nullable T obj, String message);
+
+    @EnsuresNonNull("#1")
+    static <T> T requireNonNull(@Nullable T obj, Supplier<String> messageSupplier);
+
+    @EnsuresNonNullIf(expression="#1", result=true)
+    static boolean nonNull(@Nullable Object obj);
+
+    @EnsuresNonNullIf(expression="#1", result=false)
+    static boolean isNull(@Nullable Object obj);
+}
+
+
+package org.springframework.util;
+class StringUtils {
+
+    @EnsuresNonNullIf(expression="#1", result=true)
+    static boolean hasText(@Nullable CharSequence str);
+
+    @EnsuresNonNullIf(expression="#1", result=true)
+    static boolean hasText(@Nullable String str);
+
+    @EnsuresNonNullIf(expression="#1", result=true)
+    static boolean hasLength(@Nullable CharSequence str);
+
+    @EnsuresNonNullIf(expression="#1", result=true)
+    static boolean hasLength(@Nullable String str);
+}
+
+
+package org.springframework.util;
+class CollectionUtils {
+
+    @EnsuresNonNullIf(expression="#1", result=false)
+    static boolean isEmpty(@Nullable Collection<?> collection);
+
+    @EnsuresNonNullIf(expression="#1", result=false)
+    static boolean isEmpty(@Nullable Map<?, ?> map);
+}
+
+
+package org.slf4j;
+interface Logger {
+
+    void warn(String format, @Nullable Object arg1, @Nullable Object arg2);
+
+    void warn(String format, @Nullable Object... arguments);
+}

codecov.yml

@@ -0,0 +1,9 @@
+# https://docs.codecov.com/docs/codecov-yaml
+coverage:
+  status:
+    project:
+      default:
+        threshold: 5%  # allows to drop coverage (https://docs.codecov.com/docs/commit-status#project-status)
+    patch:
+      default:
+        target: 0%  # allows no tests in PR (https://docs.codecov.com/docs/commit-status#patch-status)

docs/developer-guide.md

@@ -19,16 +19,25 @@ git clone https://github.com/spacious-team/investbook.git
 
 ### Установка Wix
 Для сборки пакета для установки Investbook требуется Wix 3.
-Скачать Wix 3 можно по ссылке с официального сайта [Wix](https://wixtoolset.org/docs/wix3/)
+Скачать Wix 3 можно по ссылке с официального сайта [Wix3](https://wixtoolset.org/docs/wix3/)
 (пакет для установки расположен на [GitHub](https://github.com/wixtoolset/wix3/releases)).
 Wix в свою очередь потребует установки [.NET](https://dotnet.microsoft.com/en-us/download/dotnet).
 
+На Windows вы можете установить Wix и .NET в `%LOCALAPPDATA%\Programs\wix3` и `%LOCALAPPDATA%\Programs\dotnet`
+соответственно. Для этого на страницах проектов нужно скачать не msi установщики, а архивы "binaries", которые требуется
+распаковать в указанные папки. После этого нужно добавить следующие переменные окружения
+(win+R -> `rundll32 sysdm.cpl,EditEnvironmentVariables`):
+```shell
+DOTNET_ROOT=%LOCALAPPDATA%\Programs\dotnet
+PATH=<предыдущие значения>;%LOCALAPPDATA%\Programs\wix3;%DOTNET_ROOT%
+```
+
 ### Компиляция
 Компиляция запускается командой:
 ```
 mvn clean compile
 ```
-Она очищает сгенерированные ранее классы (типа JAXB), которые возможно устарели,
+Она очищает сгенерированные ранее классы (например JAXB2), которые возможно устарели,
 и генерирует файл `META_INF/build-info.properties`, который используется приложением в своей работе.
 
 ### Запуск

docs/install-on-linux.md

@@ -1,6 +1,6 @@
 #### Оглавление
-- [Установка на Windows x64](install-on-windows.md)
-- [Установка на Windows x86](install-on-windows-by-zip.md)
+- [Установка на Windows](#установка-и-работа-на-windows)
+- [Установка на Windows из ZIP архива](install-on-windows-by-zip.md)
 - [Установка на Mac](#установка-и-работа-на-mac-и-linux)
 - [Установка на Linux](#установка-и-работа-на-mac-и-linux)
 - [Запуск в Docker](run-by-docker.md)
@@ -12,16 +12,16 @@
    ```shell script
    $ java -version
    ```
-   Если версия 21 или выше, пропустите следующий пункт.
+   Если версия 23 или выше, пропустите следующий пункт.
 2. Воспользуйтесь менеджером пакетов вашей ОС для установки java, например на Ubuntu
    ```shell
-   $ sudo apt install openjdk-21-jre-headless
+   $ sudo apt update
+   $ sudo apt install openjdk-23-jre-headless
    ```
-   Или можно скачать [Java 21](https://jdk.java.net/21/) и распаковать папку `jdk-21` в директорию `/opt`.
-   Для 32 разрядных ОС можно скачать [Java 21 x86 JRE](https://bell-sw.com/pages/downloads/). Если java распакована из
+   Или можно скачать [Java 23](https://jdk.java.net/23/) и распаковать папку `jdk-23` в директорию `/opt`. Если java распакована из
    архива, то в директории приложения нужно найти файл `start.sh`, раскомментировать и актуализировать `JAVA_HOME`
    ```shell
-   $ export JAVA_HOME=/opt/jdk-21
+   $ export JAVA_HOME=/opt/jdk-23
    ```
 3. Скачать со страницы [проекта](https://github.com/spacious-team/investbook/releases/latest) архив `.zip` и
    распаковать в директорию `/opt`.
@@ -55,6 +55,7 @@
 | с 2022.7                  | java 18 и выше        | 
 | с 2023.1                  | java 20 и выше        |
 | с 2023.3                  | java 21 и выше        |
+| с 2024.2                  | java 23 и выше        |
 
 #### Установка расширений
 

docs/install-on-windows-by-zip.md

@@ -1,21 +1,18 @@
 #### Оглавление
-- [Установка на Windows x64](install-on-windows.md)
-- [Установка на Windows x86](#установка-и-работа-на-windows-из-zip-архива)
+- [Установка на Windows](#установка-и-работа-на-windows)
+- [Установка на Windows из ZIP архива](install-on-windows-by-zip.md)
 - [Установка на Mac](install-on-linux.md)
 - [Установка на Linux](install-on-linux.md)
 - [Запуск в Docker](run-by-docker.md)
 
 ### Установка и работа на Windows из zip архива
 
-Данная инструкция поддерживает все версии Windows. Если у вас 64 битная Windows, рекомендуем устанавливать по
-[инструкции](install-on-windows.md).
-1. Создать папку `C:\Program Files\Java\`, скачать Java 21 под вашу версию операционной системы.
-   Если у вас 32 битная Windows можете использовать скачать по [ссылке](https://libericajdk.ru/pages/downloads/)
-   (достаточно JRE сборки), если 64 битная - рекомендуется скачивать сборку [OpenJdk](https://jdk.java.net/21/).
-1. Скачать со страницы [проекта](https://github.com/vananiev/portfolio/releases/latest) архив `investbook.zip`
+Данная инструкция поддерживает версию Windows x64. 32 битные Windows не поддерживаются.
+1. Создать папку `C:\Program Files\Java\`, скачать [Java 23](https://jdk.java.net/23/).
+1. Скачать со страницы [проекта](https://github.com/spacious-team/investbook/releases/latest) архив `investbook.zip`
    и распаковать в любую удобную папку. В ней открыть файл `start.bat` и изменить строчку
    ```
-   #set JAVA_HOME=C:\Program Files\Java\jdk-21
+   #set JAVA_HOME=C:\Program Files\Java\jdk-23
    ```
    следующим образом: 
    + Убрать первый символ `#`.

docs/install-on-windows.md

@@ -1,14 +1,13 @@
 #### Оглавление
-- [Установка на Windows x64](#установка-и-работа-на-windows)
-- [Установка на Windows x86](install-on-windows-by-zip.md)
+- [Установка на Windows](#установка-и-работа-на-windows)
+- [Установка на Windows из ZIP архива](install-on-windows-by-zip.md)
 - [Установка на Mac](install-on-linux.md)
 - [Установка на Linux](install-on-linux.md)
 - [Запуск в Docker](run-by-docker.md)
 
 ### Установка и работа на Windows
 
-Данная инструкция поддерживает версию Windows x64. Если у вас 32 битная Windows, рекомендуем устанавливать по
-[инструкции](install-on-windows-by-zip.md).
+Данная инструкция поддерживает версию Windows x64. 32 битные Windows не поддерживаются.
 1. Скачать со страницы [проекта](https://github.com/spacious-team/investbook/releases/latest) установщик `.msi`
    и запустить его.
 1. Если вы обновляете приложение и в процессе обновления появилось показанное ниже окно - это означает, что запущена 

docs/run-by-docker.md

@@ -1,6 +1,6 @@
 #### Оглавление
-- [Установка на Windows x64](install-on-windows.md)
-- [Установка на Windows x86](install-on-windows-by-zip.md)
+- [Установка на Windows](#установка-и-работа-на-windows)
+- [Установка на Windows из ZIP архива](install-on-windows-by-zip.md)
 - [Установка на Mac](install-on-linux.md)
 - [Установка на Linux](install-on-linux.md)
 - [Запуск в Docker](#запуск-investbook)