Why this matters
- Delivery agent assigns package to compartment by size (S/M/L)
- Scope — what "Compartment sizing" covers inside Amazon Locker System and what it does not
- Scope — what "Pickup flow" covers inside Amazon Locker System and what it does not
- Scope — what "Expiry" covers inside Amazon Locker System and what it does not
- Machine problems test State, Strategy, and facade coordination.
Client / API
FacadeSingle entry point
EntitiesDomain objects
State / Strategy
CampusOS context
CampusOS is the fictional smart-campus platform used across this track. Treat this module as a real product slice:
Context
- Belongs to CampusOS — same naming and design vocabulary as parking, library, and booking modules
- Scope is one JVM — persistence is in-memory or behind a repository interface
- Goal is a class diagram + core Java that an interviewer can follow in 35–45 minutes
- Extension paragraph at the end links to System Design when scale exceeds one process
Requirements snapshot
Functional requirements
- Delivery agent assigns package to compartment by size (S/M/L)
- System generates one-time pickup code sent to customer
- Customer enters code at kiosk; compartment opens if valid and not expired
- Expired packages free compartment and notify customer
- Support multiple locker banks per city with unique bank ID
Non-functional requirements
- Single JVM, in-process design for this LLD article
- Core flows testable with in-memory repositories
- Extension points for new rules without editing central god classes
- Clear public API on facade/service layer
- CampusOS extension links to System Design when scale demands distribution
Overview
This CampusOS module designs Amazon Locker System as a production-ready in-process service. Read requirements point-by-point before drawing classes.
Requirements
Points to cover
- Delivery agent assigns package to compartment by size (S/M/L)
- System generates one-time pickup code sent to customer
- Customer enters code at kiosk; compartment opens if valid and not expired
- Expired packages free compartment and notify customer
- Support multiple locker banks per city with unique bank ID
Compartment sizing
Points to cover
- Scope — what "Compartment sizing" covers inside Amazon Locker System and what it does not
- Classes — name 2–4 classes/interfaces responsible for this slice
- Flow — step-by-step: trigger → validation → state change → side effect
- Edge cases — invalid input, concurrent access, empty state, timeout
- Pattern — Strategy, State, Observer, or Facade if it fits naturally
- Test hook — one scenario an interviewer will ask you to walk through
Pickup flow
Points to cover
- Scope — what "Pickup flow" covers inside Amazon Locker System and what it does not
- Classes — name 2–4 classes/interfaces responsible for this slice
- Flow — step-by-step: trigger → validation → state change → side effect
- Edge cases — invalid input, concurrent access, empty state, timeout
- Pattern — Strategy, State, Observer, or Facade if it fits naturally
- Test hook — one scenario an interviewer will ask you to walk through
Expiry
Points to cover
- Scope — what "Expiry" covers inside Amazon Locker System and what it does not
- Classes — name 2–4 classes/interfaces responsible for this slice
- Flow — step-by-step: trigger → validation → state change → side effect
- Edge cases — invalid input, concurrent access, empty state, timeout
- Pattern — Strategy, State, Observer, or Facade if it fits naturally
- Test hook — one scenario an interviewer will ask you to walk through
// CampusOS — AmazonLocker facade (keep thin)
public final class AmazonLockerService {
private final AmazonLockerRepository repository;
public AmazonLockerService(AmazonLockerRepository repository) {
this.repository = repository;
}
/** Orchestrate: validate → domain rules → persist → return result */
public Result handle(Request request) {
request.validate();
var domain = DomainModel.from(request);
domain.applyRules();
return repository.save(domain);
}
}
Quick recall
Everything you need if you only revisit this box.
- Requirements — review this slice before mock interviews.
- Compartment sizing — review this slice before mock interviews.
- Pickup flow — review this slice before mock interviews.
- Expiry — review this slice before mock interviews.
CampusOS extension
When this outgrows one JVM
- Shard inventory or state by campus ID or geographic region
- Push notifications, payments, and search to dedicated services (System Design track)
- Use message queues for async side effects (email, analytics)
- The class diagram you drew here becomes one box on the HLD architecture diagram
Test yourself
Answer these before moving on — recall is what makes it stick.