Skip to content

Latest commit

 

History

History
93 lines (75 loc) · 9.67 KB

README.ru.md

File metadata and controls

93 lines (75 loc) · 9.67 KB
Raw

JAL (Just Another Ledger)

Контроль и учёт личных финансов.

image

English, Русский

📌 Overview

JAL пригодится тому, кто хочет видеть ясную картину своих персональных доходов, трат, инвестиций, вместе с актуальной информацией о состоянии счетов и стоимости портфеля ценных бумаг.

⭐️ Основные Возможности

Учёт Различных Счетов

  • Ведение учета по счетам в разных валютах с возможностью выбора основной валюты для итоговых сумм.

Типы Транзакций

  • Обычный доход/расход, который может быть разделён на несколько категорий.
  • Перевод ценных бумаг и денежных средств между разными счетами, включая конверсию валюты.
  • Торговые операции: Покупка/Продажа ценных бумаг (акции, ETF, опционы и др.).
  • Дивиденды по акциям и купонные выплаты по облигациям (включая амортизацию облигаций).
  • Корпоративные события для акций.
  • Срочные вклады.

Отчёты

  • История баланса счёта по дням.
  • Состояние портфеля ЦБ на заданную дату.
  • Помесячный отчет доходов/расходов по категориям.
  • Отчет о прибылях/убытках для инвестиций и выплатах по ценным бумагам.
  • Отчет по завершённым сделкам с ценными бумагами.

Обновление Котировок

  • Котировки акций/ETF/крипты, обновляемые основных глобальных бирж.
  • Курсы валют от Европейского и Российского центробанков.

Импорт Брокерских Отчётов

  • Поддержка различных российских и международных брокеров.

Налоговая отчётность

  • Отчет для подготовки налоговой декларации по результатам операций с зарубежными ЦБ для России (инструкция) и Португалии.
  • Оценка предполагаемого налога к уплате для открытой позиции в портфеле.

Экспериментальные функции

  • Загрузка электронных чеков для российских и некоторых европейских магазинов.
  • Распознавание категорий товаров из загруженных электронных чеков с помощью TensorFlow.

📥 Установка

JAL обеспечивает кросс-платформенную совместимость и переносимость. Основные варианты установки:

  1. Из репозитория GitHub:
    • Склонируйте репозиторий с помощью команды git https://github.com/titov-vv/jal.git
    • Убедитесь что у вас установлены Python 3.8.1 или более поздний, а также удовлетворены все зависимости из requirements.txt.
    • Совет пользователей с ОС Windows: Устанавливайте Python с официального сайта и убедитесь что выбраны опции установки pip и добавить Python в переменные окружения. Перезагрузитесь после установки.
    • Используйте команду run.py для запуска приложения.
  2. Используя pip:
    • Установите JAL с помощью команды pip install jal.
    • Запустите командой jal или python -m jal.jal (место создания скрипта зависит от операционной системы. Например, на Linux это может быть ~/.local/run, на Windows - подкаталог Scripts каталога, где установлен python или каталог Appdata/Roaming/Python/.../Scripts/ в профиле пользователя.)
    • Совет пользователей с ОС Windows: вам нужно запустить командную строку, чтобы выполнить команду, указанную выше.
  3. Смешанная установка:
    • Скачайте исходные файлы и запустите setup.py удобным для вас способом.

База данных программы будет инициализирована автоматически минимально необходимым набором данных и вы сможете начать использовать приложение.

Для смены языка с Английского на Русский нужно выбрать пункт меню Languages->Russian и перезапустить программу

🔧 Конфигурация

JAL хранит все параметры конфигурации в файле jal.sqlite вместе со всеми остальными данными, который по умолчанию создаётся в каталоге jal. Но вы можете изменить расположение этого файла при помощи параметра database_path в jal.ini, расположенном в каталоге, где операционная система хранит конфигурационные файлы (например, $HOME/.config на большинстве Unix-подобных систем). Пример такого файла:

[main]
database_path=/home/user/some_folder

❗️ Обновление

Если вы установили программу с помощью pip, то обновить на новую версию можно при помощи команды pip install jal -U.

🖭 Резевные копии

Вы можете сохранить и восставновить свои данные используя пункты меню Данные->Бэкап и Данные->Восставновление. Но можно получить такой же результат просто сохранив файл jal.sqlite который содержит все даныне. Расположение файла, который использует jal можно увидеть в меню О программе.

📈 Налоговый отчет по операциям с иностранными ценными бумагами

Налоговый отчёт может быть подготовлен по операциям любого брокера, если они присутствуют в программе. На данный момент поддерживаются налоговые отчёты для России и Португалии.
Операции могут быть загружены из отчёта брокера - список поддерживаемых брокеров можно увидеть в меню Импорт->Отчёт.
Пошаговая инструкция по подготовке данных для российской декларации 3-НДФЛ на основе отчета Interactive Brokers расположена на отдельной странице. По вопросам поддержки отчётов можно связаться через контакты указанные в начале этой страницы.

📞 Поддержка, обратная связь

Если вы хотите задать вопрос, сообщить о проблеме, помочь или поддержать автора - это можно сделать через email jal@gmx.ru или в Telegram (создание Issues на GitHub тоже приветствуется).

❤️ Спасибки!

Я бы хотел упомянуть людей, кто помогал мне в 2022-м и 2023-м годах, т.к. я получил больше пожертвований, помощи и отзывов от пользователей в этом году. И хотя я не могу назвать их всех по именам, я подтверждаю свою искреннюю признательность за их помощь. Они сделали проект лучше!

FAQ (часто задаваемые вопросы)

Описание сообщений об ошибках