Specifications of requisites for Donantonio Juan Jose Amor David Escorial Ismael Olea $Id: doc-ers_ieee830-donantonio.en.xml,v 1.8 2002/11/17 14:54:58 manuelcanales Exp $ This document is a Specification of Software Requeriments (SSR) for the bibliographic system for automatic distribuited publication Donantonio. All this contents has been elaborated considering the needs observed by the experience of the authors of Internet's publication. This specification has been structured inspired in the directrixes gived by the standard IEEE Recommended Practice for Software Requirements Specification ANSI/IEEE 830 1998. The object of the specification is to define in a clear and exact way all the functionalities and restrictions of the system it wants to build. The document goes directed so much to the development equipment, like the members of the projects of free documentation and the community of possible end users. This document will be the communication channel between the implied parts, taking part in its preparation, members from each part. This specification is subject to revisions by the implied parts, specially by the potentials usuaries, that will be picked up by successive versions of the document, until reach its approval. Once approved it will serve as base to the equipment of development for the construction of the new system. This system is required as a result of the increasing complication of the publication workings of documentation of free software. It's evident the needed of a informatic system that it automates the publication workings of documents in Internet, in such form that are guaranteed the easy location of them and a fast availability to the users. Using bibliographical norms it can become general the use and application of the system to any type of information susceptible to be classified. The scope of the developed system reaches until the production of clients and servers for Donantonio, communication protocols between them and user interfaces; preferring the design of a system that can be embedded in other compatible applications so these can as well be compatible applications (clients, servers or interfaces) with Donantonio. Resource Element accessible through a URL susceptible to be classified bibliographically. Scheme It describes the syntax of a description. Description Instance of a scheme that it identifies by metadata, in a unequivocal way to a resource. Library Collection of descriptions. Server Node that takes care of donantonio's queries. Client Node that produce donantonio's queries. Query Request of a subgroup of descriptions expressed in a standardized language. SSR Specification of Software Requirements GFDL GNU Free Documentation License GPL GNU Public License RDF Resource Description Framework, standard of the World Wide Web Consortium (W3C) for the codification and handling of metadata using the markup language XML. URL Uniform Resource Locator, scheme used for the localization of a internet resource. XML eXtended Markup Language, standard of the W3C. They have not been defined. IEEE Recommended Practice for Software Requirements Specification. ANSI/IEEE std. 830, 1998. OMF, GNU, GFDL, GPL, RDF, XML, URL? Note: In the previous list the really necessary references must go. That is, a sieve on the list that appears in specifications.sgml This document is formed by three sections. This section is the Introduction and provides a general vision of the SSR. In the Section 2 we give a general description of the system, with the purpose of knowing the main functions what must make the system, the data associate and the factors, restrictions, supposed and dependencies that affect the development, without enter in excessive details. In section 3 the requirements are defined in detail what must satisfy the system. This system will not interact with any other software system The system will allow to publish resources located in any place of Internet. Each resource will be located by its description, that will be in the Donantonio servers, and therefore, it will not have why to coincide with the publication place of the resource. Each description will have a publication point, from which a donantonio server incorporates it to his library through the registry process. The registry will be distributed, in the systems that we will denominate donantonio servers. The donantonio servers will include mechanisms or protocols to admit the total or partial replication of the descriptions, that will ask for the called donantonio clients. For this aim, the servers will have to be able to take care of queries of descriptions, for which the corresponding mechanisms or protocols will be defined. The donantonio User Interface will implement suitable mechanisms of navigation and search of the information The descriptions could be replicated through donantonio networks. A hierarchy in the server network does not setted, that is, all will treat between equals The made system will have to offer an intuitive user interface, easy to learn and simple to handle. The system will have to display a high degree of usability. The desirable thing would be that a new user became familiar with the system in short time, for the immediate use for the functions of resources search. The system will be free software (in agreement with the GNU-GPL license or similar) and will have to be free those components that it reuses. The system will be designed according to a client/server model. The system will based its communications on standard Internet protocols. The different subsystems must have a simple design and implementation, independent of the platform or the programming language. The servers must be able to attend queries of a concurrently way. It is assumed that the requirements described in this document are stable once is approved by the design team taking care of suggestions of the community. Any request of changes in the specification must be approved by the design team and be managed by the same one. The Donantonio system works independently, with no need to communicate with other external systems, reason why there are no dependencies respect to other systems. In this section the it shows the functional requirements that will have to be satisfied by the system. All the requirements exposed here are ESSENTIAL, that is, a system would not be acceptable that does not satisfy some of the requirements presented here. These requirements have been specified considering, among others, the criterion of testing: given a requirement, it would have easily to be demonstrable if it is satisfied or not by the system. Note: It is convenient to make the "requirements matrix", that confronts the requirements with the verification method. The system must register descriptions of resources (metadata and the corresponding URL localizer). All donantonio server will implement query mechanisms that allow to select from a client a set of the descriptions that this one has. All donantonio server will allow the export of a selected set of descriptions. All donantonio client will implement query mechanisms that allow acess in a server to a set of the descriptions that this one has. All donantonio client will be able to replicate a set of descriptions obtained from donantonio server through a selection criterion of the defined ones in REQ04. The servers will be independent to able give the service independently to the clients. The descriptions will have to be unique in each library. The system will count with an user interface who allows to make the queries of descriptions easily and to access to the referenced resources of a query. They have not been defined. They have not been defined. The servers, clients and applications donantonio will communicate to each other through standard protocols in Internet, whenever it is possible. For example, to transfer files (resources or blocks of descriptions) existing protocols will have to be used (FTP or another convenient one). The response times to the interactive queries will have to be reduced, considering a efficient communication network. The system will have to support concurrent attention to the queries. The chosen life's cycle to develop the system will be the evolutionary prototype, so changes and new functions can be incorporated easily. The bibliographical schemes to use in the system will be expressed in RDF. The system will be free software and, therefore, any software component that it will be reused will have to be free. The system will be designed portable. It will have to be possible to implement applications donantonio in diverse languages and platforms. The system is susceptible to be extended. Therefore it will have to be designed easily supported, applying for his development the methodologies what it be precise for that. Donantonio: Specification of Software Requirements Copyright (c) 2000 Juan J. Amor, David Escorial and Ismael Olea. Permission is granted to reproduce total or partially this document, as long as the source is mentioned. Any modification of this document will have to be approved by the authors.