📦 Shipify

Уеб приложение за управление на доставки за електронен магазин

---

📝 Описание

Цел:

• Оптимизиране на процеса по създаване, проследяване и управление на пратки за онлайн магазини.

Основни предимства:

• Създаване и проследяване на поръчки
• Интеграция с куриерски услуги (Еконт)
• Автоматично попълване на адрес
• Генериране на товарителници и отчети
• Управление на логистика в реално време

---

💻 Технологии

Категория	Използвани технологии
Език	C#
Технологична рамка	.NET / ASP.NET Core
ORM	Entity Framework Core
База данни	MS SQL Server
Фронтенд	MVC / Razor Pages
CSS рамка	Bootstrap
Генериране на PDF	JSPdf
Генериране на Excel файлове	XLSX
Икони	FontAwesome / Bootstrap
Картови услуги	Mapbox
Интеграция с API	Econt API
Тестване	xUnit

---

📦 Основни функционалности

• ✅ CRUD операции за поръчки
• ✅ Избор на офис за доставка чрез карта
• ✅ Автопопълване на адрес и телефон чрез autocomplete
• ✅ Преглед и проследяване на статус на пратка
• ✅ История на поръчките
• ✅ Генериране на месечни отчети (PDF)
• ✅ Статистики
• ✅ Админ панел за управление на поръчки и клиенти

---

🧪 Тестване

• 🧩 Unit тестове – за логика на управляване на поръчки
• 🔄 Интеграционни тестове – за API комуникация и логистична връзка
• ✅ Използване на FluentAssertions за по-ясна проверка на резултатите

---

🏗️ Архитектура

Проектът следва многослойна архитектура:

• Shipify.Common - Общи ресурси.
• Shipify.Data - Слой за достъп до данни (Entity Framework, DbContext, миграции)
• Shipify.Presentation - Презентационен слой
• Shipify.Services - Слой с бизнес логика
• Shipify.Tests - xUnit и Integration тестове

▶️ Стартиране на проекта

1. 📥 Изтегляне на проекта

git clone https://github.com/codingburgas/2425-dzi-csharp-hhchandar20.git

2. ⚙️ Настройване на базата данни

// appsettings.json
"ConnectionStrings": {
  "DefaultConnection": "Server = .\\SQLEXPRESS;Database = ShipifyDB;Trusted_Connection=true;Integrated Security=true;TrustServerCertificate=true"
}

3. 🧱 Изпълнение на миграции (с Entity Framework Core)

dotnet ef database update

Ако нямаш dotnet-ef:

dotnet tool install --global dotnet-ef

4. ▶️ Стартиране на приложението

dotnet run