Merge pull request #544 from spacious-team/develop

Релиз 2023.1

.github/workflows/publish-docker.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Set up JDK
         uses: actions/setup-java@v3
         with:
-          java-version: '18'
+          java-version: '20'
           distribution: 'liberica'
           cache: maven
       - name: Publish

.mvn/wrapper/maven-wrapper.properties

@@ -1,2 +1,18 @@
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.5/apache-maven-3.8.5-bin.zip
-wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# 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

README.md

@@ -1,12 +1,13 @@
-![java-version](https://img.shields.io/badge/java-18-brightgreen?style=flat-square)
-![spring-boot-version](https://img.shields.io/badge/spring--boot-2.7.4-brightgreen?style=flat-square)
+[![java-version](https://img.shields.io/badge/java-20-brightgreen?style=flat-square)](https://openjdk.org/)
+[![spring-boot-version](https://img.shields.io/badge/spring--boot-3.0.6-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)
 ![github-workflow-status](https://img.shields.io/github/actions/workflow/status/spacious-team/investbook/publish-docker.yml?style=flat-square&branch=master)
 [![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)
 [![telegram-channel](https://img.shields.io/endpoint?style=flat-square&color=2ca5e0&label=news&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Finvestbook_official)](https://t.me/investbook_official)
 [![telegram-group](https://img.shields.io/endpoint?style=flat-square&color=2ca5e0&label=chat&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Finvestbook_support)](https://t.me/investbook_support)
+[![telegram-support](https://img.shields.io/badge/support-online-2ca5e0?style=flat-square&logo=telegram)](https://t.me/investbook_support_bot)
 
 <img src="https://user-images.githubusercontent.com/11336712/85948992-b1d6de00-b95c-11ea-8edc-4d5e7dfc8210.png" width="100%"/>
 
@@ -158,13 +159,29 @@ Investbook также может быть запущен в [docker](docs/run-by
 Идея открытого исходного кода (open source) заключается в свободе разработки и использования программного обеспечения.
 Многие известные бренды используют 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), [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),
+[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 и др.
 Для некоторых сфер решения с открытым исходным кодом подходят лучше других, например в сферах финансов и шифрования данных,
 т.к. этим решениям можно доверять вследствие того, что вы или любой другой желающий может посмотреть код и убедиться
 в безопасности программы.
 
+<details>
+<summary>Мнение Илона Маска об открытом исходном коде.</summary>
+
+> Мы будем публиковать больше исходного кода и выставлять на общественное обозрение. И конечно его также будут критиковать,
+люди помогут обнаружить все глупости в коде. А мы быстро исправим их, и сделаем это при полном общественном контроле.
+Я думаю, что такой подход позволит добиться доверия общественности. Потому что здесь не нужно верить на слово,
+можно своими глазами прочитать код, и то, что люди говорят про этот код. И можно увидеть улучшения, которые мы вносим.
+За всем процессом можно наблюдать в режиме реального времени, видеть все улучшения. Я бы удивился,
+если бы после этого общество не подумало: "Ого, кажется, это то, чему можно доверять!" Ну правда, эта история
+должна вызывать куда больше доверия, чем другие со всеми их черными ящиками и отказом показать подноготную.
+Что вы пытаетесь скрыть? Явно не что-то хорошее. Если вам нечего скрывать, почему не показать это?
+>
+> [_Интервью 2023 г_](https://www.youtube.com/watch?v=bOznEZAjX3I&t=5138s)
+</details>
+
 ### Как помочь
 Помочь можно, расширяя или корректируя [документацию](https://github.com/spacious-team/investbook/files/5398264/github.docx),
 [сообщая](https://github.com/spacious-team/investbook/issues/new/choose) о проблемах в работе приложения,
@@ -173,12 +190,13 @@ Investbook также может быть запущен в [docker](docs/run-by
 
 Также существует функционал [расширений](/docs/extension-developer-guide.md), который позволяет сторонним разработчикам
 расширить список поддерживаемых "из коробки" [брокеров](#брокеры). Расширения могут быть подключены по желанию пользователей
-к приложению. Сторонние разработчики могут распространять расширения бесплатно или платно. Поэтому разработчики,
-преследуя даже разные цели ([финансовые](https://youtu.be/q4O6PX0ZuFU) или альтруистические), работают сообща. Если вы
-решили улучшать приложение в этом репозитории, ознакомьтесь, пожалуйста, со следующей [информацией](docs/CONTRIBUTING.md).
+к приложению. Сторонние разработчики могут распространять расширения бесплатно или [платно](https://youtu.be/q4O6PX0ZuFU),
+поэтому разработчики, преследуя даже разные цели, работают сообща. Если вы решили улучшать приложение в этом репозитории, 
+ознакомьтесь, пожалуйста, со следующей [информацией](docs/CONTRIBUTING.md).
 
 ### Контакты
-- Телеграм [канал](https://t.me/investbook_official) и чат [технической поддержки](https://t.me/investbook_support);
+- Телеграм [канал](https://t.me/investbook_official), техническая [поддержка](https://t.me/investbook_support_bot)
+  и [чат](https://t.me/investbook_support) пользователей;
 - Обсуждение на форуме [banki.ru](https://www.banki.ru/forum/?PAGE_NAME=read&FID=21&TID=380178);
 - Страница приложения на [smart-lab.ru](https://smart-lab.ru/trading-software/Investbook) и
   [страница для связи](https://smart-lab.ru/profile/SpaciousTeam);  

docs/dbms-changing.md

@@ -1,10 +1,12 @@
 ## Смена СУБД
-Приложение по умолчанию использует СУБД H2 и сохраняет данные в файл `investbook.mv.db` в каталоге `investbook` домашней
-директории пользователя. Если у вас недостаточно опыта или нет желания перейти на другую СУБД, пропустите этот раздел.
+Приложение по умолчанию использует СУБД H2 и сохраняет данные в файл `investbook2.mv.db` в каталоге `investbook` домашней
+директории пользователя. Смена СУБД может потребовать от вас в дальнейшем самостоятельной миграции данных между версиями.
+Например, обновление с версии 2022.9.1 до 2023.1 поддерживает миграцию данных только для СУБД H2.
+Если вы разработчик, то вы можете использовать СУБД, отличное от H2, для более удобной отладки с данными.
+Если у вас недостаточно опыта, то рекомендуется пропустить этот раздел.
 
-Возможен переход на [MariaDB](https://downloads.mariadb.org/)
-([ссылка](https://downloads.mariadb.org/interstitial/mariadb-10.4.12/win32-packages/mariadb-10.4.12-win32.msi/from/http%3A//mariadb.melbourneitmirror.net/)
-на дистрибутив для Windows). После установки в файле `application-conf.properties` необходимо прописать
+Возможен переход на [MariaDB](https://downloads.mariadb.org/).
+После установки в файле `application-conf.properties` необходимо прописать
 ```
 spring.profiles.active=core,mariadb,conf
 ```

docs/developer-guide.md

@@ -1,6 +1,3 @@
-![java-version](https://img.shields.io/badge/java-18-brightgreen?style=flat-square)
-![spring-boot-version](https://img.shields.io/badge/spring--boot-2.7.4-brightgreen?style=flat-square)
-
 ### Инструкция для начинающих
 Если вы начинающий разработчик воспользуйтесь этой [инструкцией](https://github.com/spacious-team/investbook/files/5398264/github.docx).
 Если вы намерены изменить документацию, то эта инструкция самодостаточна, поэтому остальные пункты на этой странице
@@ -15,12 +12,18 @@ git clone https://github.com/spacious-team/investbook.git
 Если вы используете [IntelliJ IDEA](https://www.jetbrains.com/ru-ru/idea/download), файлы настроек среды разработки
 уже сохранены в репозиторий, просто импортируйте код как maven проект.
 
+### Установка java
+Для разработки требуется версия java, которая указана в файле [pom.xml](../pom.xml) в теге `<java.version>`.
+Скачайте java под свою ОС, например с сайта [OpenJDK](https://openjdk.org/install/), и установите переменные
+окружения `JAVA_HOME` и `PATH`, например для Windows 10 по этой [инструкции](https://csharpcoderr.com/5351/).
+
 ### Компиляция
 Компиляция запускается командой:
 ```
-mvn compile
+mvn clean compile
 ```
-Она генерирует файл `META_INF/build-info.properties`, который используется приложением в своей работе.
+Она очищает сгенерированные ранее классы (типа JAXB), которые возможно устарели,
+и генерирует файл `META_INF/build-info.properties`, который используется приложением в своей работе.
 
 ### Запуск
 Перед запуском приложения средствами IntelliJ IDEA обязательна [компиляция](#компиляция), после которой можно