FinTracker — программа для учёта и анализа личных финансов. Вы загружаете выписки, просматриваете транзакции и смотрите аналитику по категориям, тегам и периодам.
Важно: FinTracker работает только на вашем компьютере. Данные хранятся у вас, в отдельной базе на вашем ПК. Для входа в программу пароль не нужен — не открывайте её в интернет без защиты.
- Скачайте: Docker Desktop для Windows
- Установите и перезагрузите компьютер, если программа попросит.
- Запустите Docker Desktop и дождитесь статуса Engine running (внизу окна).
Самый простой способ — архив релиза (не нужен Git):
- Откройте страницу релизов.
- Выберите последнюю версию (например v0.0.3).
- В разделе Assets скачайте Source code (zip).
- Распакуйте архив в
C:\FinTracker-0.0.3(номер версии — как в скачанном релизе).
- Откройте папку с FinTracker.
- Дважды щёлкните
start.bat.
Скрипт сам создаст файл настроек .env, запустит программу и откроет сайт в браузере:
Первый запуск может занять 5–15 минут — это нормально.
| Действие | Что делать |
|---|---|
| Запустить | Docker Desktop должен быть включён → двойной щелчок start.bat |
| Остановить | Двойной щелчок stop.bat |
| Снова открыть сайт | http://localhost:8080 |
Данные (транзакции, категории) не удаляются при остановке.
- Скачайте новый релиз с GitHub Releases.
- Распакуйте в новую папку (или замените файлы, кроме
.env— там ваши настройки). - В файле
.envукажите версию, например:FINTRACKER_VERSION=v0.0.3 - Запустите
start.bat.
Подробнее: docs/releases.md
| Проблема | Решение |
|---|---|
start.bat сразу закрывается или пишет ошибку |
Убедитесь, что Docker Desktop запущен. Запустите start.bat ещё раз и прочитайте текст в окне. |
unauthorized при скачивании образов |
Запустите в PowerShell: .\scripts\start.ps1 -Build (сборка на вашем ПК, без скачивания с GitHub). |
| Сайт не открывается | Подождите 1–2 минуты после запуска. Проверьте http://localhost:8080 вручную. |
| Порт 8080 занят | Откройте .env, измените FRONTEND_PORT=8081, сохраните, запустите start.bat снова. Открывайте http://localhost:8081 |
| Нужно всё сбросить и начать заново | См. раздел «Полный сброс» в docs/docker-for-beginners.md |
Пошаговая инструкция с картинками действий: docs/docker-for-beginners.md
Файл .env лежит в папке FinTracker. Создаётся автоматически при первом запуске. Основные параметры:
| Параметр | Зачем нужен | Пример |
|---|---|---|
DB_PASSWORD |
Пароль вашей локальной базы данных | Придумайте свой надёжный пароль |
FRONTEND_PORT |
Порт сайта в браузере | 8080 |
API_PORT |
Порт API (обычно менять не нужно) | 5009 |
FINTRACKER_VERSION |
Версия программы из релиза | v0.0.3 или latest |
DEPLOY_MODE |
local — ПК, server — сервер с доменом |
local |
Шаблон: docker/.env.example (копируется в .env при первом запуске)
Публикация на сервере (push в GitLab → runner → docker-host): docs/deployment-server.md
| Папка / файл | Назначение |
|---|---|
start.bat, stop.bat |
Запуск и остановка одним щелчком |
docker/ |
Настройки Docker (обычно не трогать) |
scripts/ |
Скрипты запуска для PowerShell |
FinTracker.Frontend |
Интерфейс (страницы в браузере) |
FinTracker.Backend |
Серверная часть и логика |
docs |
Документация |
База данных PostgreSQL скачивается отдельно при первом запуске — она не «внутри» программы, а работает рядом в Docker.
- Запуск с нуля (подробно) — пошагово, без опыта программирования
- Релизы и версии — как выбрать и обновить версию
- Справка по Docker — если нужны команды вручную
- Запуск на сервере — Docker VM, GitLab CI, домен и HTTPS
- Синхронизация субрепозиториев
- Аналитика — описание модулей и требований