ECU Tuning Portal v5.4 — Comprehensive Product Documentation

Purpose: This document serves as the definitive reference for rewriting the landing page at ecutuningportal.com. Every feature, module, capability, and selling point is documented based on live system exploration of new-ui.ecutuningportal.com (admin + customer panels).

---

1. PRODUCT OVERVIEW

ECU Tuning Portal is a white-label B2B SaaS platform designed for ECU tuning businesses. It provides a complete, ready-to-deploy solution for managing customers, processing tuning files, handling payments, and running a professional tuning operation — all under the buyer’s own brand.

• Version: 5.4
• Architecture: PHP MVC (custom framework), MySQL, vanilla JS frontend
• Deployment: Self-hosted (Ubuntu + Nginx + Plesk compatible)
• White-Label: Full branding customization (logos, colors, domain)
• Multi-Language: 17 languages (EN, TR, DE, FR, ES, IT, NL, PT, RU, AR, CZ, GR, HE, HU, NO, PO, SK)
• Theme: Dark Mode + Light Mode with one-click toggle
• Responsive: Mobile-friendly design

---

2. DUAL PANEL SYSTEM

2.1 Admin Panel

A comprehensive management dashboard for business owners/operators.

Dashboard Features:

• Total Customers counter
• Total Credits (CRD) counter
• Total Payment (€) counter
• Credit Transactions feed (real-time)
• File Transactions feed (recent tuning jobs)
• Summary cards
• Vehicle Search (cascading: Type → Brand → Model → Generation → Engine)
• Recent Orders table (Order No, Invoice No, Date, Credit, Amount, State, Invoice link)
• Pending Transactions counter
• Completed Transactions with full vehicle + tuning details

Admin Menu Structure (25+ pages):

Section	Pages
Customers	Customer List, Customer Groups, Customer Vehicles, Support Tickets, Purchases, Invoices
Products	Credit Packages (with sub-items)
Subscription	Active Subscriptions, Subscription Plans
Tuning	Tuning Manager (module pricing), Reading Methods
Vehicle Management	Vehicle Catalog, Custom Vehicles, Catalog Settings
Codes	Bosch Codes, P Codes (DTC), Additional Options
Parameters	Administrator Users, General Settings, Logo Settings, Payment Methods, EVC Settings, SMS Settings, Working Hours, Mail Settings, Policies & Announcements

2.2 Customer Panel

A clean, intuitive interface for end-users (tuning shops’ customers).

Customer Menu Structure:

Section	Pages
Main	Dashboard, My Files, File Upload (multi-step wizard)
Credits	Buy Credit, Subscription Plans, Credit Reports, Price List, My Cart
Support	Support Tickets (create, track, messages)
Catalog	Bosch Codes Search, P Codes (DTC) Search
Information	Imprint, Terms & Conditions, Privacy Policy, Return Policy, Delivery Information
Profile	Edit Profile (personal, company, avatar)

---

3. KEY FEATURES & MODULES

3.1 Credit System

The entire platform runs on a credit-based economy.

• Admin sets credit value (e.g., 1 CRD = €0.85)
• Credit packages are customizable products (e.g., 1 CRD, 2 CRD, 5 CRD, 10 CRD, 25 CRD, 50 CRD, 100 CRD, 250 CRD)
• Each tuning service costs credits (e.g., Stage 1 = 3 CRD, EGR Off = 2 CRD)
• Customer groups can have different pricing multipliers, discounts, and bonus credits
• Credit Reports show full transaction history with filters (All/Completed/Pending/Cancelled)
• Real-time balance displayed in header bar (€ and CRD)

3.2 Subscription System (NEW in v5)

Monthly and annual subscription plans for recurring revenue.

• Annual Subscription: e.g., €2,200/year, +2,016 credits, 17% savings highlighted
• Monthly Subscription: e.g., €220/month
• Subscription benefits:
  • Unlimited file processing
  • Priority service / faster response times
  • Full tuning capabilities
  • EVC support
• Admin manages plans: Price, period, credits, duration, sort order, status
• Subscription lifecycle: Active → Expiring Soon (email reminder) → Expired
• Cron-based checker for automatic expiration handling
• Manual admin check button as cron alternative
• Bank transfer subscription support with manual approval

3.3 Payment System (3 Methods)

PayPal Integration

• Sandbox and Live modes
• Client ID + Secret configuration
• Toggle on/off per environment

Stripe Integration

• Test and Live API keys
• Public Key + Secret Key
• Toggle on/off per environment

Bank Transfer

• Full bank details: Bank Name, Sort Code, Account Number, IBAN, SWIFT/BIC
• Custom payment instructions text
• Orders set to “Pending” until admin manually verifies
• Admin approval workflow

Checkout Flow:

1. Customer selects credits or subscription
2. Chooses payment method (PayPal / Stripe / Bank Transfer)
3. Enters shipping/billing details (Country, City, Address)
4. Order Summary with Subtotal, Discount, Grand Total
5. Payment processing
6. Invoice generated automatically

3.4 Tuning File Management

File Upload (Multi-Step Wizard)

Customer-facing 4-step wizard:

1. Vehicle Selection: Type → Brand → Model → Generation → Engine (cascading dropdowns)
2. Options: Tuning modules selection, manual/automatic, ECU type, reading method
3. File Upload: Upload original ECU file
4. Confirmation: Review and submit

Tuning Modules (19+ configurable services)

Admin configures each module with credit cost:

• Stage 1
• Stage 2
• EGR Off
• AdBlue/SCR Off
• DPF Off
• Check DTC File Fix
• Stage 1 + EGR Off (combo)
• Rev Limiter
• BMW SportDisplay
• Pre-Catalizo
• And more…

Each module’s credit cost is independently configurable per vehicle type.

File Processing Workflow

• Customer uploads → Status: PENDING
• Admin processes file → Status: COMPLETED
• Customer downloads modified file
• Full audit trail with timestamps

3.5 Vehicle Database

Massive integrated catalog:

• Vehicle Types: Car, Bike, Boat, Tractor, Truck
• 350+ Brands: From Abarth to ZX, including all major manufacturers (BMW, Mercedes-Benz, Audi, Toyota, Tesla, Ferrari, Lamborghini, etc.) plus niche brands (Koenigsegg, Pagani, Rimac, etc.)
• Cascading Selection: Type → Brand → Model → Generation → Engine
• Custom Vehicles: Admin can add vehicles not in the catalog
• Catalog Settings: Exclude specific brands/models
• Vehicle details: Year range, BHP, KW specifications

3.6 Customer Management

• Customer List: Sortable, searchable table with ID, Avatar, Group, Name, Email, Phone, Credit Balance, Status
• Customer Groups: Custom groups with discount rates, multipliers, bonus credits
• Customer Status: Active / Passive toggle
• Customer Vehicles: Track all vehicles per customer with tuning history
• Edit/Delete operations with confirmation modals

3.7 Support / Ticket System

• Ticket-based support with categories
• Status tracking: Open, New, Closed, Unread, Read
• File attachments in support messages
• Admin ↔ Customer messaging within tickets
• Real-time notification badges in sidebar

3.8 Invoice & Order System

• Automatic invoice generation for every purchase
• Invoice details: Order number, Invoice number, Date, Credits, Amount, Status, Payment status
• Multiple statuses: Approved, Completed, Cancelled
• Payment tracking: PAID badge with link to invoice detail
• Filterable order list with status tabs

3.9 Code Databases

Bosch Codes

• Massive searchable database (1,374+ pages)
• Columns: Manufacturer Number, ECU, ECU Brand
• Paginated, sortable, searchable

P Codes (DTC)

• Diagnostic Trouble Codes database
• Searchable reference for technicians

3.10 EVC Integration

• Optional EVC (Electronic Valve Control) support
• EVC Number per customer
• Separate EVC product catalog
• Toggle on/off in General Settings

---

4. ADMINISTRATION & SETTINGS

4.1 General Settings

• Site URL, SEO Title
• Currency (symbol + code)
• Credit value configuration
• Contact Information (Phone, Email, Address)
• Language selection
• EVC integration toggle
• Subscription system toggle
• Favicon upload

4.2 Logo Settings (White-Label)

• Dark Theme logo upload
• Light Theme logo upload
• Separate logos for each theme — true white-label capability

4.3 Multi-Admin System

• Multiple administrator accounts
• Access permission levels
• Per-admin status (Active/Passive)
• Add/Edit/Delete administrators

4.4 Communication Settings

SMS Settings

• SMS provider API integration
• API key, Sender ID configuration
• Notification toggle per event type

Mail Settings

• SMTP configuration (Host, Port, Username, Encryption)
• Email templates for various events

4.5 Working Hours

• Per-day configuration (Monday through Sunday)
• Displayed to customers in sidebar
• Example: 08:00 - 22:00

4.6 Policies & Announcements

• WYSIWYG rich text editors for:
  • Announcements (banner/notice)
  • Imprint
  • Terms and Conditions
  • Privacy Policy
  • Return Policy
  • Delivery Information

---

5. UI/UX FEATURES

5.1 Dark Mode / Light Mode

• One-click toggle in header bar
• Dark Mode: Deep navy/dark blue background, cyan/teal accents, red highlights
• Light Mode: Clean white/light gray background, same accent colors
• Persistent preference across sessions
• Both admin and customer panels support theme switching
• Military/tech aesthetic with monospace fonts and ”// SECTION” headers

5.2 Design Language

• Militaristic/tech style: ”// DASHBOARD”, ”// CUSTOMERS” section headers
• Color scheme: Dark navy base, cyan/teal primary, red accent for CTAs and alerts, green for success
• Typography: Monospace/technical fonts for headers, clean sans-serif for body
• Cards & Tables: Glassmorphism-inspired cards, striped tables, color-coded status badges
• Responsive sidebar: Collapsible with toggle button
• Real-time clock in header
• Breadcrumb navigation

5.3 Login Pages

• Stunning split-screen design
• Left: Login form with brand logo
• Right: Full-bleed automotive photography (Lexus sports car)
• ”// ADMIN ACCESS — AUTHORIZED PERSONNEL ONLY” heading
• Language selector, theme toggle, Remember Me
• Separate admin and customer login pages

5.4 Internationalization

• 17 languages fully translated
• Language switcher in header
• Flag icons for language selection
• All UI elements, error messages, and notifications translated

---

6. TECHNICAL CAPABILITIES

6.1 Security

• XSS protection (debug info removed from URLs/views)
• CSRF protection on forms
• Double-submit prevention on checkout
• File upload validation (blocked extensions)
• Try-catch error handling throughout (SMS/email failures don’t break main flow)
• Nullable field handling for MySQL strict mode

6.2 Reliability

• Database transaction wrappers for multi-step writes (subscriptions, orders)
• Upload directory auto-creation (ensureUploadDir)
• Graceful error handling (SMS/email failures logged, not shown to users)

6.3 Scalability

• Paginated data tables with configurable page sizes (10/15/25/30/50)
• Sortable columns on all list views
• Search/filter capabilities on all tables
• Lazy-loaded cascading dropdowns (Brand → Model → Generation → Engine)

6.4 Integration Ready

• PayPal API (Sandbox + Live)
• Stripe API (Test + Live)
• SMS API (configurable provider)
• SMTP Email
• EVC API (optional)
• Cron job support for automated tasks

---

7. COMPETITIVE ADVANTAGES / SELLING POINTS

1. Complete White-Label Solution — Your brand, your domain, your logos (dark + light theme)
2. 19+ Tuning Modules — Stage 1, Stage 2, EGR, DPF, AdBlue, Rev Limiter, and more
3. Credit-Based Economy — Flexible pricing with customer group discounts
4. 3 Payment Methods — PayPal, Stripe, Bank Transfer out of the box
5. Subscription System — Monthly & annual plans for recurring revenue
6. 350+ Vehicle Brands — Massive auto-populated vehicle database (Car, Bike, Boat, Tractor, Truck)
7. Dark/Light Mode — Professional UI with theme switching
8. 17 Languages — Serve customers worldwide
9. Multi-Admin — Team management with permission levels
10. Built-in Support System — Ticket-based customer communication
11. Bosch & DTC Code Databases — 27,000+ codes for reference
12. Automatic Invoicing — Professional invoices for every transaction
13. Multi-Step File Upload — Guided wizard for perfect submissions
14. Working Hours Display — Customers always know when to expect service
15. EVC Integration — Optional Electronic Valve Control support
16. SMS + Email Notifications — Keep customers informed automatically
17. Responsive Design — Works on desktop, tablet, and mobile
18. Subscription Reminders — Automatic email before expiration
19. Custom Vehicle Support — Add vehicles not in the catalog
20. Real-Time Dashboard — Live credit, payment, and file transaction monitoring

---

8. SCREENSHOTS INVENTORY

Admin Panel (25 screenshots)

#	File	Description
01	admin/01-dashboard-full.png	Full dashboard with all widgets
02	admin/02-customers.png	Customer list with search/sort
03	admin/03-customer-groups.png	Customer group management
04	admin/04-customer-vehicles.png	Vehicle file tracking
05	admin/05-support.png	Support ticket management
06	admin/06-purchases.png	Order list with payment details
07	admin/07-invoices.png	Invoice management
08	admin/08-subscriptions.png	Active subscriptions
09	admin/09-subscription-plans.png	Plan configuration
10	admin/10-tuning-manager.png	Module pricing configuration
11	admin/11-reading-methods.png	ECU reading methods
12	admin/12-vehicle-catalog.png	Vehicle database browser
13	admin/13-payment-settings.png	PayPal/Stripe/Bank config
14	admin/14-general-settings.png	Site-wide configuration
15	admin/15-logo-settings.png	White-label logo upload
16	admin/16-evc-settings.png	EVC integration
17	admin/17-sms-settings.png	SMS provider config
18	admin/18-working-hours.png	Business hours
19	admin/19-mail-settings.png	SMTP configuration
20	admin/20-policies.png	Legal pages editor
21	admin/21-products.png	Credit package management
22	admin/22-catalog-settings.png	Catalog exclusions
23	admin/23-custom-vehicles.png	Custom vehicle additions
24	admin/24-administrator.png	Multi-admin management
25	admin/25-dashboard-light-mode.png	Light theme demo

Customer Panel (11 screenshots)

#	File	Description
01	customer/01-dashboard.png	Customer dashboard
02	customer/02-my-files.png	File list with status tracking
03	customer/03-file-upload.png	Multi-step upload wizard
04	customer/04-buy-credit.png	Credit packages + subscriptions
05	customer/05-subscriptions.png	Subscription plan comparison
06	customer/06-credit-reports.png	Transaction history
07	customer/07-price-list.png	Credit packages + tuning prices
08	customer/08-my-cart.png	Checkout with 3 payment methods
09	customer/09-support.png	Support ticket system
10	customer/10-my-profile.png	Profile editor
11	customer/11-dashboard-light-mode.png	Light theme demo

Special Screenshots

File	Description
admin-login.png	Admin login page (dark, automotive)

---

9. COMMIT HISTORY HIGHLIGHTS (Last 60 commits)

Major development themes identified from new-ui repo:

1. Subscription System — Full implementation: plans, checkout, activation, cron checker, email reminders, bank transfer support, transaction safety
2. Currency Simplification — Removed multi-currency complexity, simplified to single currency from Settings
3. Admin Delete Operations — AJAX delete with confirmation modals across all admin list views (12+ pages)
4. SMS/Email Resilience — Try-catch wrappers to prevent notification failures from breaking core flows
5. Security Hardening — XSS fixes, double-submit protection, file upload validation, upload directory auto-creation
6. i18n Expansion — Delete operation and subscription translations added to all 17 languages
7. Database Integrity — MySQL strict mode fixes, nullable field handling, transaction wrappers
8. UI Polish — DataTable scroll fixes, customer group form improvements

---

10. TARGET AUDIENCE & POSITIONING

Primary Audience: ECU tuning businesses worldwide looking for:

• A professional, branded portal for their customers
• Automated file management and credit tracking
• Multiple payment options
• Subscription-based recurring revenue
• Multi-language support for international clients

Value Proposition: “Launch your professional ECU tuning portal in minutes, not months. Complete white-label solution with 19+ tuning modules, 350+ vehicle brands, 3 payment gateways, and 17 languages — all under your brand.”

---

Document generated: 2026-04-01 Based on: Live exploration of new-ui.ecutuningportal.com (Admin + Customer panels) Screenshots: 37 total (25 admin + 11 customer + 1 login)