Laborator 1

Editarea documentelor.

Unelte si tehnologii pentru managementul proiectelor:

  • Microsoft Word
  • PDF
  • Latex
  • Google Docs
  • Office Live
  • Microsoft Visio, StarUML

Concepte:

  • Sistem Requirements Specifications (SRS)
  • UML Use-case

Documentatie laborator

Sistem Requirement Speciffications

Dupa primirea documentului de cerinte ale clientulului si dupa analiza in detaliu a acestora, contractorul (implementatorul solutiei) redacteaza documentele de specificatie. Acestea trebuie sa descrie in mod clar, far interpretari ce trebuie sa faca sistemu si in ce parametri de performanta. Pe baza acestor documente se vor realiza estimariel de timp, buget si resurse, se va conce arhitectura sistemului si se va face evaluarea final a proiectului.

Un document SRS contine:

  • Scopul documentului (Document purpose)
  • Conținutul documentului (Document overview)
  • Descrierea generală a produsului (General description of the product)
  • Situația curentă (The current situation)
    • Misiunea proiectului (Purpose of the product)
    • Contextul proiectului (Product context)
    • Beneficii (Benefit)
  • Cerințe funcționale (Functional requirements)
    • Actori (Actors)
    • Diagrama de sistem (System boundary)
    • Descrierea cazurilor de utilizare (Use cases description)
  • Cerințe nefuncționale (Non-functional requirements)
    • Cerințe de interfață (User Interface Requirements)
    • Cerințe de performanță (Performance Requirements)
    • Cerințe de fiabilitate (Availability & Reliability)
    • Cerințe de securitate (Security Requirements)

Diagrame UML use-case

Diagramele use-case sau diargamele cazurilor de utilizare sunt folosite pentru capturarea şi reprezentarea funcţionalităţilor sistemului. Elementele asociate cu diagramele cazurilor de utilizare sunt actorii şi cazurile.

Un actor este o entitate externă sistemului care interacţionează cu acesta. Un actor descrie un rol pe care un utilizator sau un alt sistem îl joacă în cadrul sistemului descris.

Un caz de utilizare descrie o funcţie a sistemului sau un serviciu pe care acesta îl pune la dispoziţie altor sisteme sau utilizatorului extern. Cazurile sun reprezentate grafic sub forma unor elipse ce conţin în interiorul lor numele acelui caz. Numele cazurilor trebuiesc alese cât mai sugestiv pentru a evidenţia funcţiile pe care acestea le îndeplinesc. În mod uzual numele unui caz trebuie să conţină un verb.

Fiecare dintre cazurile prezentate într-o diagrama a cazurilor de utilizare trebuie documentat. Există diferite şabloane folosite în acest scop, în continuare fiind prezentat unul dintre acestea:

  • Use-Case name: the name of the use-case.
  • Summary: goal to be achieved by use-case.
  • Actors: the actors involved in this use-case (the actors which are benefit from this use-case).
  • Pre-conditions: conditions that must be true for this use case to be executed correctly.
  • Description: Detailed description of the use-case.
  • Alternatives: Alternative use-cases which with similar functionalities.
  • Post-conditions: Describes the state of the system after exit of use case.

Plecand de la diagrama use-case de mai sus doua exemple de utilizare a sablonului sunt prezentate in continuare:

  • Use-Case name: Control Process
  • Summary: The operator has full control of the scanning system.
  • Actors: Operator
  • Pre-conditions:
  • Description: The system is powered on by the operator. The system can be shutdown in any moment by the operator. The operator monitor the working parameters of the process by having access to the following parameters: total processed units, defective units detected, state of the conveyor belt, scanner and the defective containers removal robot.
  • Alternatives: -
  • Post-conditions: -
  • Use-Case name: Process Container
  • Summary: The containers are processed by the system.
  • Actors: Belt
  • Pre-conditions: The system is powered on and configured.
  • Description: The container is placed on the conveyor belt. The container is moved in front of the scanner. The container is detected. The id of the container is read. The container is scanned for defects. If a defective container is found, the id of the container is sent to the robot for removal.
  • Alternatives: -
  • Post-conditions: defective containers are removed.

Exemplu document SRS

Latex

TeX (X sau chi se pronunţă ca în cuvântul scoţian loch) este un limbaj de markup şi de programare low-level creat de Donald Knuth pentru redactarea atractivă şi consistentă a documentelor. LaTeX (pronounţat fie “Lah-tech”, fie “Lay-tech”) este un pachet macro bazat pe TeX creat de Leslie Lamport. Scopul său este să simplifice redactarea TeX, mai ales pentru documente ce conţin formule matematice.

Manual de utilizare latex.

Office Live

Office Live este Extensia web la populara suita Office permite utilizatorilor sa creeze, sa editeze si sa share-uiasca documente sau proiecte online. Microsoft ofera de asemenea spatiu de stocare pentru utilizatori.

Office Live

Google Docs

Similar cu Office Live, Google Docs este un portal Google ce ofera utilizatorilor acces la functionalitati pentru crearea si editarea documentelor. O descriere mai detaliata a facilitatilor oferite de acest produs gasiti aic.

PDF

PDF (Portable Document Format) este un format de fişier care păstrează macheta şi aspectul documentului intacte, astfel încât acesta arată exact cum a fost realizat şi poate fi tipărit corect, oriunde şi pe orice imprimantă. În industria tipografică, este folosit tot mai mult pentru a transfera date între diverse programe de tehnoredactare-DTP, fără a suferi nici o modificare. Detalii despre formatul PDF gasiti aici (inclusiv recomandari pentru unelte pentru manipularea documentelor in acest format).

Microsoft Visio

Visio este un program comercial conceput de Microsoft pentru desenarea de diagrame utilizand grafica vectoriala. Acesta poate fi folosit pentru desenearea a diferite tipuri de diagrame (vine cu o gama larga de template-uri si de tipuri de tiagrame preinstalate). Visio poate fi folosit inclusiv pentru desenarea de diagrame UML.

Exerciti

Exercitii diagrama de sistem

1. Sa se determine actorii si sa se construiasca diagrama uml use case in Visio sau StarUML pentru o aplicatie software ce implementeaza activitatile specifice secretariatului Facultatii de Automatica si Calculatoare.

2. Sa se editeze in word si sa se salveze in format Word si PDF un document ce contine diagrama definita la punctul anterior si descrierea actorilor si a cazurilor de utilizare.

Exercitii SRS

3. Sa se identifice specificatiile functionale si nonfunctionale ale proiectului.

4. Sa se realizeze in Word documentul SRS. Sa se salveze documentul in format Word si in format PDF.

Optional

Proiect

Creati propriul CV si atasati-l in Redmine la proiect.

Sa se elaboreze documentul SRS pentru tema de licenta.