SLAM Operations Service - Domain-Driven Design

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public class SLAMSession {
    private String sessionId;
    private String orderId;
    private String shipmentId;
    private String packageId;
    private SessionStatus status;
    private String scannedBarcode;
    private WeightVerification weightVerification;
    private ShippingLabel shippingLabel;
    private String manifestId;
    private LocalDateTime createdAt;
    private LocalDateTime scannedAt;
    private LocalDateTime labeledAt;
    private LocalDateTime manifestedAt;
}

1
2
3
4
5
6
7
8
9
public class Manifest {
    private String manifestId;
    private String carrier;
    private ManifestStatus status;
    private List<String> packageIds;
    private int packageCount;
    private LocalDateTime createdAt;
    private LocalDateTime closedAt;
}

1
2
3
4
5
6
7
8
9
10
11
public class WeightVerification {
    private double scannedWeight;
    private double expectedWeight;
    private double variance;
    private double variancePercent;
    private VerificationResult result;

    public boolean isWithinTolerance() {
        return variancePercent <= 10.0;
    }
}

1
2
3
4
5
6
7
public record ShippingLabel(
    String carrier,
    String trackingNumber,
    String routingCode,
    String serviceLevel,
    LocalDateTime generatedAt
) {}

1
2
3
4
5
6
7
8
9
public interface SLAMSessionService {
    SLAMSession createSession(String orderId, String shipmentId, String packageId);
    SLAMSession scanPackage(String sessionId, String barcode, double scannedWeight, double expectedWeight);
    SLAMSession generateLabel(String sessionId, String carrier, String trackingNumber, String routingCode);
    SLAMSession applyLabel(String sessionId);
    SLAMSession manifest(String sessionId, String manifestId);
    SLAMSession escalateException(String sessionId, String reason);
    SLAMSession getSession(String sessionId);
}

1
2
3
4
5
6
7
public interface ManifestService {
    Manifest createManifest(String carrier);
    Manifest addPackage(String manifestId, String packageId);
    Manifest closeManifest(String manifestId);
    Manifest getManifest(String manifestId);
    List<Manifest> getOpenManifests(String carrier);
}

1
2
3
4
5
6
7
8
9
10
11
12
public interface SLAMSessionRepository {
    SLAMSession save(SLAMSession session);
    Optional<SLAMSession> findById(String sessionId);
    List<SLAMSession> findByStatus(SessionStatus status);
    List<SLAMSession> findByShipmentId(String shipmentId);
}

public interface ManifestRepository {
    Manifest save(Manifest manifest);
    Optional<Manifest> findById(String manifestId);
    List<Manifest> findOpenByCarrier(String carrier);
}