NamLITS Functional Specification v1 - MCA Namibia

1 CONFIDENTIAL Page 1 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc NamLITS Functional Specification VERSION CONFIDENTIAL Page 2 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc TABLE OF CONTENTS TABLE OF CONTENTS .. 2 VERSION CONTROL .. 3 PURPOSE OF THIS DOCUMENT .. 4 BACKGROUND .. 4 PURPOSE .. 4 NamLITS TECHNICAL OVERVIEW .. 5 INTRODUCTION .. 5 NamLITS TECHNICAL PLATFORM .. 5 NamLITS WAN/ LAN TOPOGRAPHY .. 6 INTEGRATION .. 7 NamLITS Functional OVERVIEW .. 8 INTRODUCTION .. 8 NamLITS USER GROUPS .. 8 KEY FEATURES .. 9 MAJOR FUNCTIONS .. 10 Functional Specification .. 12 EXPLANATION OF Functional Specification .

2 12 MAPPING OF MENU & SCREENS TO MAJOR FUNCTIONS .. 13 A. COMMON DESIGN .. 18 B. MANAGE BUSINESS UNITS, OFFICES, USERS, MODULES, FUNCTIONS & JOB DESIGNATIONS .. 20 C. MANAGE STOCK INSPECTION UNITS .. 27 D. MANAGE STOCKBRANDS .. 36 E. MANAGE LIVESTOCK .. 40 F. MANAGE INVENTORY .. 48 G. MONITOR & CONTROL LIVESTOCK MOVEMENT .. 54 H. MONITOR & CONTROL LIVESTOCK IMPORT/ EXPORT .. 74 I. MONITOR & CONTROL LIVESTOCK GATHERINGS .. 83 J. MONITOR & CONTROL LIVESTOCK SLAUGHTER .. 86 K. MANAGE LIVESTOCK HEALTH .. 89 L. MESSAGING .. 91 M. REPORTING .. 93 CONFIDENTIAL Page 3 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc VERSION CONTROL The following versions of this document have been issued: Version Date Issued Issued By Issued To Details 10, February, 2011 Barry Cooper, Tinka Consultancy and Investments cc.

3 Alexander Toto, State Veterinarian, Livestock Identification & Traceability System. Ministry of Agriculture, Water & Forestry. Initial Version 17, February, 2011 Barry Cooper, Tinka Consultancy and Investments cc. Alexander Toto, State Veterinarian, Livestock Identification & Traceability System. Ministry of Agriculture, Water & Forestry. Incorporates changes following meeting with Alex on 15th February, 2011. CONFIDENTIAL Page 4 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc PURPOSE OF THIS DOCUMENT BACKGROUND NamLITS was implemented in 2005 with the objective to identify and trace the movements of Livestock within Namibia s Foot and Mouth Disease (FMD) free zone to the south of the Veterinary Cordon Fence (VCF).

4 NamLITS was initially developed, based on the specifications outlined in the following documents: User Requirements Specification : Meat Board of Namibia Individual Identification and Traceability System, Version , July 2004. Technical Specifications Design and Installation of Software for the Livestock Movement Permit System. NamLITS has been subsequently extensively enhanced and extended over the following 5 years to include additional functionality, such as support for Auctioneers and other interfaces. These significant enhancements have not been documented. PURPOSE This document specifies all of the functionality currently supported by the Namibian Livestock Identification and Traceability System ( NamLITS ) as of February 15, 2011.

5 Since little up to date Specification documentation currently exists, this document has been backwards-engineered, by reviewing and documenting all of the functionality that is present in the system at this time. This document shall be subsequently used as follows: 1. To baseline all of the existing NamLITS functionality so that subsequent changes and enhancements to functionality can be clearly demarked, referenced and documented. 2. To identify existing NamLITS functionality that is not currently captured in the NamLITS -NCA User Requirements Specification , Version but which needs to be supported in the unified NamLITS solution. CONFIDENTIAL Page 5 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc NamLITS TECHNICAL OVERVIEW INTRODUCTION Although this document primarily addresses a Specification of NamLITS functionality, a brief overview of the NamLITS Technical Platform, Infrastructure and Integration is included below.

6 NamLITS TECHNICAL PLAT FOR M NamLITS was developed, implemented and supported by FlexPRO, an information technology company based in Windhoek, Namibia . NamLITS was developed using OpenEdge Advanced Business Language by Progress Software. OpenEdge ABL is a 4GL which incorporates its own relational database (RDBMS) and programming tool. Figure 1 Progress OpenEdge Deployment Platform NamLITS is currently hosted by SALT Essential IT and is accessed remotely via a Wide Area Network (over a Radio Link); via the Internet and via a Multiple Protocol Label Switching (MPLS) platform. Although NamLITS has been set up on a parallel server, OpenEdge is unable to use this and so the application is implemented on a single instance.

7 In addition to the NamLITS application, there is a web application called NamLITS Online which provides limited self service functionality. CONFIDENTIAL Page 6 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc NamLITS WAN/ LAN TOPOGRAPHY Figure 2 below outlines the NamLITS Wide Area Network/ Local Area Network topography design. Figure 2 NamLITS WAN/ LAN topography design. The diagram shows the following: The Directorate of Veterinary Services (Meat Board) Head Office utilises a high bandwidth, low latency 11 Mbps Radio Link connection to connect to the NamLITS Server hosted at SALT. This link not only enables responsive access from the workstations located at the Meat Board, but also enables the NamLITS Disaster Recovery Server to be located there also.

8 The NamLITS Disaster Recovery Server receives a full backup of the Database and Application Server Software every 30 minutes from the Application Server & Database housed at SALT. The various State Veterinary Offices (SVOs) utilise 64 Kbps MultiProtocol Label Switching (MPLS) links accessing the NamLITS Virtual Private Network (VPN). Currently all of these links are provided through Internet Technologies Namibia (ITN). Connectivity is also possible through Dialup sites accessing the NamLITS VPN. CONFIDENTIAL Page 7 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc INTEGRATION NamLITS currently integrates with the following external systems System Integration Overview Auction Agents Systems Import of files to NamLITS containing information related to Livestock Gathering Events Import of files to NamLITS containing Movement Permits, Arrival and Departure Registers and any associated changes in Livestock Ownership.

9 Validate Movement Permit IDs issued by Auction Houses to ensure that the associated Auction Notebook exists. Export Abattoirs Systems Import files to NamLITS containing information related to Livestock Slaughter, including Slaughter Data for Tagged Animals. Stockbrand Register Overnight batch import of Stockbrand (Farmer) records, indexed on Stockbrand ID. Disease Surveillance Database NamLITS and the Disease Surveillance Database (Animal Health) share common database tables, such as Stock Inspection Units and Stockbrands. ETO System NamLITS queries the ETO System to determine the Stockbrand for the new Animal Tags. CONFIDENTIAL Page 8 of 113 NamLITS Functional Specification Tinka Consultancy & Investments cc NamLITS Functional OVERVIEW INTRODUCTION This section provides a Functional overview of NamLITS , including the current users of the system as well as the key features and major functions.

10 NamLITS USER GROUPS DIRECT NamLITS USERS There are approximately 220 DVS personnel that are direct users of NamLITS who utilise the system from the following sites: Directorate of Veterinary Services (DVS) Head Office DVS offices at export abattoirs State Veterinary Offices (SVOs) in Gobabis, Robert Mugabe Street Windhoek, Okahandja, Otjiwarongo, Outjo, Grootfontein, Mariental, Keetmanshoop Animal Health Technicians Offices (AHTOs) Border Offices INDIRECT NamLITS USERS Additionally, the following user groups access NamLITS functionality indirectly through interfaces: Abattoirs MeatCo in Windhoek and Okahandja; Mariental Farmers Meat Market; Aranos Namibian Naturam Meat and Witvlei Meat Auctioneers Agra, Karoo Ochse, Namboer, Blaauwberg and NLA NamLITS ONLINE USERS The NamLITS Online web application is utilized by Stock Brand Holders (mainly Commercial farmers) to perform certain self-service functions described in the features below.