💰 PayrollHelper

Бухгалтерское приложение для управления сотрудниками, выплатами и налогами.

---

📋 Оглавление

• 🚀 Возможности
• 🛠️ Технологии и требования
• ⚙️ Установка
• 🗄️ Настройка базы данных
• 🏃 Запуск приложения
• 👥 Пользователи по умолчанию
• 📸 Скриншоты
• 📄 Лицензия
• ⭐ Поддержка

---

🚀 Возможности

• 🔐 Авторизация — вход по логину/паролю с хэшированием SHA256
• 👥 Управление сотрудниками — добавление, просмотр, редактирование
• 💰 Выплаты — начисление зарплаты, премий, специальных сумм
• 📑 Управление налогами — добавление и настройка налогов
• 🧾 Управление выплатами — создание типов выплат с привязкой налогов
• 🪑 Должности — управление должностями и статусами (активна/неактивна)
• 🛠️ Редактирование БД — полный доступ к таблицам (только для админа)
• 📊 Генерация отчётов — выбор типа, периода, формата (.txt / .csv)
• ✅ Валидация данных — подсветка ошибок, защита от некорректного ввода

---

🛠️ Технологии и требования

Компонент	Технология / Требование	Версия
Платформа	.NET	6.0
Язык	C#	12.0
Графический интерфейс	WinForms	.NET 6.0
ORM	Entity Framework Core	6.0
База данных	PostgreSQL	18
Тестирование	xUnit	2.4.1
ОС	Windows	10 / 11

---

⚙️ Установка

1. Клонирование репозитория

git clone https://github.com/RamenOfficialGovPatsy/PayrollHelper.git
cd PayrollHelper

2. Установка .NET 6.0

Скачайте и установите .NET 6.0 SDK (не только Runtime).

⚠️ Важно: Приложение требует .NET SDK версии 6.0. Если у вас установлена более новая версия SDK, проект всё равно будет собираться с версией 6.0 благодаря файлу global.json в корне репозитория.

3. Установка PostgreSQL 18

Скачайте и установите PostgreSQL 18

---

🗄️ Настройка базы данных

1. Создание пользователя и базы данных

Подключитесь к PostgreSQL и выполните:

CREATE USER payroll_user WITH PASSWORD '123';
CREATE DATABASE payroll_db OWNER payroll_user ENCODING 'UTF8';
GRANT ALL PRIVILEGES ON DATABASE payroll_db TO payroll_user;

2. Создание таблиц

Выполните скрипты из папки Docs/DatabaseScripts/ в следующем порядке:

Файл	Описание
1_create_tables.sql	Создание таблиц с ограничениями
2_add_foreign_keys.sql	Добавление внешних ключей
3_insert_all_data.sql	Заполнение начальными данными

💡 Примечание: Скрипт 4_drop_all_tables.sql предназначен для полного удаления всех таблиц (используется при пересоздании базы данных).

3. Проверка подключения

psql -U payroll_user -d payroll_db

---

🏃 Запуск приложения

Через Visual Studio

1. Откройте PayrollHelper.slnx
2. Установите PayrollHelper как стартовый проект
3. Нажмите F5 или Ctrl+F5

Через командную строку

cd PayrollHelper
dotnet build -c Release
dotnet run --project PayrollHelper

---

👥 Пользователи по умолчанию

Логин	Пароль	Роль
admin	admin	Администратор
CEO	CEO123	Администратор
user	user	Пользователь

💡 Примечание: После первого запуска файл users.json создаётся автоматически в папке с приложением. Новых пользователей можно добавить через форму "Создать пользователя".

---

📸 Скриншоты

1. Форма авторизации

2. Создание пользователя

3. Главное меню

4. Вкладка выплат

5. Вкладка добавления сотрудника

6. Вкладка должностей

7. Управление налогами

8. Управление типами выплат

9. Аналитика — динамика выплат (месяц)

10. Аналитика — динамика выплат (квартал)

11. Аналитика — динамика выплат (год)

12. Аналитика — распределение по типам

13. Аналитика — топ сотрудников

14. Редактирование базы данных

15. Информация о сотруднике

16. Формирование отчётов

17. Схема базы данных

18. Архитектура проекта

---

📄 Лицензия

Проект распространяется под лицензией MIT. Подробнее в файле LICENSE.

---

⭐ Поддержка

Если проект оказался полезным, поставьте звезду — это лучший способ сказать «спасибо» и помогает проекту находить новых пользователей.