Инструкция по установке
Пошаговое руководство по установке и настройке приложения для учета семейных финансов
Версия PHP должна быть не ниже 7.4
База данных для хранения информации
Apache или Nginx
Обязательно для работы PWA
Создайте базу данных и импортируйте схему
mysql -u root -p
CREATE DATABASE finance_app CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'finance_user'@'localhost' IDENTIFIED BY 'ваш_пароль';
GRANT ALL PRIVILEGES ON finance_app.* TO 'finance_user'@'localhost';
FLUSH PRIVILEGES;
USE finance_app;
SOURCE /path/to/database.sql;Через phpMyAdmin:
finance_appdatabase.sqlОткройте файл config.php и измените настройки базы данных
define('DB_HOST', 'localhost');
define('DB_NAME', 'finance_app');
define('DB_USER', 'finance_user'); // или 'root'
define('DB_PASS', 'ваш_пароль');Для работы PWA необходимы иконки приложения
create_icons.html в браузереpwa/ как icon-192.png и icon-512.pngpwa/Для работы ИИ-анализа необходимо настроить API ключ
config.php:define('AI_API_KEY', 'ваш_api_ключ');Установите правильные права доступа к файлам
chmod 644 *.php
chmod 644 api/*.php
chmod 755 assets/js/app.js
chmod 644 pwa/*.js
chmod 644 pwa/*.json
chmod 644 pwa/*.pngПроверьте, что все работает корректно
http://ваш-домен/index.php в браузереadminadminВажно!
Не забудьте сменить пароль администратора после первой авторизации!
Измените пароль администратора на безопасный
php generate_password.php
# Введите новый пароль
# Скопируйте SQL запрос и выполните в MySQL<?php
echo password_hash('новый_пароль', PASSWORD_DEFAULT);
// Скопируйте результат и выполните:
// UPDATE users SET password = 'хэш' WHERE login = 'admin';Убедитесь, что включен mod_rewrite:
sudo a2enmod rewrite
sudo systemctl restart apache2Добавьте в конфигурацию сайта:
server {
listen 80;
server_name ваш-домен.ru;
root /var/www/finance-app;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
location ~ /\. {
deny all;
}
}PWA требует HTTPS для работы. Настройте SSL сертификат:
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d ваш-домен.ruПосле настройки HTTPS вы можете установить приложение на свое устройство как нативное приложение.
Меню (⋮) → Установить "Семейный бюджет"Меню (⋯) → Приложения → Установить этот сайт как приложениеУстановить или Добавить на главный экранФайл → Добавить на экран "Домой"Добавить на главный экранДобавить на главный экранСовет:
После установки приложение будет работать в полноэкранном режиме без адресной строки браузера.
На экран "Домой"Важно для iOS:
Работает как приложение
Открывается в отдельном окне без адресной строки
Оффлайн-режим
Работает без интернета (с ограничениями)
Быстрая загрузка
Кеширование для мгновенного запуска
Уведомления
Поддержка push-уведомлений (если настроено)
Экономия трафика
Кеширование ресурсов снижает потребление данных
Автообновление
Приложение обновляется автоматически
Не появляется кнопка установки:
manifest.json и sw.jsПриложение не устанавливается:
manifest.json валиденПриложение не работает оффлайн:
config.phpmanifest.json и sw.jsconfig.php