DefileERP — Техническо предложение

// Описание на проекта

project.description SCOPE

Подробно описание на проекта, неговите цели и обхват.

1/**

2 * @project DefileERP — ERP система за дистрибуция на авточасти

3 * @client DefileERP

4 * @author Web Factor ЕООД (Александър Кирилов)

5 * @version 1.0.0

6 *

7 * Целта на проекта е изграждане на цялостна ERP платформа,

8 * проектирана специално за нуждите на дистрибутори на авточасти.

9 *

10 * Системата ще обхваща следните ключови бизнес процеси:

11 *

12 * - Управление на продуктов каталог с 100 000+ артикули

13 * - Складово стопанство: множество локации, наличности, трансфери

14 * - Поръчки към доставчици и проследяване на доставките

15 * - Клиентска база и CRM функционалност

16 * - Продажби, фактуриране и финансови справки

17 * - Ценообразуване с марж калкулации и ценови листи

18 * - Детайлни отчети и бизнес анализи (dashboard)

19 *

20 * Архитектурата е модулна — всеки модул работи независимо,

21 * но споделя обща база данни и бизнес логика. Системата е

22 * проектирана за скалируемост и лесно надграждане.

23 *

24 * @since 2025

25 */

~/defile-erp (main) bash

$ wc -l src/**/*.ts | tail -1

~45 000 lines total (estimated)

$ echo "Срок: 60 работни дни | Гаранция: 24 месеца"

Срок: 60 работни дни | Гаранция: 24 месеца

$ echo "Плащане: 30% / 30% / 40%"

Плащане: 30% / 30% / 40%

// Модули на системата — структура на кодовата база

src/ MODULES

Всеки модул е самостоятелен пакет с ясна отговорност. Структурата отразява реалната организация на кода.

☰ EXPLORER: defile-erp/src/modules

📁 defile-erp/ root project

── Модул: Продукти и каталог

├─ 📁 products/ Продуктов каталог

│ ├─ ■ ProductCatalog.ts 100 000+ артикули, OEM номера, кръстосани референции

│ ├─ ■ CategoryTree.ts Йерархична категоризация, марки, модели

│ ├─ ■ PriceEngine.ts Ценови листи, марж калкулации, отстъпки

│ └─ ■ BulkImport.ts Масов импорт от CSV/Excel на доставчици

── Модул: Складово управление

├─ 📁 warehouse/ Складови операции

│ ├─ ■ StockManager.ts Наличности в реално време, резервации

│ ├─ ■ LocationMap.ts Множество складове, позиции, рафтове

│ └─ ■ TransferOrders.ts Междускладови трансфери, приемане/предаване

── Модул: Поръчки и доставки

├─ 📁 procurement/ Поръчки към доставчици

│ ├─ ■ PurchaseOrder.ts Създаване, одобрение, проследяване на поръчки

│ ├─ ■ SupplierRegistry.ts Доставчици, условия, контакти, история

│ └─ ■ DeliveryTracker.ts Статуси на доставка, очаквани дати, закъснения

── Модул: Продажби и фактуриране

├─ 📁 sales/ Продажби и фактури

│ ├─ ■ SalesOrder.ts Клиентски поръчки, количка, калкулация

│ ├─ ■ InvoiceGenerator.ts Фактури, кредитни известия, PDF експорт

│ └─ ■ PriceListManager.ts Клиентски ценови листи, специални условия

── Модул: Клиенти и CRM

├─ 📁 crm/ Клиентски отношения

│ ├─ ■ ClientManager.ts Физически и юридически лица, контакти

│ └─ ■ ClientHistory.ts Пълна история: поръчки, фактури, комуникация

── Модул: Отчети и Dashboard

├─ 📁 reports/ Анализи и справки

│ ├─ ■ Dashboard.ts Реално време: продажби, наличности, KPI

│ ├─ ■ FinancialReports.ts Оборот, печалба, задължения, вземания

│ └─ ■ ExportEngine.ts Експорт CSV, Excel, PDF за всяка справка

── Модул: Потребители и сигурност

└─ 📁 auth/ Сигурност и достъп

├─ ■ RoleManager.ts Роли: Admin, Manager, Warehouse, Sales

├─ ■ AuditLog.ts Пълен лог на всяко действие в системата

└─ ⚙ SecurityConfig.ts JWT, 2FA, session management, CORS

module stats output

$ find src/modules -type d -maxdepth 1 | wc -l

7 модула

$ find src/modules -name "*.ts" | wc -l

21 основни компонента

// git log --oneline --graph — Процес на разработка

git log PROCESS

Разработката следва 5 ясно дефинирани фази. Всяка фаза завършва с демо и приемане от клиента.

a1b2c3d Седм. 1-2

feat: Архитектура и фундамент PHASE 1

Проектиране на базата данни, архитектура на приложението, среда за разработка и CI/CD pipeline.

ER диаграма и схема на БД (40+ таблици)
Архитектурен дизайн и API спецификация
Setup на dev среда, Docker, CI/CD
Автентикация, роли и базова сигурност

e4f5g6h Седм. 3-5

feat: Core модули — Продукти, Склад, Поръчки PHASE 2 MILESTONE

Разработка на трите най-критични модула. Покриват 70% от ежедневната работа.

Продуктов каталог с OEM референции и масов импорт
Складово управление — наличности, локации, трансфери
Поръчки към доставчици и проследяване на доставките
Ценови модел с марж калкулации

i7j8k9l Седм. 6-8

feat: Продажби, CRM и фактуриране PHASE 3

Клиентската страна на бизнеса — продажби, фактури и управление на клиентските взаимоотношения.

Продажби и клиентски поръчки с калкулация
Фактуриране с PDF генериране
CRM — клиентска база, история, документи
Клиентски ценови листи и отстъпки

m0n1o2p Седм. 9-10

feat: Dashboard, отчети и финализация PHASE 4

Анализи, справки и полиране на цялата система.

Dashboard с KPI и графики в реално време
Финансови отчети — оборот, печалба, задължения
Складови справки и движения
Експорт функционалност (CSV, Excel, PDF)

q3r4s5t Седм. 11-12

release: v1.0.0 — Production Deploy DEPLOY GO-LIVE

QA тестване, миграция на данни, деплоймент и обучение на екипа.

End-to-end тестване на всички модули
Миграция на съществуващи данни
Production деплоймент и мониторинг
Обучение на персонала + документация
Старт на 24-месечната гаранция

// cat package.json — Технологичен стек

package.json STACK

Технологиите, които захранват DefileERP. Модерен, доказан и надежден стек.

package.json JSON

{ "name": "defile-erp", "version": "1.0.0", "description": "ERP за авточасти", "author": "Web Factor ЕООД", "license": "proprietary",
// Backend "dependencies": { "laravel": "^11.x", "php": "^8.3", "mysql": "^8.0", "redis": "^7.x", "nginx": "^1.24" },
// Frontend "devDependencies": { "vue": "^3.4", "inertia": "^1.x", "tailwindcss": "^3.x", "typescript": "^5.x" } }

infrastructure.yml YAML

# Инфраструктура и DevOps
"server": "Linux VPS / Dedicated" "web_server": "Nginx + PHP-FPM" "database": "MySQL 8.0 (InnoDB)" "cache": "Redis 7.x" "queue": "Laravel Queues + Redis"
# Сигурност "auth": "JWT + Session" "encryption": "AES-256-CBC" "ssl": "Let's Encrypt (auto)" "backups": "Daily automated"
# Мониторинг "monitoring": "Health checks" "logging": "Structured logs" "alerts": "Email + Slack"

// cat invoice.txt — Стойност и плащане

invoice.generate() PRICING

Фиксирана цена. Без скрити разходи. Ясна схема на плащане.

9 000 EUR

без ДДС · фиксирана цена · без скрити разходи

Проектиране и архитектура ✓ вкл.

7 функционални модула ✓ вкл.

REST API + документация ✓ вкл.

UI/UX дизайн (responsive) ✓ вкл.

Миграция на данни (базова) ✓ вкл.

Деплоймент на production ✓ вкл.

Обучение на персонала ✓ вкл.

Гаранция 24 месеца

Срок на изпълнение 60 работни дни

TOTAL 9 000 EUR

payment-schedule.sh bash

#!/bin/bash

# Схема на плащане: 30 / 30 / 40

PHASE_1="2 700 EUR" # 30% — при стартиране

PHASE_2="2 700 EUR" # 30% — при работещ прототип

PHASE_3="3 600 EUR" # 40% — при предаване

$ echo "Плащане 1: Авансово"

> 2 700 EUR при подписване на договора.

> Покрива: архитектура, БД дизайн, setup.

$ echo "Плащане 2: Междинно"

> 2 700 EUR при демо на core модулите.

> Покрива: продукти, склад, поръчки.

$ echo "Плащане 3: Финално"

> 3 600 EUR при приемане на готовата система.

> Покрива: deploy, обучение, гаранция старт.

                        30% · 2 700 EUR
                        30% · 2 700 EUR
                        40% · 3 600 EUR
                    

// cat README.md — Често задавани въпроси

README.md FAQ

Отговори на най-често задаваните въпроси за проекта.

★ README.md — Frequently Asked Questions

Колко артикула може да поддържа системата?

Системата е проектирана за работа с 100 000+ артикула. Базата данни е оптимизирана с правилни индекси и кеширане, така че скоростта на търсене остава висока дори при големи обеми данни.

Може ли да се интегрира с онлайн магазин?

Да. Системата предоставя REST API, през който онлайн магазинът може да чете наличности, цени и продуктова информация, както и да създава поръчки. Webhook нотификации при промени са налични.

На какъв сървър ще работи?

Linux сървър (Ubuntu/Debian) — VPS или dedicated. Минимални изисквания: 4 vCPU, 8GB RAM, 80GB SSD. Можем да помогнем с избора и настройката на хостинг средата.

Какво покрива 24-месечната гаранция?

Безплатно отстраняване на бъгове и дефекти, открити в гаранционния период. Гаранцията покрива коректна работа на всички разработени функционалности спрямо приетата спецификация. Не включва нови функции или промени в обхвата.

Може ли да се добавят нови модули по-късно?

Абсолютно. Модулната архитектура е проектирана точно за това — лесно надграждане без засягане на съществуващата функционалност. Нови модули могат да се договорят и разработят отделно.

Как се прави импорт на съществуващи данни?

Включен е базов импорт от CSV и Excel файлове за продукти, клиенти и доставчици. За миграция от съществуваща система (друг софтуер, ERP, база данни) може да се договори допълнителен обем работа.

Колко потребители могат да работят едновременно?

Без твърдо ограничение. При стандартна сървърна конфигурация системата поддържа 50+ едновременни потребители. Производителността може да се мащабира вертикално (по-мощен сървър) или хоризонтално (load balancing).

// cat REQUIREMENTS.md — Системни изисквания

sys.requirements CLIENT

Какво осигурява клиентът и какви са минималните системни изисквания.

Клиентът осигурява

Хостинг сървър (VPS/Dedicated) или бюджет за наем
Домейн за системата (напр. erp.defile.bg)
SSL сертификат (или Let's Encrypt — безплатно)
Данни за импорт в структуриран формат (CSV/Excel)
Контактно лице за обратна връзка и тестване
Лого и branding материали (по желание)
Достъп до тестова среда за приемни тестове

Минимални сървърни изисквания

OS: Ubuntu 22.04 LTS или Debian 12
CPU: 4 vCPU (Intel/AMD, 2.5+ GHz)
RAM: 8 GB (16 GB препоръчително)
Storage: 80 GB SSD (NVMe препоръчително)
PHP 8.3+, MySQL 8.0+, Redis 7.x
Nginx 1.24+ с PHP-FPM
SSH достъп за деплоймент и поддръжка

system-check.sh bash

$ ./check-requirements.sh

[PASS] PHP 8.3 .................. OK

[PASS] MySQL 8.0 ................ OK

[PASS] Redis 7.x ................ OK

[PASS] Nginx 1.24 ............... OK

[PASS] Disk Space (80GB+) ....... OK

[PASS] RAM (8GB+) ............... OK

[PASS] SSL Certificate .......... OK

All checks passed. Ready to deploy.

// Готови ли сте да стартирате проекта?

$ npm run start-project

Натиснете Enter за да стартирате. Или ни се обадете.

tel: +359 883 322 379 email: office@webfactor.com exec: Александър Кирилов

  ┌──────────────────────────────────────────┐
  │                                          │
  │   Предложението е валидно 30 дни.        │
  │   Всички цени са без ДДС.               │
  │   Стойността е фиксирана при спазване    │
  │   на описания обхват.                    │
  │                                          │
  └──────────────────────────────────────────┘