Requirement Specification
Requirement Specification
COA_CRIS – P – 1.1 – RS
Page 1 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Chanakya Puri
New Delhi
Page 2 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Revision History
Page 3 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 4 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 5 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The duties of the Section Controller are very strenuous in nature involving high level of
documentation work in addition to his primary duty of planning and reporting the
movement of trains.The present system of operational practices also/ involves a lot of
paper work by support staff to convert the operational related information from the Control
Chart into various registers. Thus the core activity of advance plotting and timely reporting
of movements is hampered . Thus, the management is forced to rely only on selective
information about various events for decision making.
In view of the above scenario, Indian Railways has prioritised the need to automate these
operations and identified the need for technology enabled services as part of its
automation strategy to achieve operational efficiency.
The benefits of such an automated system would be
- Integration of various distributed systems in a cost effective manner
- Better operational efficiency and productivity by replacing manual processes with
automated processes.
- Establishment of faster and better interfaces with the consumers by streamlining of
processes and enhancement of information availability
- Greater cohesiveness among various divisions
Page 6 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2 Functional Requirements
The purpose of this use case is to allow user to login to the system. The authenticity of
user shall be checked and access to various functions shall be given as per his assigned
group.
Actors
1. Primary Actors
1.1 Section Controller
1.2 Dy. Trains
1.3 Dy. Coaching
1.4 Power Controller
1.5 Yard Manager
1.6 MIS User
2. Secondary Actors
Flow Of Events
2.1.1 Basic Flow – User Login
The use-case starts when user gets login screen on clicking COA icon or on selecting
logout option.
• User shall give user-id, password and Shift details.
• On submitting, user details shall be validated.
• If validation fails
Message shall be displayed. Use-Case ends.
• If valid,
Menu screen shall be displayed with options enabled as per group
assigned at the time of user creation.
Any information to be given on login shall be displayed through an
alert displayed on main menu screen.
In case a user is assigned more than one section highest priority
section shall be enabled at the time of login with facility of changing
the section any time after logging into the system.
Page 7 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2.1.1.1 Pre-Conditions
• User database information should be available.
Flow Of Events
2.1.2 Basic Flow – Train Ordering.
This use case starts when Section Controller selects “Order a Train” from the menu. The
screen displays the available options. The options available are
Page 8 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
(i) Add New Train (ii) Modify Train (iii) Cancel Train (iv) Link Trains
Page 9 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 10 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
User can select any one of the following options (i) Put Back (ii) Put
Forward.
If more than one train is selected, user shall enter No. Of
hours/minutes by which each train is to be Put Back/ Put Forward
If a single train is selected user shall enter modified departure time.
User shall then submit modified Train Details.
When a train is put forward, the system shall validate that the revised
ETD is not earlier to the current system time.
If validation fails,
Message is displayed. Use Case ends.
If valid,
System shall save the information.
System displays a confirmation message.
The modified ETD shall get displayed on the screen.
Page 11 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Change Of Destination
Page 12 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Diversion
Diversion task shall be invoked when there is change in the route in current
division but no change in destination.
If there is change in the route and destination is in the current division
then
User shall select required route.
User shall also give authorization details.
If there is change in the route and destination is in other division then
User may give division exit station (Interchange Point).
User shall then select required route.
User shall also give authorization details.
User shall then submit modified Train Details.
System shall validate division exit station.
If validation fails,
Alternate flow Invalid Station is followed.
If valid,
System shall save the information.
System displays a confirmation message.
Page 13 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Cancel Train
Only the Dy. CHC (Trains) in respect of goods trains and Dy.CHC (Punctuality) can
cancel a train whose departure is scheduled for that day or within a specified time
interval and which has not yet departed.
• The screen displays following options:
(i) Passenger Trains
(ii) Other Trains.
• On selecting one of the above options, by default, the list of trains scheduled
to depart over the Division for a configurable time interval shall be displayed on
the screen.
• The user shall select one or more trains for cancellation.
• The user shall select the reason code from the
pre-defined list for cancellation. If reason code is OTHR, specific details shall be
entered.
The user shall then save the details.
Page 14 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
If successfully saved,
System displays a confirmation message.
• On saving, modified data shall be sent to CAS for
updating the external/adjoining database.
Link Train
Linking is facilitated to be done between trains created in COA and train details that
would come through CAS system from other applications like FOIS or from COA of
a contiguous division.
• A list of trains received from CAS system and trains created through this
system shall be displayed.
• A train shall be selected from the list under CAS system, dragged and
dropped on to COA trains list using identification parameters like Train
Name, From Station, To Station, ETD and other details.
• It shall be possible to drag and drop multiple trains.
• The user may also de-link a train by dragging out the linked train from COA
list, in case of error in selection.
Page 15 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• A list of linked trains shall be shown to the user, on confirmation, the details
shall be saved.
System displays a confirmation message.
Invalid Station
• In case station is not found message shall be displayed.
• Station entry may be corrected and submitted again or use case ends here.
Pre-Conditions
• Section Controller should have successfully logged on to the system.
• Static database information should be available.
Post-Conditions
• Graph should be refreshed whenever a new train is created or there is
change in the details of a train.
Business Rules
Page 16 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Assumptions
• Data from external systems should be available to this system through CAS
server.
Actors
1.Primary Actors
a)Section Controller
b)CAS System
2.Secondary Actors
Flow Of Events
The use-case starts when user selects “Maintain Train Information” option from the menu.
• The following options shall be displayed to the user.
(i) Trains To depart
(ii) Trains Running
• On selecting the option “Trains to depart”, the list of trains expected to depart
within a pre-defined time interval shall be displayed on the screen.
• On selecting the option “Trains running”, the list of trains running within the
section based on specified direction shall be displayed on the screen.
• On selecting a train from the list, the available train details shall be displayed
on the screen.
• The train details displayed shall include train number/name, train type,
direction, from station, to station.
The following options shall be available to the user for entering/updating train
information.
(i) Loco Attachment/Detachment (ii) Consist Reporting (iii) Wagon/Coach
Attachment/Detachment (iv) Crew Reporting (v) BPC Reporting.
Page 17 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 18 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 19 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 20 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 21 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 22 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 23 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 24 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• If the BPC details are not available, User shall enter the Station of Issue, BPC
No, Date, % Brake Power, Valid From, Valid To, Std of Exam, BPC Type,
Base Station, Days Valid For and Kms Valid for.
• On saving.
System shall save the information.
System displays a confirmation message.
Invalid Station
• In case station is not found message shall be displayed.
• Station entry may be corrected and submitted again or use case ends here.
Pre-Conditions
• Section Controller should have successfully logged on to the system.
• Detachment of loco option shall be enabled only when at least one loco is
attached to the train.
• Static database information should be available.
Page 25 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Post-Conditions
• Changes saved should be shown on the screen after successful save.
• Changes in any of details shall affect the graph.
Business Rules
• If train is coming from non-computerized control charting territory, train shall
have to be created afresh in this system. The various details pertaining to the
train such as consist details, loco details, BPC details, Crew details shall also
have to be entered.
Assumptions
Data from external systems should be available to this system.
Actors
1.Primary Actors
a)Section Controller
b)Data Logger
2.Secondary Actors
a)CAS System
Flow Of Events
2.1.5 Basic Flow – Manage Train Movement.
The menu defined by this use-case shall be the default option in the touch screen.
The list of running/ordered trains over the board shall be displayed direction wise
separately for selection.
On selecting the train number, the current location of the train shall be displayed
The user shall then select any one of the following options:
Report Arrival/Departure/ Run Through
Line Occupation (Optional)
Detentions
Priority change
Abnormal Working (Optional)
Page 26 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 27 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
In the data logger mode, the details pertaining to above activity shall be system driven
through the interface software.
In the manual mode, in case of occupation of a line by a full train
• User shall select the train number and type
• The station at which the arrival was reported last shall be displayed by default.
• Only the line numbers that are free at the chosen station shall be displayed for
selection.
• The selected line shall be deemed to be occupied by the specified train till the
time of clearance either by departure or removal to yard.
• If a line has been blocked by a goods train either due to termination or for
other reasons and remains to be occupied for more than 24 hours from the
time of arrival, it shall be deemed as stabling.
• When the line has been cleared by the departure of the train after a brief
stoppage, the system shall reckon the time of departure as time of removal by
default and cause the line to be shown again as “Clear”.
• When the train has reached the destination or terminated at a station, the time
of removal shall be entered by the user on receipt from the station / cabin with
brief reason which shall cause the line to be shown again as “Clear”.
• If a train is to be dealt with on a line which is shown as already occupied, then
User shall select the station.
The list of occupied lines at the selected station shall be displayed for
selection.
The user shall select the line number and fill in the time of removal for the
previous train. This shall cause the line to be shown as “clear”. The user
shall have the facility to enter the new train number for the same line. When
the user enters the new train number, the time of arrival of the train at the
same station shall be the default time of occupation and also cause the line
to be shown again as occupied.
• In the case of outgoing train at a station, the nominated platform line shall be
shown by default as the line occupied by the train from 30 mins before the
scheduled departure.
• The details of nominated line, train wise, station wise shall be maintained as
part of the referential data. The line shall be deemed to be “Clear” with the
actual departure of the train.
• If some other train already occupies the nominated line, the user shall have
the option to choose one of the unoccupied lines for the other train.
Page 28 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• User shall enter the number of wagons and rake type/ coach type and the time
of detachment (occupation) on the line.
• The selected line shall be deemed to be occupied by part of a train until the
time of clearance either through attachment to another train or removal.
When the line has been cleared by attaching the above wagons/coaches to a different
train or through other means, the user shall enter the train number to which they were
attached, time and date of attachment, remarks( if any). The line shall be deemed to be
clear from the time of attachment or removal.
2.1.5.3 Detentions
This option shall facilitate assigning the exact reason for all detentions affecting a train on
its run over the board.
When the cause of the detention at a station or block section, is instantaneously known to
the Section Controller (through the station staff or Guard of the train), then
The user shall select the train number.
System shall display, by default, the station code or the block section code,
where the loss has been computed.
If the arrival has been reported for a train, the default display
will be only the preceding block section.
If the departure has been reported for a train, the default
display will be only the preceding station.
If run through has been reported for a train, the default display
will be only the preceding block section
It shall also be possible for the user to select any other station or block
section from the graph display through GUI, where the train has suffered
detention.
System shall display by default the exact detention(in minutes) .
System shall also display the pre-defined list of departments to which the
detention is attributable and the user shall select the concerned department.
On selection as above, system shall display the pre-defined
causes(pertaining to the department) for the user to select one or more of
them.
Page 29 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
This option shall be chosen by the user to enter detention details at major stations and
yards including originating station, enroute station where shunting is involved for
attaching/ detaching wagonsor coaches.
The user shall select the train number.
The user shall then enter the station code where the task is to be
reported.
In case of trains ordered but not departed, the ETD shall be displayed.
In case of trains on run, the Arrival time and Departure time shall be
displayed for guidance, if already reported.
The form shall include the following fields :
Time from
Time to
Activity
Remarks
The system should provide for multiple entries at the same station
covering all activities.
The system shall facilitate back reporting for this task upto a period of 2
hours.
The system shall also facilitate reporting of this event by any other actor
like TNC or Dy.CHC.
When the cause of the detention at a station or block section is immediately not known to
the Section Controller and subsequently obtained from the LTM given by the Guard of the
train, then
Page 30 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The system shall display all train numbers based on direction for
which the LTM has not been recorded (for a time interval of 6 Hours)
User shall select the Train number.
The system shall display the list of stations, block sections (over the
route of the train pertaining to the board) and enable the user to enter the
detention time against each. The system shall also display the list of
departments to which the delay can be attributed and the user shall
select one of them.
The system shall then display the possible causes under the particular
department for the user to select one or more of them.
The user shall also have facility to assign any new reason not defined
in the list.
In case the reason for a detention had not been instantaneously
reported, the system shall assign the reason specified through the LTM
form after validating the block section or the station to be the same. The
sum total of detentions that was reported through the LTM task in the
same block section or station should not be more than the detention
shown by the system (as per charting).
In case, the sum total of detentions reported through the LTM task in
the same block-section or station is more than the delay shown as per
charting, the same shall be maintained separately.
If the reason assigned for any detention (through LTM task) is
different from what had been assigned earlier, such details shall also be
maintained train wise separately without overwriting the reason initially
reported
The following are the allowances provided as part of the inter-station running time (shown
distinctly) over each section to set off the loss on account of speed restrictions and traffic
causes.
1. Engineering allowance.
2. Traffic Allowance
Engineering allowance
A specified time is given (train wise) at the last block section or in
more than one block section over the section.
Page 31 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
If loss had been calculated by the system due to one or more speed
restriction in a block section, the default reason for the detention to be
shown as CD.
If gain had been calculated by the system due to absence of a speed
restriction in a block section (only where engineering allowance has been
provided), the gain shall be assigned to CD.
The cumulative loss on account of speed restrictions alone (not other
engineering failures) should be compared against the total engineering
allowance for the train in the section to arrive at net loss or gain under
‘Engineering’.
The gain under engineering shall always equal the allowance
provided over the section for the train.
Traffic Allowance
A specified time is given (train wise) at the last block section or in
more than one block section over the section.
The loss due to traffic may be due to any of the events given below :
o Unscheduled crossing or precedence
o Detention at signal (block section) due to arrival of a train from
opposite direction.
o Acceleration/Deceleration for any unscheduled stopping.
The gain due to traffic may be due to any of the events given below :
o Shifting of scheduled crossing including the time for
acceleration/deceleration and stoppage at station.
o Reduced time for scheduled crossing.
o Starting a train from a station as per shifted timings (PTT).
o Traffic allowance provided as per WTT at a station or block section
not being availed.
The gain under traffic will include the allowance and additional time
made up on run as described above.
Page 32 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
In case of a need for assigning higher priority to a specific train within the same group,
then
• The user shall choose one of the options :
o Passenger
o Other trains
• The user shall then select the sub-group under the broad category (as above)
and the system shall display the list of all running trains under the same group.
• The user shall then rearrange the sequence order for a train (to be accorded
the higher priority) through drag and drop feature.
• The system shall then display a message seeking confirmation of the task. If
the user confirms, the information shall be saved. The system shall also signify
this train in the chart through suitable visual indication.
• The system will cause all other trains within the defined group (based on
relative position of the train) to wait for the prioritized train in case of a
precedence/crossing. In respect of conflict with trains with lower or higher
priority, the normal rules shall apply.
• In a double line section, such kind of prioritization can be assigned for one
train in each direction.
• On successful saving,
Advance plotting graph shall get automatically refreshed. Refer
to Plot Graph use-case.
In case of a need for assigning higher priority to a specific train over all other groups, then
• The user shall choose one of the options :
o Passenger
o Other trains
Page 33 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• The user shall then select the sub-group under the broad category (as
above) and the system shall display the list of all running trains under the same
group.
• The user shall then shuffle the priority group for a train (to be accorded the
higher priority) through drag and drop feature. If the sequence within the higher
group is also to be changed, the same shall be facilitated as explained earlier.
• The system shall then display a message seeking confirmation of the task. If
the user confirms, the information shall be saved. The system shall also signify
this train in the chart through suitable visual indication.
• The system will cause all other trains with priority lower than the specified
train to wait in case of a precedence/crossing.
• In respect of conflict with trains with higher priority, the normal rules shall
apply.
• On successful saving,
o Advance plotting graph shall get automatically refreshed. Refer to Plot
Graph use-case.
Page 34 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The affected block section shall be shown as obstructed in the plot graph
from the date and time of message until the date and time of removal of the
obstruction.
No other train shall be facilitated to enter the affected block section till the removal of the
obstruction.
Page 35 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The system shall validate that an engine of a waiting train cannot be sent for
assistance unless detached from the said train. Like wise starting of a
waiting train shall not be made possible unless an engine is attached to it.
The time of departure of the engine and the station from it was sent shall be
recorded.
The time of arrival of this engine at the spot shall be entered.
The time of departure of the rear portion from the spot shall be
entered.
The time of arrival of the rear portion at either of the stations shall also be
recorded.
In case of clearance in more than two portions,entry of details shall be
facilitated for each such movement.
The user shall enter the time and date of introduction of single line
working.
The user shall select the block section and the line (Up/Dn). In the event of
single line working spanning over more than two stations, then from station
and to station shall be captured. The name of intermediate stations being
temporarily closed shall also be captured.
Page 36 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The user shall also select one of the pre-defined causes for imposition of
single line working.
The movement of trains during this phase shall be captured by the
Arrival/Departure use case. Any wrong line movement shall be distinctly
shown in the chart.
The inter station running time for wrong direction trains shall be calculated at
a speed of 25 KMPH. A delay of 10 minutes shall be added for dispatch and
reception of each wrong direction train between the two stations for the
purpose of advance plotting.
The date and time of cancellation of single line working along with the
certifying authority shall also be captured.
2.1.5.5.6 Accidents
This option shall enable the user to capture the movements associated with accident
situation including ordering of relief trains and their despatch details from the base station.
The time of sounding the siren shall be captured along with the names
of stations. This shall be deemed as the ordering time for accident relief
trains. The user shall use the “Add New Train” option and create train for
all the relief trains ordered immediately.
The system shall automatically suspend “advance plotting” of all trains
in the section excluding accident relief trains.
User shall enter the details pertaining to Accident relief trains (ART)
through this screen such as Time of sounding siren (appears by default),
Time Train Engine Bahar line out, Time of attaching Train Engine, Train
Ready time, Driver Name, Guard Name, Load summary.
The details of coaches/ wagons by train such as coach/wagon type,
coach/wagon number and position from engine shall be entered.
The date/ time of departure and the station with reason for late
departure, if any, shall be recorded.
After entering the details, the user shall submit details.
On successful saving,
Confirmation message shall be displayed.
The movement of all other trains except the ART’s shall be regulated
at convenient stations until further instructions.
In the event of other trains running in the section to be
diverted/terminated short of destination/cancelled, the task shall be carried
out through the menu under Train Ordering use-case.
In respect of movement of relief trains, Light Engine, Tower wagon and other departmental
trains into the affected block-section, the following events shall be captured by the system.
Page 37 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The time of departure of the train/vehicle and the station from shall be
recorded. The destination shall be the affected block section. In case of a
double line section, the line on which the train/vehicle was sent shall also
be recorded.
On arrival in the mid-section, the time of arrival shall be recorded
(whenever known).
The train/vehicle may be sent from either or both of the stations into
the affected block section.
When the train/vehicle departs from the mid-section, the time of
departure and the to station shall also be recorded (whenever known).
The time of arrival of the train/vehicle at the station and the station
name shall also entered.
The date and time of removal of obstruction, the date and time of
track certification, certifying authority shall also be captured.
The affected block section shall be shown as obstructed in the plot
graph from the date and time of accident until the date and time of
removal of the obstruction.
The movement of trains at restricted speed, if any, after certification
shall be captured through the Caution Order use-case.
Pre-Conditions
• Section Controller should have successfully logged on to the system.
• Detachment of loco option shall be enabled only when at least one loco is
attached to the train.
• Static database information should be available.
Post-Conditions
• Changes saved should be shown on the screen after successful save.
• Changes in any of details shall affect the graph.
• In an accident situation, the system shall be capable of retrieving and displaying
essential information on the various resources available (department wise) at
stations over the Control Board for decision making by the Controller.
The information shall include the following:
o List of Level Crossings in the affected block section.
o Availability of Medical relief-Railway Hospitals/Dispensary, Portable
Medical kit at stations, Location of Medical Relief Van.
o Availability of Catering facilities-Refreshment room, Restaurant
o Availability of Travelling Crane, Re-railing equipment under
Mechanical department.
o Telephone number of the Railway Stations.
o Civil district of the place, important phone numbers of civil
administration.
Page 38 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Business Rules
• In the event of any abnormal working like, Single line working on Double line
due to Engineering Blocks and Accident situation, the clearance of all trains
that have entered the section from either end shall be ensured before allowing
any traffic train into the block section. The ‘Advanced plotting’ use-case shall
be functional only after ensuring this pre-condition.
• All timings reported under ART details should be between Time of sounding of
siren and Departure from the base station.
Assumptions
• Data from external systems should be available to this system.
• Maintenance of referential data on essential information pertaining to
assistance required during accidents and updating of the information.
The purpose of this use case is to capture unusual happenings in the section. It also
affects the plot graph use-case. It helps in locating the place of unusual occurrence over
the section, cause, time/date and its effect on train movement.
Primary Actors
Section Controller (SC)
Dy. Controller (Punctuality)
Flow of Events
2.1.6 Basic Flow
• System shall provide facility for the User to capture the unusual occurrences
over the sections within the board.
• System shall facilitate entering start date/time of all unusual occurrences.
• If an Unusual occurrence has happened at a station then
o System shall provide option for choosing the respective station where
it has happened. This will also include provision for capturing the
failure at a cabin, level crossing within the control of the station.
• If an Unusual occurrence has happened in a block section then
o System shall provide option for choosing the block section.
o System shall also provide option for entering exact location in terms of
Kilometrage or OHE mast number.
o If the failure has occurred at level crossing, then the level crossing
number and its location shall also be captured.
Page 39 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• System shall have facility to enter the expected rectification time for the
unusual occurrence (This shall be useful for plot graph use-case (For
Advance Plotting))
• User shall have facility to enter the preliminary cause of failure and expected
delay time for UP/DN/all Trains.
• System shall also provide option for entering any remark for each train
affected by the failure.
• During periods of fog, heavy rainfall and other adverse weather conditions
affecting train services, the system shall be capable of capturing the duration
of such phenomenon and display the same against a station through suitable
icons.
• After the failure is rectified or the cause of occurrence no longer exists, the
system shall provide entering the end date/time of failure and the actual
cause of failure (occurrence) as communicated by the maintenance staff or
the station master. The duration of failure shall be computed automatically by
the system.
Page 40 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Select Train.
The default option shall be ‘Select Train’.
• Based on the above selection, the system shall implicitly assign the same as
the reason for detention.
Unusual occurrences affecting select trains
• The user shall select the Train number based on direction.
• The system shall facilitate entering brief details of the incident.
Page 41 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 42 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 43 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 44 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 45 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 46 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 47 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 48 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 49 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 50 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 51 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 52 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 53 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2.1.6.8.2 Traction
• User shall have facility to select one or more of the pre-defined
failure types or instances.
• User shall also have facility to add new types of failures or
instances.
Page 54 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 55 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 56 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Pre-Conditions
• If the Primary Actor is Section Controller, then
He can view, add, and modify all type of occurrences only over his
jurisdiction
• If the Primary Actor is Deputy Controller(Punctuality), then
He can view, add, and modify all type of occurrences for all boards.
Post-Conditions
• System shall automatically reflect the changes due to unusual
occurrences on the graph (Absolute/Advance) – Refer plot-graph use case.
• The system shall be capable of providing an instantaneous
messaging service of all events affecting a train over all the boards to Dy. Chief
Controllers, Chief Controller, AOM, DOM and Sr.DOM.
Business Rules
• If Primary Actor is Deputy Controller(Punctuality), then
He can perform updating/modification of already completed events
also.
Assumptions
Data from external systems should be available to this system.
Primary Actors
Section Controller
Page 57 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Flow of Events
2.1.8 Basic Flow – Maintenance Blocks
• System shall provide facility to capture the details of proposed block(s) over
a section on a specified date.
• If the block is given at station, then
o System shall provide option for choosing the respective station from
the list of stations over the given section.
• If the block is to be given in a block-section, then
o System shall provide option for choosing the block section.
o System shall also provide option for entering the exact location in
terms of Kms or OHE Mast number.
• System shall provide facility to select one or more of the following types of
Blocks: (Engineering / S&T / Traction).
• The details of programmed corridor blocks shall be captured and maintained
as referential data. They shall include : Section, From station, To station,
Line, Duration_Hr, Duration_Mts, Spell_No., From time, To time, Bet_train1,
Bet_train2, Days permitted.
o If the duration and location of the block is the same as per corridor
block, the user shall select the particular row from the list of corridor
blocks permitted over that section,which shall cause the details for the
block to be displayed by default
• If commencement of the block is definite and independent of the train
movements, then
o System shall provide facility to enter Requested Start Date/Time,
Requested End Date/Time, Permitted Start Date/Time and Permitted
End Date/Time (The Requested and Permitted Time can be same or
different).
• If commencement of the block is dependent on the train movements,
then
o System shall permit the user to enter the Train No after the passage
of which the block is supposed to start.
o In such case, the Permitted Start Date/Time shall commence only
after the train clears the block section.
• System shall provide facility to enter Requested End Date/Time,
Permitted End Date/Time.
• System shall also provide facility to select one or more of the pre-defined
Reasons for the Block.
• Adding of new reasons for the Block by the user shall also be facilitated.
Page 58 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2.1.8.1 At Station
• User shall have facility to select the line Number over which the block is
proposed.
• System shall also display the type of the line (Main/Loop) along with Line No.
• When a line is blocked for a specified duration, the line shall be deemed to
be out of use for such duration and shall also be shown as unavailable for
train movements. The blocked line at that station shall be shown in a distinct
colour (Orange).
• If the blocking of the line is to result in additional time loss for the train
movement , then
o The estimated time delay for each train shall also be entered.. This
shall be of use in the Advanced plotting use-case.
Page 59 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2.1.8.2 At block-Section
• System shall display the direction (Up/Dn) and/or the number of lines
available in the block section.
• If the block Section is in Single Line section, then
o System shall only display “Both” option for selection.
• If the block section is in a Double line section, then
o System shall show UP/DN/Both options for selection.
• If block section is having more than two lines, then
o System shall show the line numbers available in the block
section for selection.
Page 60 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 61 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Pre-Conditions
• If Primary Actor is Section Controller then
Page 62 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
o Section Controller can view, add, and modify the block only for the
particular shift and particular board.
o If Primary Actor is Deputy Controller(Punctuality), then
He can view and add blocks of all sections of the division for (D-1)
day.
Post-Conditions
• System shall create row into the log file for each and every modification of block
entry.
• System shall automatically and immediately reflect the changes due
to block on the graph (Absolute/Advance) – Refer plot-graph use case.
Business Rules
• During all blocks, any number of Departmental and Engineering trains can be
allowed into the affected block section from either end and the system should
facilitate movement of such trains with out any restriction.
Assumptions
Data from external systems should be available to this system.
Flow of Events
2.1.10 Basic Flow – Caution Order
• System shall provide facility to enter the Caution Orders over the section
within the jurisdiction of the board.
• System shall have facility to capture the time/date of imposition of each
caution order.
• System shall also have facility to enter the message number, details of the
authority, who imposed the caution by his designation, department and HQ
station (These would be facilitated through pre-defined list).
• If a new Caution is advised with its location within the station section, then
o System shall provide option for choosing the station
Page 63 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
o User shall have facility for selecting the Line number over which the
speed restriction is to be enforced.
o System shall also show the type of the line (Main/Loop).
• If a new Caution is advised with its location over a block section, then
o System shall provide option for choosing the block section.
o System shall also provide option for entering the exact location in
terms of Kms or OHE Mast number.
o If the block Section is in a Single Line section, then
System shall only display “Both” option for selection.
o If the block section is in a Double line section, then
System shall show UP/DN options for selection.
o If block section is having more than two lines, then
System shall show the line numbers available in the block
section for selection.
• System shall have facility to capture the Restricted Speed(s).
• System shall have facility to capture the special restrictions also. It will take
the input whether the Caution Order shall be applicable to Passenger /
Goods / Both.
• If time/date of removal of caution order is pre- advised at the time of the
imposition, then
o The User shall have facility to enter the expected cancellation
time/date of the Caution.
• System shall have facility to choose one of the pre-defined reasons for
imposing the Caution.
• System shall also provide facility to the user for adding new reason, if any,
which is not in the pre-defined list. .
• System shall have facility to enter any additional remark for the cautions to
be enforced.
Page 64 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 65 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• System shall facilitate the user to enter any new permanent speed
restriction.
• If a permanent speed restriction was to be carried forward from the previous
year, the system shall have facility to enter the Renewal Date. If it is a case of
being carried forward for more than 2 years, the user shall update the renewal
date.
• In case of a permanent speed restriction being cancelled during the year, the
system shall facilitate entering date of cancellation against the selected
permanent speed restriction over the section.
Pre-Conditions
Page 66 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Post-Conditions
• System shall create one row into the log file for every modification in the details
pertaining to speed restrictions.
• System shall automatically reflect the changes due to Caution Order
on the graph (Absolute/Advance) – Refer plot-graph use case.
• The list of all cautions in force for a day shall be printed (section wise and/or
line-wise) on the right hand side of the chart for each shift in geographical order
of the location. (The details should include Station name or Block-section name,
Location, Speed and Reason).
Business Rules
• Primary Actor can enter new Speed Restrictions only up to a margin
of 2 hours from the Permitted Start Date/Time of Speed Restrictions.
Assumptions
Data from external systems should be available to this system.
The purpose of this use case is to draw the movement of trains on the screen for all
sections under the jurisdiction of the board as a time-distance graph. The display shall
show all the running trains with their present location. The display shall also include the
physical status of running lines at stations, failure of equipment, speed restrictions
between block stations or at stations, and maintenance blocks programmed including
those in force. In respect of Express/passenger trains, the display shall also include time
lost or gained between stations with facility to ascertain the cause through a tool tip.
Primary Actors
System
Flow of Events
Page 67 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• The display should also facilitate zoom in and zoom out facility to get a
better understanding of the events over the selected area.
• The system shall also enable the user of a particular board to have a
view of the current chart of other boards in the division. In case of interfacing
with the adjacent division, this facility shall be available for the user only for
the contiguous board.
• The details to be shown only on the display screen shall include:
Section name
Direction (Up and Down)
Station name in the geographical order with Km from the reference
point.
Block Stations (In Bold)
Non-Block stations. (In italics)
Inter station distance (To scale)
Line occupation icon for each line against each station.
Entry/Exit of a train from and to adjacent board.
Train Id information
In case of Passenger Trains
o Train Number
o Locomotive(s) Number
o Driver Name
o Guard Name
o Load Summary
Page 68 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
o Load Summary
o Sign on time.
The details to be shown on the print version of chart shall include the following
in addition to the above:
Actual cause of detentions including failures.
Page 69 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Pre-Conditions
The user should have successfully logged in to the system.
Referential data base is maintained in respect of the basic information.
Post-Conditions
The system shall cause the current chart to be saved as an image file
after two hours from the close of the shift time for each board. This activity
shall be triggered at 0200, 0800, 1400, and 2000 Hours each day.
The system shall facilitate the printing of the chart for specified
duration at the instance of the Dy.CHC (Punctuality) or the CHC.
Till the time of saving the chart as an image file, any request for view
of the chart (of any board) shall be facilitated through dynamic generation
each time.
Once the chart has been saved as an image file, subsequent request
for view option shall be browser based.
Page 70 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Business Rules
• X-axis depicts time in hours and minutes in interval of 10 minutes with further
sub-division in units of 2 minutes.
• Y-axis depicts the stations over the section in geographical order (To scale)
• The graph should show all the movements over that section for a pre-
determined time duration (e.g. 6 Hrs.).
• The display should also facilitate horizontal and vertical scrolling.
• The plot color for different type of trains should be as under and
configurable:
Rajdhani/Shatabdhi/Jan Shatabdhi - Purple
Mail/Express trains - Red
Passenger trains - Blue
Goods Trains/Deptl trains/Material trains/Tower wagons
/Track Machines - Green
Light Engine on Traffic account - Black
• The default size of the print chart shall be 36 inches. It shall
also be possible to take customized print in A0-A3 size, if required.
Assumptions
Data from external systems should be available to this system, where required.
The purpose of this use case is to project the estimated arrival,departure, run through of a
train(s) over the defined section(s), indicate ideal precedence/crossing points based on the
actual running of the train(s) under dynamic situation with the core objective of ensuring
punctuality. The projections should be based on consideration of all specified parameters
and business logic explained herein duly ensuring right time arrival of all scheduled
passenger/express trains at the section/divisional interchange point or destination if within
the division.
At any or all points of conflict, the detention should be to the bare minimum and still
provide for maintaining the punctuality of the services.
In respect of Goods trains, the system should facilitate minimum possible hours of run
over the section.The system should thus cause the projections to be reflected in the
display screen within reasonable response time.
Primary Actors
System
Secondary Actors
Section Controller
Page 71 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Flow of Events
2.1.14 Basic Flow – Advance Plot
• This use case shall be invoked automatically on a user logging in to the
system.
• The projections shall be for a minimum period of 2 hours (configurable) from
the current system time.
• The projections should be based on the schedule of services for the
specified day and also include additional trains added up to that point
including trains from contiguous board and from adjacent division captured
through CAS.
• The projections should be based on scheduled departure,halt at stations and
the last reported event for trains (where applicable).
• The projections shall get refreshed in two ways:
Automatic refresh after every 3 Minutes.
Instantly at the request of the user.
• The projections to be shown distinctly as dotted lines
in the same colour assigned to different types of train.
• The system shall also display the probable status of
all passenger/express train as [BT/RT/LT (Actual quantum of delay in
minutes)] instantly as a tool tip on pointing to the path of the train at every
station and also at the end of the section or on reaching the destination (if
within the same section), based on the direction of the train.
• In the case of goods train, the probable total hours of
duty of the crew from the signing on time, shall be shown as a tool tip when
pointed on the path of the train.
• The system shall also enable filtering the view of
advance plotting based on either the direction of trains or on the type of the
train (Pass/goods) or only for selected trains.
2.1.15 Alternative Flow
The system shall facilitate the user through a GUI to select the path of a
particular train and alter its path manually (drag and drop).
• The events that can be changed as above shall include:
Increasing the inter station running time.
Change of crossing station.
Change of precedence station.
Change the reception order of a train during crossing.
Increase or decrease the scheduled halt at station (only for
passenger trains).
Every such act shall cause the projections to change dynamically based on
the revised co-ordinates assigned to the train.
Page 72 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• The system shall also facilitate the user (menu driven) to force well-
defined detentions to a chosen train at a particular station or a block section
based on expected outcome of a preceding event. This shall cause the
projections to dynamically change based on the defined input.
Pre-Conditions
The user should have successfully logged in to the system.
• The basic referential data is maintained for validation under different
situations.
• In non-data logger environment and during failure of data-loggers, the absolute
responsibility to ensure the occupation of running lines shall rest with the
station staff.
Post-Conditions
The projections regarding the arrival of a train with the train name shall
automatically be shown on the contiguous board (same or adjacent division) at pre-
defined interval of time. The CAS, in case of interfacing between adjacent divisions,
shall enforce this.
Business Rules
The Advance plotting logic initially shall be based on averaging actual data for 5 to
7 days picked up from the relevant physical charts. A matrix comprising of the
different types of trains and their intersectional timings for various speeds would be
developed based on this data. This matrix would be used as a base to forecast the
position of the train. In the enhancement phase, this matrix would be continually
refined by way of replacing the older data with more current data through a
configurable untility.
The process of advance plotting of trains shall depend on the following parameters:
Page 73 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
‘C’ class stations are ideally located only in Double line sections and without any
loop line. Therefore trains cannot precede at these stations. They are located
between two ‘B’ class stations. The system should reckon the portion of the line
between B-C-B as two block sections.
• If the system followed is Automatic Block System then
There can be normally more than one train in the block section
running in the same direction. The number of trains shall usually depend on
the number of signaling sections available between the two stations. In
reality, the number of trains at any point of time can also be more than the
number of signaling sections.
The movement of trains is controlled automatically through the
track circuit/axle counters, which are interlocked to the signals affecting the
run of the train.
In case of a Single line section, more than one train can follow
in the same direction from X to Y, but no train can leave from Y in the
opposite direction till the arrival of all trains from X at Y, based on the
established direction of traffic.
Page 74 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2.1.15.5 Commuter-sensitivity
• Some of the Passenger trains have been defined as commuter
sensitive over the entire run or over a specific section.
• These details are to be captured train wise and section wise and
flagged suitably.
• Such trains shall have over riding priority over trains immediately
above in the order. (e.g Passenger Train[5] over Express Train [3] ).
• In the event of a conflict between two trains in the same group, the
train assigned as commuter sensitive shall have priority over the other train,
independent of all other parameters.
Page 75 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 76 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 77 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
When trains run in the opposite direction (in single line) and wait for
crossing at a station, then
o If T1 train has entered X-Y block section and T2 train has
arrived at Y and waits for the arrival of T1 at Y, then T2 train
shall only leave after the arrival of T1 plus an interval of:
5 minutes in Token Working sections.
2 minutes in Token less section.
Page 78 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
that type of the train (e.g 1200 Metres means, value for 1000 plus value for
200).
• For works, which are not categorized, the user shall
specify the detention for each train(s).
• These offset values should be added to the bare running
time.
Page 79 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
This factor shall enable the system to identify the first arriving train at a point during
conflict.
Page 80 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
the bare running time for the same stretch based on the referential data to arrive at
the percentage of increase or decrease in the actual running time.
If there is an increase of 10 - 20% in the actual running time,
the system shall cause the further advance plotting to be based at a
incremented rate of 10 % over the values prescribed in the referential data
for the specified sub type of the train.
If there is a decrease of 10 - 20% in the actual running time,
the system shall cause the further advance plotting to be based at a
decremented rate of 10 % below the values prescribed in the referential
data for the specified sub type of the train.
Any increase or decrease over 20 % shall be reckoned as an
aberration and discarded.
• The system shall also have the capability to calculate the average
speed of the train over a continuous stretch of 3 block sections from the third station
reckoned from the starting station.
If the system finds that the average speed is exceeding 75 KMPH, then
o System shall prompt the user through an alert about possible over
speeding by the driver of the train..
The user shall acknowledge.
o In case of such situations, the path of the train over such
contiguous section shall be distinctly marked.
While resolving the conflict to determine the crossing/precedence point for trains,
• The cumulative effect of all precedence/crossing for the train shall be
assessed till the scope of duration for which advance plotting is done or the exit of
the train from the section, which ever is earlier.
If the system finds that a train would reach late at the destination or
interchange point by virtue of a crossing/precedence, the system should
re-assign the crossing/precedence to the other station at the end of the
block section and make fresh projections.
Such change of projection should also be facilitated at the intervention of
the user manually.
• The projections should take care of ensuring further punctual running
of trains running right time upto that point of time.
• In the event of one or more trains running late, the projection should
facilitate minimum detention to such trains in addition to ensuring the punctuality of
right time trains.
• If two trains of same priority (belong to same group) lead to a conflict
in the same block section, then
Page 81 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The train running late at that point of time shall have priority over the other
train and
The train which is nearer to its destination or interchange point shall have
priority over the other train.
Intersection of trains
• System should able to detect the intersection point over the graph by its co-
ordinates.
• If not commuter trains,
In case of the same priority group
If the intersection point is closer to A, the crossing/precedence
shall be fixed at A.
If the intersection point is closer to B, the crossing/precedence
shall be fixed at B.
In case of different groups
If the conflict involves T1(High) and T2(Low) trains, the
intersection point shall be fixed, by default, at the station at the
end of the block section where T2(Low) shall be the first
arriving train.
• In respect of Rajdhani trains, the system shall enforce that at least next two
block sections are kept clear under normal circumstances while handling
conflicts.
Assumptions
Data from external systems should be available to this system.
The purpose of this use case is to allow user to create and maintain referential data. The
tables containing the referential data shall be used as base data for train running and other
reporting events
Primary Actors
Administrator
Flow Of Events
2.1.16 Basic Flow – Maintain Referential Data
The use-case starts when user clicks the Referential Data option from the
main menu.
• System shall display a list of all referential tables with the option of
selecting any table from the list to add or update records.
Page 82 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• User shall select either From Database or From Other Source options.
• If the User selects From Database, the existing data from the selected
table shall be displayed.
• User can then modify the existing records with audit details or add
new records to the table.
• If the user selects From Other Source, system shall enable provision
to browse and select the file (only excel and access formats).
• System shall validate the file format according to the selected table
from the referential list.
• If format is invalid
o System shall display appropriate message and use case ends
• If format is valid
o The contents of the file shall be displayed.
o System shall enable Save button.
• User shall save the data by clicking the Save button.
Pre-Conditions
• Data in Flat files or other sources should be in valid formats
Primary Actors
Deputy Controller (Punctuality)
Secondary Actors
Flow of Events
2.1.17 Basic Flow – MIS Reports
System shall provide reports related to punctuality, loco and operation of trains
to the Management users.
1. Trains Lost
• This report shall show the details of the trains lost over a division
on a particular date. The details shall be shown category wise(MR
Trains,Daily Mail/Exp trains, Non-daily Mail/Exp trains, Special Trains and
Page 83 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Passenger trains) and direction wise and train wise, which shall include the
time lost, station at which the time is lost, reason for time loss and remarks.
• System shall provide option for choosing the date for getting the Divisional
Trains Lost report.
• System shall show the data for time loss at different stations and
reason/remarks against a train. The report shall have following attributes:
o Sl.No
o Train Number
o Orign/Taking over station code
o Dep Status (RT/LT-If LT in Mts)
o Enroute Junction code
o Arrl/Dep Status (RT/LT-If LT in Mts)
o Destn/Handing over station code
o Arrl Status (RT/LT-If LT in Mts)
o Primary Responsibility-Department
o Place of Detention (Sttn or Block-section)
o Time Loss
o Reason
o Remarks
o Recovery Details [Summary for the entire run over the Division]
Engg Gain
Engg Loss
Traffic Gain
Traffic Loss
Loco Gain
Loco Loss
2. Punctuality Performance(Summary)
• This report shall show the punctuality performance of all
trains as a percentage in summary form.
• System shall provide option for choosing the date for getting the Divisional
Punctuality Report.
• System shall have capability to show report for the following categories of
trains.
M.R. Trains
Mail Express Trains
Passenger Trains
• The report should include the following headings
Daily percentage (% of RT Trains over Total No of trains run)
Average Percentage for the month
Page 84 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 85 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 86 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2. Interchange Forecast
• This report shall give the details of goods trains including Light engine
planned to be taken over and handed over from/to adjacent divisions during
24 hours for the current day (Sys date).
• The details shall be furnished division wise.
• The sub-division shall include :
To be taken over
To be Handed over
• Under each sub-division, the details shall include :
Sl.No
Train Name
Loco Numbers(s)
Double headed or Multiple Unit (If more than 2 locomotives)
Expected Time
No.of units (Load)
• Summary for each sub-division showing :
No.of trains
No.of Engines-Electric
No.of Engines-Diesel
Total No.of units
Page 87 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 88 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 89 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 90 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
• This report shall give the details of maintenance blocks requested and blocks
granted during a day (24 Hours) for a given date.
• The user shall also be facilitated to specify from and to date for the report to
be generated for any period.
• The details shall include :
Sl.No
Section
Between Stations
Line – Up/Dn (where applicable)
Location (Kms or OHE mast)
Requested-From time
Requested-To time
Requested duration
Permitted-From Time
Permitted-To Time
Permitted Duration
Availed-From Time
Availed-To Time
Availed Duration
Purpose or Nature of work
Whether corridor block or not.
% of Permitted Duration to Requested Duration.
% of Availed Duration to Requested Duration.
Remarks
Page 91 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Page 92 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
o From station
o To station
o Detachment-Train Number
o Detachment-Time/Date
o Detachment Reason
o No.of days since detachment (Sys date – detach date)
o Remarks
Any other user requirement in the form of MIS Reports shall be taken up in the later phase of
development based on mutual discussion.
Assumptions
Data from external systems should be available to this system.
Primary Actors
Section Controller
Train Clerk.
Flow Of Events
2.1.18 Basic Flow – Manage Yard.
The menu defined by this use-case shall be named as :
Line position
This option shall enable the user to record the stock presently located on the various lines
at a yard/station at configured time intervals (say every 4 hours).
The line number, length of the line (in metres) and capacity (in terms of 4-wheelers) at
each station/yard shall be maintained as part of the referential data.
Page 93 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
The status field against each line shall include the following options-
Vacant/Occupied/Nominated/Out of use.
The default option shall be ‘Vacant’. If chosen, the system should display
the no.of 4-wheeler units as ‘0’ and the description of the stock/train as
‘Null’.
If ‘Occupied’ option is chosen, the system shall enable the user to
enter the no.of 4-wheeler units and brief description of the stock against
the particular line.
Once entered, the no.of 4-wheeler units and the description of the
stock shall be displayed by default.
If the above details, at the time of subsequent reporting too, remain the
same, the user shall confirm the details.
If the no.of 4-wheeler units or the description of the stock is different, the
system shall enable the user to modify the details.
If ‘Nominated’ option is chosen, the no.of 4-wheeler units shall be left
blank and the user can enter the train name for which the line is reserved
under description of the stock. In this case, the Expected arrival of the
train shall also be captured additionally. The system time shall be shown
as default option and the user shall modify the ETA based on forecast.
If the “out of use’ option is chosen, the system shall disable the no.of
4-wheeler units and description of the stock details.
Pre-Conditions
• The user should have successfully logged on to the system.
• Static referential database information should be available.
Post-Conditions
The line occupation at different hours of the day shall be printed on the right
hand side of the plot graph for each shift.
Business Rules
Assumptions
Data from external systems should be available to this system.
The purpose of this use case is to allow user to create/modify logins, change password,
create/modify user groups, activate/deactivate user. The association of a user group to a
user determines the access rights to be granted to that particular user.
Primary Actors
Administrator
Page 94 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Secondary Actors
Section Controller
Dy. Trains
Dy. Coaching
Power Controller
Yard Manager
MIS User
Flow Of Events
2.1.19 Basic Flow – Manage User
The use-case starts when user clicks the Administration option from the main menu.
System shall display the following options to the user.
1) Change Password
2) Manage User
If the user is an administrator, both the above options shall be available else only the
Change Password option shall be available.
Page 95 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
If valid
To modify existing login details, user shall select the required record and
change the details whichever required.
System shall also have provision to re-initialize the password
by clicking the Reset Password option.
If Reset Password is clicked, system shall re-initialize the
password to the existing login id after a confirmation from user.
If a certain login id needs to be deactivated, user shall select
the deactivate option and enter the deactivate to date.
System shall validate the changed details.
If valid
o System shall save the details and confirmatory message shall
be displayed
Pre-Conditions
• Super User id and password should have been pre-populated in the relevant
database table
• Task information should have been pre-populated in the relevant database
table.
Post-Conditions
• Password entities shall be saved in encrypted format in the database
Business Rules
Page 96 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
Assumptions
Primary Actors
Section Controller
Dy. Trains
Dy. Coaching
Secondary Actors
Flow Of Events
2.1.20 Basic Flow – Reporting Miscellaneous Tasks
The use-case consists of following tasks, which are accessible from different menu options
1) Preferences Setting
2) Station Layout
3) Master Chart View/Print
Page 97 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
2) Station Layout
User shall select the station from list of stations in the section. Station layout of
selected station shall be displayed on the screen.
Pre-Conditions
Preference Setting option shall be enabled on administrator login.
Some data generated in the divisional control office is shared periodically with other
divisions, higher operating units like Zonal Headquarters and Railway Board and allied
systems like FOIS, NTES.
Considering that COA is a real time application, the data generated from this system has
more reliability and consistency and can be leveraged for use by other systems like NTES,
FOIS . Moreover for seamless integration of neighbouring divisions, such data would
facilitate smooth operational transition and better efficiency through a single point data
entry across the network. The common data would thus flow electronically through the
system to other/adjacent divisions and allied systems.
This would initially be a asynchronous interface (loosely coupled) using optimum
bandwidth between divisional tier and central tier. A low level design document on
Integration would be included along with the main Detailed Design document.
USE-CASE Specification –
Integration of COA with FOIS/NTES/Neighbouring Division
The purpose of this use case is to facilitate mutual sharing of specific data between
Divisional COA’s , NTES and FOIS (in the initial phase).
Primary Actors
Divisional COA System
Page 98 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
CAS
NTES Client
FOIS Client
Secondary Actors
Flow Of Events
2.1.22 Basic Flow –
Initially the above details would be pushed only in respect of reporting stations specified
for the train under NTES.(These details shall be mapped through the NTES flag in the
Train schedule under COA).
There would however be flexibility to report for more stations in the route of the train in
case of future requirement from NTES .
Page 99 of 122
REQUIREMENT SPECIFICATION
COA_CRIS – P – 1.1 – RS
b. Crew details
i. Name of the Driver
ii. Name of the Asst Driver
iii. Name of the Guard
iv. Sign on time-Driver
v. Sign on time-Guard
c. Locomotive details
i. Locomotive Number
ii. Locomotive type
iii. Base shed
iv. Last schedule attended
v. Last schedule date.
d. BPC details.
i. Whether CC Rake or not
ii. BPC No.
iii. Date of Issue
iv. Valid for Kms.
v. Balance Kms.
Considering the fact that COA would ultimately become the core application and drive
FOIS , the scope of the integration functionality shall be scalable and facilitate inter system
information exchange.
To overcome this limitation, the relevant operational data needs to be exchanged between
two neighbouring divisional COA’s.
The functionality in the initial phase shall provide for train running information in respect of
passenger services and freight trains based on appropriate model (NTES or advance
plotting).
A station shall be nominated for this purpose in rear of the divisional interchange point in
either direction and reporting of the departure time at this station shall trigger the flow of
information to adjacent division.
The details shall be displayed in respect of all trains including light engine whose To_sttn
(Destination) is either the Divisional Interchange Point or beyond that point.
In respect of freight trains including Light Engine, the details shall include :
Train Id
Loco Number
From sttn
To sttn
Crew on duty time
Load summary
Station Id
Departure time
ETA at Interchange point.
The purpose of this use case is to facilitate the system to generate and transmit
instantaneous alerts to specified users in the form of short messaging service (SMS).
The recipients of these SMS’s will include only the COA specific divisional users initially
but will provide flexibility to include global users, when required.
Actors
Primary Actors
COA System
Flow Of Events
2.1.23 Basic Flow –
During the course of train operations, certain events are to explicitly defined as
occurrences of critical importance and need to be instantaneously communicated to
relevant operational personnel for information and follow up.
A matrix mapping the events with the list of personnel to whom the information need to be
conveyed is given below :
Intended recipients
Events DRM ADRM SR. DOM AOM CHC SR. SR. SR. SR.DEE SR.
DOM DCM DEE DEE (RS) DSTE
(TRD)
Accidents Y Y Y Y Y Y Y Y Y Y Y
Unusual- Y Y Y Y y
Sigg
Unusual- Y Y Y Y
Engg
Unusual- Y Y Y Y Y
Traffic
Unusual- Y Y Y Y
Comml
Unusual- Y Y Y Y y
Loco-
Elect
Unusual- Y Y Y Y
Loco-Dsl
Unusual- Y Y Y Y
C&W
Unusual- Y Y Y Y y
Elec-
TL/AC
Unusual- Y Y Y Y y
Elec-Trac
Unusual- y Y y
ACP
Unusual- Y Y Y y
Misc
Comml
Unusual-
Loco-
Elect
Unusual- y
Loco-Dsl
Unusual- y
C&W
Unusual-
Elec-
TL/AC
Unusual-
Elec-Trac
Unusual- y
ACP
The mapping of events and the intended recipients shall be configurable locally according
to the divisional requirement.
2.1.23.1 Pre-Conditions
Actors
Primary Actors
Data logger
Flow Of Events
The Use case starts whenever a train enters a station in a section, which is equipped with
data loggers. The relays integrated with tracks/signals and points at the station transmit
the raw data to the data logger, which in turn is networked to a central server at the
divisional control. Whenever detection of a train on the track occurs or a signal device is
operated, the data logger logs the event and transmits the data to the divisional control.
The interface software will map the individual events received from the data logger and
map to COA application specific events
This raw data (in hexadecimal or any other format) contains information like RelayId,
LineId, Data Logger Id, Sequence Numbers, Record Id , Timestamp and Status/Value.
This information would be mapped to relevant details required by COA application like
arrival time/departure time/run through time, line no and station id.
Train Linking
The sequence of steps to link a train entering into a section equipped with data loggers is
as follows
In the event of the non-working of data logger equipment, the system shall have the
provision of turning off this option and switch to the manual mode of train ordering through
the Train Ordering screen. The system shall also generate suitable alerts informing the
user about the event of non functioning of data logger equipment and also intimate the
resumption of functioning of the same.
6.0 Assumptions
• Datalogger equipment is assumed to installed on a complete board in continuous
fashion.
• The data along with relevant formats required for interfacing with COA application
shall be made available by the OEM vendor of data logger equipment.
COA Application will have an integrated approach where there will be multiple divisional
implementations each of which will have individual physical storage. Certain amount of
data will be passed across using the messaging via CAS. Each division will comprise of a
2 servers interconnected with each other with clustered database. And each division will
have a storage in which the physical data will be stored.
Presentation Layer: This layer is basically the user interface developed in C#; this will
have the basic logic for the validation and presentation of the incoming and outgoing data.
Business Layer: This layer captures the business rules as classes/components that can be
reused across application. As a whole this layer houses the full logic of the application
developed in C#
Data Layer: This layer the repository of information/data of the whole application in a
centralized place, which can be accessed from the business rules. This layer implements
the concept of both physical and logical independence of data and would be in Oracle 10g.
Physical Architecture:
The Client Desktop will have windows xp to access the application server. The application
server, which will have Windows 2003 server, serves the data and passes on to the
database and inturn it passes to the Storage where the physical data would be stored.
Some part of the data would be passed from the storage to the CAS via Messaging.
Evolutionary MIS:
The Control Office Application would have a robust database to cater to any changes in
the database design in preliminary stages of its development. Any decision to introduce
new data structures or modifications to existing data structures would be easily addressed.
There is, therefore, a requirement for evolutionary MIS and scalability of the Control Office
Application. The divisional Control Room Operations software shall be developed on a
Standard XA Compliant RDBMS and .Net Application server.
Divisional Level
The Divisional Security Administrator shall be responsible for the security of COA and
other divisional level interfaces
Physical Security
The Divisional/Central Security Administrator shall be responsible for the physical security
of the system
Their responsibilities shall include
Database Security
The following measures shall be taken for ensuring database security
Application Security
Application Security shall be implemented by way of User Maintenance and Client
Maintenance
• User Maintenance
The DSA shall create userids of of various roles such and each of the roles shall have
tasks associated with it. Access shall thus be controlled by role based security. E.ach role
shall have a list of tasks associated with it. New roles can be created by the DSA which
may have additional tasks associated with it. Tasks are in turn are mapped to various
functionalities provided by the COA frontend application.
4 Interface Requirements
The COA Application would have a user friendly GUI interface with rapid data entry
capability and actions through a minimum of keystrokes /clicks. The User Interface and
design is liable to changes, at least initially, on account of addition or modification in
functionality as the system has to be implemented at various locations with varied kind of
operations
Hardware Interfaces
4.1.1 Dual Screen Capability
The COA Application functionality would be visually displayed on two monitors. The larger
21” monitor would be used to display the movement of trains and other related information
like Blocks, Caution Orders, Crossings and Precedences on Time vs Stations graph
format.The other monitor would be used to capture train, track and movement related data
and other necessary inputs needed for sectionwise monitoring. This monitor would also
have a Touchscreen capabilities wherever it is deemed to be suitable and feasible.
Hardware Environment
Item Specification Qty
Development Server Intel XEON processor 3.0 2 Nos
GHz/512 KB cache. Each
with 36 GB HDD
Development Clients Intel based Pentium PC’s 10 nos
with 40 GB HDD /512 MB
DDR RAM
Display/Testing Clients Intel Pentium –IV processor 2 nos
with 1 GB RAM / 80 GB
HDD
Graphic Plotter for chart 42” width/1200dpi/16 MB 1 nos
printing RAM
Common External Storage 4 X 146 GB capacity 1 nos
GSM Modem Nokia GSM Terminal with 1 1 nos
MB flash memory
Software Specifications
COA software would be developed using Microsoft .NET framework architecture with both
the UI middle layer being in C#. The backend would be in Oracle 10g with clustered
design on an external storage.
The proposed COA application shall have provision for displaying query based MIS
reports. The report types and formats are comprehensively described in the MIS Use case
( refer Use Case specification - MIS Reports). These initial set of reports shall be made
available as static ones with a fixed content format. Customizable reports as per divisional
requirements shall be taken up in the subsequent enhancement and support phase.
pages shall be hosted in the IIS (Internet Information Server) running on the production
server. The business logic for processing the queries shall be encapsulated as a set of
shared C# classes in the middle-tier. This will facilitate re-use of the same classes for any
such corresponding requirement by the COA application. An illustration of the architecture
is shown below
Divisional Server
COA
COA IIS Server Clien
Clien Reports webroot
t
t
COAQuery
Application Server
Classes – C#
DB
The proposed browser interface shall be made available in two different ways depending
upon the type of user. These will be made available as a list of logically grouped
hyperlinks. Clicking on any of these hyperlinks would result in the corresponding report to
be displayed in a tabular format. The user shall also have provision to print the displayed
report
• Independent Browser Interface – Through this option, users who do not have
COA client like senior railway officials can access various kinds of reports by
opening the browser directly invoking a URL pointing to the home page of
the reporting module. The advantage of this would be the capability to
access these reports from any location in the divisional intranet. A standard
machine connected to the intranet with a compatible browser would be
Compatibility
Since the system would be built on a .NET platform and deployed on Windows Server
2003 it would be compatible and will be able to comfortably interface with other Microsoft
platform based technologies in case of future needs of COA.
Interoperability
The basic high level design of COA application shall ensure Interoperability with other
industry platforms .As the COA application is based on a .NET platform it shall facilitate
easy interfacing with industry standards.
Quality Assurance
All the deliverables and developed objects would be configuration items, which will be
managed for their version control. Each configuration item would undergo review by peer
review team headed by a review leader.
The quality records are maintained in the Wipro formats with the available guidelines and
templates. For documentation purpose WIPRO ISO9002 standards and guidelines would
be used .
Software Engineering.
Rational Rose shall be the design tool used for capturing the user and functional
requirements through the use case template. For testing purposes Rational PurifyPlus
shall be used for unit testing of the COA application modules.
Performance
Performance of the COA application shall largely depend on the application architecture
that would be proposed in the detailed design document. Periodic refinements to the
architecture would be taken up depending upon the levels of performance exhibited by the
application at the time if unit testing and integration testing. To some extent the
performance would also be dependant on the hardware configuration proposed for the
solution. However the application would be tweaked periodically to maximize the
performance over a period of time.
Reliability
The COA application would be reliable and available with minimum downtime. This would
be facilitated with failover mechanism on the application server. This would be
implemented by running two instances of the application on the server and incase of
failure of the primary instance, the control would be automatically be passed on to the
secondary instance. The same would be applicable in case of the database server also
wherein the application database would be maintained in a mirrored fashion with failover
support in case of db failure
Deployment
The COA system shall easily portable and installable with minimum effort. Since the
solution is .Net based , all the required files can be ported on to a cd and installed with the
xcopy utility.
Risks
Risk 1
Replan---
Actual ---
Remarks
Risk 2
Risk Identification checklist SL. 2
No.
Risk Item Identified / Added The unavailability of the client supplied items
Impact of Risk (High / Medium / High
Low )
Probability of Occurrences of Medium
Risk (High / Medium / Low )
Action Plan (MUST for High Mitigation Plan * Contingency Plan *
Impact Risks or High
Probability of Occurrences of
Risks)
The client has been A re-estimation of the
informed well in schedule will be done and
advance about the the new dates will be
same intimated to the client.
Names of Affected Groups The whole team
Date Plan ---- As and when it happens
Replan---
Actual ---
Remarks
Risk 3
Risk Identification checklist SL. 3
No.
Risk Item Identified / Added Hardware Failure
Impact of Risk (High / Medium / Medium
Low )
Probability of Occurrences of Low
Risk (High / Medium / Low )
Risk 4
Risk Identification checklist SL. 4
No.
Risk Item Identified / Added Software Failure
Impact of Risk (High / Medium / Medium
Low )
Probability of Occurrences of Low
Risk (High / Medium / Low )
Action Plan (MUST for High Mitigation Plan * Contingency Plan *
Impact Risks or High
Probability of Occurrences of
Risks)
Checking up the Cleaning up database
database and other regularly
software tools
regularly
Names of Affected Groups The whole team
Date Plan ---- As and when it happens
Replan---
Actual ---
Remarks
Risk 5
Risk Identification checklist Sl. 5
No.
Risk Item Identified / Added Virus Attack
Impact of Risk (High / Medium / High
Low )
Probability of Occurrences of Medium
Risk (High / Medium / Low )
Risk 6
Risk Identification checklist Sl. 6
No.
Risk Item Identified / Added Resource attrition
Impact of Risk (High / Medium / High
Low )
Probability of Occurrences of Medium
Risk (High / Medium / Low )
Action Plan (MUST for High Mitigation Plan * Contingency Plan *
Impact Risks or High
Probability of Occurrences of
Risks)
Replace resource with Identify backup resources for
similar skillset in the each critical resource.
shortest time possible Backup resource should be
in sync with the main
resource.
Names of Affected Groups The whole team
Date Plan ---- As and when it occurs
Replan---
Actual ---
Remarks
Risk 7
Risk Identification checklist Sl. 6
No.
Risk Item Identified / Added Technology/Platform Obsolescence
Impact of Risk (High / Medium / Low
Low )
Probability of Occurrences of Low
6 Assumptions/Dependencies/Limitations
Assumptions
1)The data to be used for development and testing of COA application would be derived
from the existing information in the Working Time Tables ( WTT ) for each division across
the Railway network.
2) Certain data like intersectional running times and time loss speed restrictions for goods
trains are derived from historical charts collected over a period of time.
2) The data that is received from external sources like FOIS is assumed to be consistent
and accurate.(mentioned
Dependencies
The integration of various sub systems with COA application will be having the following
dependencies.
1)The readiness of FOIS subsystem in terms of the the necessary client software
developed and tested prior to integration
2)The readiness of NTES to receive the messages/files from the messaging server
Limitiations
The following are the limitations of the proposed COA Application.
1) The Advance Plotting functionality is only a guiding feature to assist the user. It just
gives a visual representation of possible train movements and is not intended to control
the same.
7 Acceptance Criteria
Approach
In order to identify errors at an early stage and hence prevent a breakdown at a later
stage, various levels of the testing will be carried out for this project. Test plans will be
prepared, reviewed and approved before testing commences. Test plan will be
documented and testing will be done as per the approved plan. Listed below are the
various kinds of testing that is identified for various stages of the project.Rational Rose
shall be used for this purpose
• Unit testing
• Integration testing
• Acceptance testing
• Stress testing
All the above levels of testing planned will be conducted systematically. The activities that
are to be carried out for each of these testing will include:
• Test planning
• Test case preparation
• Test execution
Unit Testing
Activities that will be followed for Unit Testing are the following. The Unit test plan shall
ensure the following activities
• Ensure that instructions related to the test cases are executed properly.
• Verify operation at normal value range.
• Verify operation outside range values.
• Verify program execution at boundary conditions.
• Ensure that all loops are terminated normally.
• Identify and remove abnormal termination of all loops.
• Ensure all errors are trapped.
• Ensure all the objects opened are closed
Integration Testing
When all the modules are fully developed functionally, all these modules will be integrated
and tested for all types of compatibility issues and other kind of issues. For this testing all
the above mentioned checkpoints will be there. These tests will be derived from the design
document.
At the end of these testing the following documents will be made and handed over to the
concerned people.
Test Cases (Unit test cases, Integrated test Cases)
Proof of testing done.
Acceptance Testing
The acceptance test plans will be made and will be handed over to CRIS. The CRIS
representative can check the acceptance test plans and verify that the whole functionality
is covered to ensure the computer system will fit the operational procedures.
Acceptance Criteria
Wipro team and CRIS Team will evolve acceptance test specification during the end of the
design phase. Wipro proposes that, the successful execution of Acceptance Test plans in
the Acceptance test environment shall be the acceptance criteria for this project.
Acceptance Process
The acceptance procedure shall be
CRIS needs to conduct Acceptance testing within two weeks from the date of delivery of
the software for acceptance testing phase. It is assumed that CRIS will perform similar
acceptance process on all other deliverables and will complete the acceptance with in 5
days from the delivery.
9 Others
11 Signoffs
Requirements for Control Office Application (COA)
As per the requirement study conducted by Wipro team, this document includes the complete list of
requirements of the Control Office Application(COA)