This guide explains how to build the DDEC application from source and run it on your local development machine.
Before you begin, ensure you have:
# Clone QRE Framework
git clone https://git.t3.daimlertruck.com/New-Refactored-DDEC/ddec-qre.git
# Clone DDEC Web Application
git clone https://git.t3.daimlertruck.com/New-Refactored-DDEC/ddec-web.git
# Use the Develop branch for latest changes
git checkout Develop
If you received the source code as a ZIP file (like from OneDrive), extract it to your workspace. The source should be organized as:
your-workspace/
├── ddec-qre/
│ ├── qre2-parent/ # Core QRE modules
│ └── qre2-mvs-parent/ # IMS/MVS modules
└── ddec-web/ # DDEC Web Application
The DDEC application depends on the QRE Framework, which must be built first.
cd ddec-qre/qre2-parent
mvn clean install -DskipTests
This builds 9 core modules including:
cd ../qre2-mvs-parent
mvn clean install -DskipTests
This builds 5 IMS-specific modules including:
cd ddec-web
mvn clean install -DskipTests
This creates:
target/ddec-web-1.0.1-SNAPSHOT.warRun with the local-test profile (uses in-memory HSQLDB database):
java -Djava.net.preferIPv4Stack=true \
-jar target/ddec-web-1.0.1-SNAPSHOT.war \
--spring.profiles.active=web,local-test \
--server.address=0.0.0.0
Import Project: Import ddec-web as a Maven project
Create Run Configuration:
com.csc.qre.web.bootstrap.QreWebApplicationAdd VM Arguments:
-Dspring.profiles.active=local-test
-Djava.net.preferIPv4Stack=true
For SQL Server connection instead of HSQLDB:
-Dspring.profiles.active=sqlserver-local
Run the application
Once started successfully, you'll see:
Started Application in X.XXX seconds
Open your browser and go to:
http://localhost:8080
| Username | Password | Role |
|---|---|---|
| admin | admin | Administrator |
| Guest | Guest | Read-only |
| test1 | test1 | Test user |
| Profile | Purpose | Database |
|---|---|---|
local-test |
Local development | HSQLDB (in-memory) |
sqlserver-local |
Local with SQL Server | SQL Server |
web |
Enable web server | N/A |
dev |
Development environment | SQL Server |
qa |
QA testing | SQL Server |
prod |
Production | SQL Server |
Make sure you built the QRE modules first:
cd ddec-qre/qre2-parent && mvn clean install -DskipTests
cd ../qre2-mvs-parent && mvn clean install -DskipTests
Find and kill the process using port 8080:
# Linux/Mac
lsof -i :8080
kill -9 <PID>
# Windows
netstat -ano | findstr :8080
taskkill /PID <PID> /F
For local testing, use the local-test profile which uses HSQLDB (no external database needed).
Add this JVM argument:
-Djava.net.preferIPv4Stack=true