1. Описание проекта

• 🚀 Быстрая установка: Веб-инсталлятор за 3 шага.
• 💰 Гибкий учет доходов: Поддержка разовых счетов и абонентской платы.
• 📊 Отчетность: Экспорт данных в CSV (Excel) с детализацией по задачам.
• 📱 Адаптивность: Полная поддержка мобильных устройств.
• 🔒 Безопасность: Защита от CSRF-атак, хеширование паролей.

2. Технические требования

• Сервер: Apache/Nginx с поддержкой PHP 7.4+ (рекомендуется 8.0+).
• База данных: MySQL 5.7+ или MariaDB 10.3+.
• Расширения PHP: pdo, pdo_mysql, json, mbstring.
• Права доступа: Папки uploads/ должны иметь права на запись (chmod 777).

3. Установка системы

Шаг 1: Загрузка файлов

Шаг 2: Создание базы данных

1. Зайдите в панель управления хостингом (например, Beget, Reg.ru).
2. Создайте новую базу данных MySQL.
3. Создайте пользователя базы данных и привяжите его к созданной базе.
4. Сохраните данные: Имя БД, Пользователь, Пароль, Хост (обычно localhost).

Шаг 3: Запуск установщика

1. Откройте ваш сайт в браузере.
2. Вас автоматически перенаправит на страницу установки (install.php).
3. Введите данные подключения к базе данных.
4. Придумайте логин и пароль для администратора.
5. Нажмите «Завершить установку».

Важно! После успешной установки обязательно удалите файл install.php с сервера для безопасности.

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

👥 Управление клиентами

• Добавление, редактирование и удаление клиентов.
• Хранение реквизитов (ИНН, Банк, Р/С).
• Два типа оплаты:
  • По задачам: Доход считается по выполненным задачам или выставленным счетам.
  • Абонентская: Фиксированная ежемесячная плата, которая автоматически учитывается в доходе.
• Архивация неактивных клиентов.

✅ Задачи и Заметки

• Привязка задач к конкретному клиенту.
• Отметка выполнения задач (чекбокс).
• Ведение истории заметок по каждому клиенту.

💸 Финансы (Счета и Акты)

• Счета: Выставление счетов с привязкой к выполненным задачам. Статусы: «Отправлен», «Оплачен», «Отменен».
• Акты: Формирование актов выполненных работ за период.
• МойНалог: Возможность сохранять ссылки на чеки из приложения «Мой Налог» прямо в карточке счета/акта.
• Отчеты: Выгрузка реестров счетов и актов в CSV (открывается в Excel) с фильтрацией по датам и клиентам. В отчеты включаются названия задач и ссылки на чеки.

📄 Договоры

• Загрузка сканов договоров (PDF, DOC, JPG) в карточку клиента.
• Быстрый доступ к файлам.

⚙️ Настройки

• Указание названия вашей организации и ИНН (для подстановки в договоры).
• Загрузка логотипа.
• Смена пароля администратора.

Структура проекта:

/public_html
├── api.php             # Основной API-обработчик запросов
├── config.php          # Конфигурация подключения к БД (генерируется при установке)
├── index.php           # Точка входа, маршрутизация страниц
├── install.php         # Скрипт установки (удаляется после настройки)
├── assets/
│   ├── js/
│   │   └── app.js      # Вся клиентская логика (JS)
│   └── css/            # (Стили встроены в header.php для простоты)
├── views/              # Шаблоны страниц
│   ├── header.php      # Шапка сайта и меню
│   ├── footer.php      # Подвал и скрипты
│   ├── dashboard.php   # Главная страница со статистикой
│   ├── clients.php     # Список клиентов
│   ├── client_card.php # Карточка клиента (задачи, счета, акты)
│   ├── finance_report.php # Страница финансовых отчетов
│   ├── settings.php    # Настройки системы
│   └── ...
└── uploads/            # Папка для загруженных файлов
    ├── contracts/      # Договоры
    └── logos/          # Логотипы