DCSA Reference Documentation / Standards / Standard Releases / Port Call / Port Call v2.0.0

DCSA Interface Standard for Port Call 2.0.0 - User Stories

Contents

Introduction

In line with the techniques used in software development, DCSA has incorporated user stories and use cases into the standards development process to support the digitalization efforts of the shipping industry. Both user stories and use cases serve the purpose of capturing and documenting requirements, but they differ in granularity, level of detail, and the stages of the development process in which they are most prominently used. They are complementary (one or more use cases may support a user story and vice versa) and can be used together to provide a comprehensive understanding of software requirements. In this section, we will focus on user stories.

User stories are typically concise, informal descriptions of a feature or functionality written from an end user’s or stakeholder’s perspective. They express the needs, goals, and expectations of users in an easily understandable way, ensuring the delivered product meets the intended requirements. In standards development, this translates to creating testable acceptance criteria to validate that the standard is correctly implemented and achieves its intended purpose.

The next section outlines the Port Call user stories that DCSA used as the basis for developing the standard. The supporting use cases are defined in the dedicated Port Call use cases section.

User story examples

Berth

1. As a terminal or port authority I want that the carrier shares the estimated time of arrival berth so that the terminal knows when the vessel expect to arrive at berth

  1. As a carrier I want that the terminal shares the requested time of arrival berth so that the carrier knows when the berth will be available

3. As a terminal or port authority I want that the carrier shares the planned time of arrival berth so that the terminal have a confirmation of the planned arrival at berth

  1. As a terminal or port authority I want that the carrier shares the actual time of arrival berth so that the all stakeholders are informed of the vessel arrival at berth

5. As a port authority or terminal I want that the carrier shares the estimated time of departure berth so that the port authority can plan nautical services for the vessel departure.

6. As a carrier or terminal I want that the port authority shares the requested time of departure berth so that the all stakeholders can plan the vessel departure activities.

7. As a port authority or terminal I want that the carrier shares the planned time of departure berth so that the all stakeholder knows the vessel planned time of departure

8. As a port authority or terminal I want that the carrier shares the actual time of departure berth so that the all stakeholders know vessel left the berth

Pilotage

9. As a port authority or carrier I want that the pilotage service provider shares the estimated time of start pilotage so that the port authority knows when pilotage service provider estimates to attend to the vessel. Berth facility & location to be used in case of shifting from one berth to another.

10. As a pilotage service provider I want that the port authority shares the requested time of start pilotage so that the pilotage service provider knows when the pilot is required to attend to the vessel. Berth facility & location to be used in case of shifting from one berth to another.

11. As a port authority or carrier I want that the pilotage service provider shares the planned time of start pilotage so that the port authority can communicate requested time of arrival pilot boarding place (along with planned time of stat towage). Berth facility & location to be used in case of shifting from one berth to another.

12. As a port authority or carrier I want that the pilotage service provider shares the actual time of start pilotage so that the stakeholders are aware pilotage has started. Berth facility & location to be used in case of shifting from one berth to another.

13. As a port authority or carrier I want that the pilotage service provider shares the estimated time of completion pilotage so that the port authority knows when pilotage service provider estimates to complete attendance to the vessel and includes it in the traffic coordination

14. As a pilotage service provider or terminal I want that the port authority shares the requested time of completion pilotage so that the pilotage service provider knows when the pilot is required to complete attendance to the vessel

15. As a port authority or carrier I want that the pilotage service provider shares the planned time of completion pilotage so that the port authority knows when pilotage service provider confirms to complete attendance to the vessel and includes it in the traffic coordination

16. As a port authority or carrier I want that the pilotage service provider shares the actual time of completion pilotage so that the stakeholders are aware pilotage has completed.

Towage

17. As a port authority or carrier I want that the towage service provider shares the estimated time of start towage so that the port authority knows when towage service provider estimates to attend to the vessel and includes it in the traffic coordination. Berth facility & location to be used in case of shifting from one berth to another.

18. As a pilotage service provider I want that the port authority shares the requested time of start towage so that the towage service provider knows when the tug is required to attend to the vessel. Berth facility & location to be used in case of shifting from one berth to another.

19. As a port authority or carrier & pilotage service provider I want that the towage service provider shares the planned time of start towage so that the port authority can communicate requested time of arrival pilot boarding place (along with planned time of start pilotage). Berth facility & location to be used in case of shifting from one berth to another.

20. As a port authority or carrier I want that the towage service provider shares the actual time of start towage so that the stakeholders are aware towage has started. Berth facility & location to be used in case of shifting from one berth to another.

21. As a port authority or carrier I want that the towage service provider shares the estimated time of completion towage so that the port authority knows when towage service provider estimates to complete attendance to the vessel and includes it in the traffic coordination

22.  As a towage service provider or carrier I want that the port authority shares the requested time of completion towage so that the towage service provider knows when the tug is required to complete attendance to the vessel

23.  As a port authority or carrier I want that the towage service provider shares the planned time of completion towage so that the port authority knows when towage  service provider confirms to complete attendance to the vessel

24.  As a port authority I want that the towage service provider shares the actual time of completion towage so that the stakeholders are aware towage is completed.

Mooring

25. As a port authority or terminal & carrier I want that the mooring service provider shares the estimated time of start mooring so that the port authority knows when linesmen estimate to attend to the vessel

26. As a mooring service provider or terminal & carrier I want that the port authority shares the requested time of start mooring so that the linesmen know when they are expected to start mooring

27. As a port authority or terminal & carrier I want that the mooring service provider shares the planned time of start mooring so that the port authority knows when linesmen confirm to start mooring

28. As a port authority or terminal & carrier I want that the mooring service provider shares the actual time of start mooring so that the stakeholders are aware mooring has started

29. As a port authority or terminal & carrier I want that the mooring service provider shares the estimated time of completion mooring so that the port authority knows when linesmen estimate to complete mooring

30. As a mooring service provider or terminal & carrier I want that the port authority shares the requested time of completion mooring so that the linesmen know when they are expected to complete mooring

31. As a port authority or terminal & carrier I want that the mooring service provider shares the planned time of completion mooring so that the port authority knows when linesmen confirm to complete mooring

32. As a port authority or terminal & carrier I want that the mooring service provider shares the actual time of completion mooring so that the stakeholders are aware the vessel is not manoeuvrable anymore/ service completed

Bunkering

33. As a carrier or port authority & terminal I want that the bunkering service provider shares the estimated time of start bunkering so that the vessel can do necessary preparation before start of bunkering

34. As a bunkering service provider or port authority & terminal I want that the carrier shares the requested time of start bunkering so that the service providers knows when the vessel requests to start taking into account vessel berth stay and vessel planning

35. As a carrier or port authority & terminal I want that the bunkering service provider shares the planned time of start bunkering so that the stakeholders know when bunkering is planned to start

36. As a carrier or port authority & terminal I want that the bunkering service provider shares the actual time of start bunkering so that the stakeholders are aware bunkering started

37. As a carrier or port authority & terminal I want that the bunkering service provider shares the estimated time of completion bunkering so that the carrier can verify if bunkering is estimated to be completed before etd

38. As a bunkering service provider or port authority & terminal I want that the carrier shares the requested time of completion bunkering so that the service provider knows when bunkering should be completed

39. As a carrier or port authority & terminal I want that the bunkering service provider shares the planned time of completion bunkering so that the stakeholders know when bunkering is planned to finish

40. As a carrier or port authority & terminal I want that the bunkering service provider shares the actual time of completion bunkering so that the stakeholders are aware bunkering is completed

Pilot boarding place

41. As a port authority or terminal I want that the carrier shares the estimated time of arrival pilot boarding place so that the port authority can coordinate the start of nautical service providers

42. As a carrier or terminal I want that the port authority shares the requested time of arrival pilot boarding place so that the carrier knows at what time the vessel is requested to arrive at pilot boarding place

43. As a port authority or terminal I want that the carrier shares the planned time of arrival pilot boarding place so that the port authority have a confirmation of the planned arrival time at pilot boarding place

44. As a port authority or terminal I want that the carrier shares the actual time of arrival pilot boarding place so that the all stakeholders are informed about the vessel arrival at pilot boarding place.

Cargo operations

45. As a carrier or port authority I want that the terminal shares the estimated time of start cargo operations so that the carrier can verify port call duration & scheduling effects

46. As a terminal I want that the carrier shares the requested time of start cargo operations so that the terminal can adjust planning if beneficial to both stakeholders

47. As a carrier or port authority I want that the terminal shares the planned time of start cargo operations so that the stakeholders are aware when cargo operations is planned to start and can estimate port call duration & scheduling effects

48. As a carrier or port authority I want that the terminal shares the actual time of start cargo operations so that the stakeholders can plan next steps

49. As a carrier I want that the terminal shares the estimated time of completion cargo operations so that the carrier can prepare the vessel departure planning and next port call.

50. As a terminal I want that the carrier shares the requested time of completion cargo operations so that the terminal can prepare contingencies activities if needed.

51. As a carrier I want that the terminal shares the planned time of completion cargo operations so that the terminal confirm the planned time of completion to all stakeholders.

52. As a carrier or port authority & terminal I want that the terminal shares the actual time of completion cargo operations so that the vessel and port can finalize departure activities.

Anchorage

53. As a port authority I want that the carrier shares the estimated time of arrival anchorage so that the port authority can monitor and coordinate vessels traffic in the port area

54. As a carrier I want that the port authority shares the requested time of arrival anchorage so that the carrier knows at what time the vessel is requested to arrive at anchorage area

55. As a port authority or terminal I want that the carrier shares the planned time of arrival anchorage so that the port authority have a confirmation of the planned arrival time the vessel will be at the anchorage area

56. As a port authority or terminal I want that the carrier shares the actual time of arrival anchorage so that the all stakeholders are informed of the vessel arrival at the anchorage area

57. As a port authority I want that the carrier shares the estimated time of departure anchorage so that the port authority can monitor and coordinate vessels traffic in the port area

58. As a carrier or terminal I want that the port authority shares the requested time of departure anchorage so that the carrier knows at what time the vessel is requested to leave the anchorage area

59. As a port authority or terminal I want that the carrier shares the planned time of departure anchorage so that the port authority have a confirmation of the planned departure time of the vessel from anchorage area

60. As a port authority or terminal I want that the carrier shares the actual time of departure anchorage so that the all stakeholders are informed of the vessel departure from the anchorage area

Sludge

61. As a carrier I want that the sludge service provider shares the estimated time of start sludge so that the carrier/vessel is aware and can plan all other vessel activities accordingly

62. As a sludge service provider I want that the carrier shares the requested time of start sludge so that the service provider is aware when the vessel can be ready for  sludge disposal 

63. As a carrier or port authority I want that the sludge service provider shares the planned time of start sludge so that the carrier/vessel is aware when sludge disposal is planned

64. As a carrier or port authority I want that the sludge service provider shares the actual time of start sludge so that the all stakeholders are informed that sludge disposal has started

65. As a carrier I want that the sludge service provider shares the estimated time of completion sludge so that the carrier/vessel is aware and can plan all other vessel activities & departure  accordingly

66. As a sludge service provider I want that the carrier shares the requested time of completion sludge so that the service provider is aware when sludge disposal has to be finished

67. As a carrier or port authority I want that the sludge service provider shares the planned time of completion sludge so that the carrier/vessel is aware when sludge disposal is planned to be completed

68. As a carrier or port authority I want that the sludge service provider shares the actual time of completion sludge so that the all stakeholders are informed that sludge disposal has been finished 

Vessel ready for cargo operations

69. As a terminal or port authority I want that the carrier shares the actual time of vessel ready for cargo operations so that the terminal knows they can start cargo operations

Vessel ready to sail

70. As a terminal or port authority I want that the carrier shares the actual time of vessel ready to sail so that the terminal is aware that the vessel can safely depart from the carrier’s perspective

Shore power

71. As a carrier or port authority I want that the shore power service provider shares the actual time of start shore power so that the all stakeholders are aware when the shore power plug is connected.

72. As a carrier or port authority I want that the shore power service provider shares the actual time of completion shore power so that the all stakeholders are aware when the shore power plug is disconnected.

Sea passage

73. As a port authority or pilot I want that the carrier shares the actual time of completion sea passage so that the port authority knows that the vessel is ready to proceed to pilot boarding place

74. As a port authority or pilot I want that the carrier shares the actual time of start sea passage so that the port authority knows that the vessel is leaving port area

Terminal ready for vessel departure

75. As a carrier or port authority I want that the terminal shares the actual time of terminal ready for vessel departure so that the carrier is aware that the vessel can safely depart from the terminal’s perspective

Loading cargo operations

76. As a carrier or port authority I want that the terminal shares the actual time of start loading cargo operations so that the stakeholders are aware that loading has been started

77. As a carrier or port authority & terminal I want that the terminal shares the actual time of completion loading cargo operations so that the stakeholders are aware that loading has been finished

Lashing

78. As a carrier or port authority & terminal I want that the lashing service provider shares the actual time of completion lashing so that the stakeholders are aware lashing is completed

Gangway down and secure

79. As a port authority or pilot I want that the carrier shares the actual time of gangway down and secure so that the stakeholders are aware the vessel is fully safe to board

Discharge cargo operations

80. As a carrier or port authority I want that the terminal shares the actual time of start discharge cargo operations so that the stakeholders are aware that discharge has been started

81. As a carrier or port authority I want that the terminal shares the actual time of completion discharge cargo operations so that the stakeholders are aware that discharge has been finished

Anchorage operations

82. As a port authority I want that the carrier shares the actual time of start anchorage operations so that the port authority are aware of the start of the anchorage operation

83. As a port authority I want that the carrier shares the actual time of completion anchorage operations so that the port authority are aware of the completion of the anchorage operation

All fast

84. As a port authority or terminal I want that the carrier shares the actual time of all fast so that the stakeholders are aware that the vessel is fully moored

Moves

85. As a terminal I want that the carrier shares the moves forecast so that the terminal knows the expected moves to take place during the port call.

a. As a container carrier, I want to be able to share with a terminal the high-level number of expected moves per terminal call data that could include total restow moves, total moves, total load moves, total discharge moves, so that the terminal is able to plan their resources.

b. As a container carrier, I want to be able to share with a terminal the more granular number of expected moves per terminal call data including splits by container type (20’, 40’, OOG, Plugged Reefer 20’, Plugged Reefer 40’), so that the terminal is able to plan their resources.

c. As a container carrier, I want to be able to share with a terminal the more granular number of expected moves per terminal call data distinguishing moves of empty containers and laden containers, so that the terminal is able to plan their resources.

d. As a container carrier, I want to be able to share with a terminal the updated number of expected moves per terminal call data at not defined intervals, so that the terminal is able to plan their resources.

e. As a container carrier, I want to be able to share with a terminal the number of expected moves per terminal call data, always specifying if the moves are for all the vessel or for specific carrier, so that the terminal is able to plan their resources and determine if needs to collect moves from other carriers.

f. As a container carrier, I want to be able to share with a terminal the service partners in a vessel, so that the terminals is able to determine from what carriers needs to collect moves if the moves are not provided for all the vessel but for a specific carrier.

Cancel a service

86. As a service provider or port authority I want that the carrier shares the cancel of a service so that the stakeholders are aware the service is cancelled and will not occur.

Omit a port call

87. As a port authority or terminal I want that the carrier shares the omit of a port call so that the stakeholders are aware the vessel will not call the port.

Omit a terminal call

  1. As a terminal or port authority I want that the carrier shares the omit of a terminal so that the stakeholders are aware the vessel will not call the terminal.

Decline a port call service

  1. As a service provider I want that the service consumer shares the declining of a service so that the stakeholders are aware the service can’t be performed as informed.