Changes between Version 2 and Version 3 of InstructionsP4


Ignore:
Timestamp:
12/16/25 13:33:33 (12 days ago)
Author:
vangel.ajanovski
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • InstructionsP4

    v2 v3  
    11= Instructions on Phase P4: First Application Prototype
    22
    3 Се изработува минимален прототип во кој треба да профункционираат сценаријата кои се означени како главни и направени во претходната фаза од проектот. Не се бара целосна апликација, туку само мал, макар и импровизиран прототип, со минимум функционалности врз жива база на податоци според опишаните избрани најважни сценарија.
    4 * Прототипот треба да покаже како би се имплементирале основните елементи на најважните сценарија при поврзување со базата на податоци.
    5 * Прототипот може да го правите во произволна технологија. Може да биде изработен и целосно во најосновно програмирање во било кој програмски јазик, со влез и излез на командна линија, без да имате никакви други претходни познавања за програмирање целосни апликации и познавања од рамки за развој на апликации со целосен кориснички интерфејс и работа со бази на податоци.
    6 * Прототипот не треба да биде ниту комплексен, ниту особено софистициран, бидејќи целта е само да покажете дека дизајнот на базата е успешен и може да поддржи некоја минимална функционалност со пристап до базата.
     3A minimal prototype is being developed in which the scenarios that are marked as main and made in the previous phase of the project should function. A complete application is not required, but only a small, albeit improvised prototype, with a minimum of functionalities on a live database according to the described selected most important scenarios.
     4* The prototype should show how the basic elements of the most important scenarios would be implemented when connecting to the database.
     5* You can make the prototype in any technology. It can also be developed entirely in the most basic programming in any programming language, with command line input and output, without having any other prior knowledge of programming full applications and knowledge of frameworks for developing applications with a full user interface and working with databases.
     6* The prototype should be neither complex nor particularly sophisticated, since the goal is only to show that the database design is successful and can support some minimal functionality with access to the database.
    77
    8 Довршувањето на апликацијата е предмет на подоцнежните фази.
     8The completion of the application is subject to later stages.
    99
    10 **Рокови**
     10**Deadlines**
    1111
    12 Протипот треба да се презентира на јавна презентација пред сите останати студенти на предметот која ќе биде закажана во термини по избор на крајот на јануари.
     12The prototype should be presented at a public presentation to all other students in the course, which will be scheduled at a time of your choice at the end of January.
    1313
    14 Овој рок е фиксен и е услов за продолжувањето со работа на проектот. Секое пролонгирање ќе значи закочување на следните фази од проектот кои се неопходни за оценување и намалување на поените.
     14This deadline is fixed and is a condition for continuing work on the project. Any extension will mean blocking the next stages of the project, which are necessary for assessment and reduction of points.
    1515
    16 По барање на група студенти, може да се организираат и термини за презентација пред или на самиот почеток на испитната сесија.
     16At the request of a group of students, presentation times can also be organized before or at the very beginning of the examination session.
    1717
     18**Details on the development**
    1819
    19 **Детали за изработката**
     20What must be developed:
    2021
    21 Елементи што мора да ги исполнувате:
     22* Each team member must have implemented at least one scenario from the list of most important use cases described in P3.
     23* The scenario should function in such a way that at no point will the user be expected to remember identifiers and codes, but all necessary choices will be listed and if some data needs to reference some other data, the necessary reference will be selected from a list instead of entering codes that they need to remember
     24* At least 3 scenarios from the list in the previous phase must be implemented
    2225
    23 * Секој од членовите на тимот, да има имплементирано по барем едно сценарио од листата најважни случаи на употреба опишани во P3.
    24 * Сценариото треба да функционира така што во никој момент нма да се очекува корисникот да помни идентификатори и кодови, туку сите потребни избори ќе му бидат излистани и ако треба некој податок да референцира некој друг податок, потребната референца ќе ја избере од листа наместо да внесува кодови кои треба да ги запомни
    25 * Да бидат имплементирани најмалку 3 сценарија од листата во претходната фаза
     26In the prototype and documentation, do not use images, materials and examples for which you have not explicitly obtained the right to use. It is not enough that they are available somewhere online, if you want to use some materials, it needs to be under a license that covers your type of usage.
    2627
    27 Во прототипот и документацијата не користете слики, материјали и примери за кои немате експлицитно добиено право на користење. Не е доволно да ги има некаде онлајн, за да смеете да користите некој материјал ви треба да е под лиценца која  ви го дозволува да го користите.
     28For the final evaluation of your application prototype, in order to form a grade for the course, you need to have the following elements in the documentation:
    2829
    29 За финално оценување на вашиот прототип на апликација со цел формирање оценка на предметот е потребно да ги имате следните елементи во документацијата:
     30* Create and link a wiki page called **PrototypeImplementation** linked to the main project page in the appropriate phase.
     31* A short presentation of each of the implemented use-cases, documented on the PrototypeImplementation wiki page. The documentation is in the form of the original documentation for each of the cases, as in the previous phase, but expanded with the actual implemented SQL statements in each step and screenshots of each step, placed respectively on the **UseCaseXXXXPrototypeImplementation** pages that will be linked from the **PrototypeImplementation** page.
     32* Your source code should be published in your git repo assigned for your DEVELOP project/documentation site.
     33* Short instructions on how to compile, package and run your prototype from the source code posted on DEVELOP, should be published on the **BuildInstructions** wiki page, linked to the **PrototypeImplementation** page.
    3034
    31 * Креирајте и линкувајте вики страница под име **PrototypeImplementation** линкувана на главната страница во соодветната фаза во која
    32 * кратка презентација на секој од имплементираните use-case, документирана на вики страницата PrototypeImplementation. Документацијата е во вид на оригиналната документација за секој од случаите, како во претходната фаза, но проширена со реално имплементираните SQL наредби во секој чекор и снимки од екранот во секој чекор, поставени соодветно на страниците **UseCaseXXXXPrototypeImplementation** кои ќе бидат линкувани од **PrototypeImplementation** страницата.
    33 * вашиот изворен код да биде поставен во вашиот git repo на вашиот проектен/документациски сајт на DEVELOP
    34 * кратки инструкции како да се компајлира, спакува и стартува вашиот прототип од изворниот код поставени на DEVELOP, поставени на wiki страница **BuildInstructions**, линкувана во **PrototypeImplementation** страницата.
     35Template for the prototype implementation wiki page.
    3536
    36 Вики страницата **BuildInstructions** треба да ги содржи следните информации:
     37{{{#!box information
    3738
    38 * Каков софтвер е предуслов да се има за да може да се искомпајлира, изгради, инсталира, конфигурира и стартува вашиот проект
    39 * Објаснение како да се тестира апликацијата откако ќе се стартува:
    40  * Ако е веб, на која адреса ќе се активира и кориснички имиња и лозинки, ако е десктоп или мобилна апликација, како да се стартува и корисници и лозинки
    41 * Мини упатство за користење, чекор по чекор, во кое ги наведувате главните елементи од апликацијата и како се користат
     39= Prototype Implementation
    4240
    43 Ажурен изворен код испратен преку git на DEVELOP
     41Implemented use-cases:
     42* UseCaseXXXXImplementation
     43* ...
    4444
    45 * Ова не е потребно за јавна презентација на прототип, туку е потребно за оценување на P5 и пред да продолжите на P6 и P7.
    46 * Инструкции за пристап до репозиториумите ќе имате во EPRMS во секцијата Repositories.
     45}}}
    4746
    48 Детали за изворниот код:
     47Template for the use-case implementation wiki page.
    4948
    50 * целиот изворен код потребен за да се стартува вашата прототип апликација
    51   * изворниот код од апликацијата
    52   * скриптите за генерирање табели во базата
    53   * скриптите за пример податоци во табелите во базата
    54 * со кодот не праќајте дополнителни работи кои не се ваши
    55   *       ако користите туѓи кодови - тргнете ги и напишете скрипта што ќе симне сѐ што треба од каде што треба или наведете во упатството детали за градење извршна верзија кои автоматски ќе симнат сѐ плус што е потребно
    56   *        ако користите туѓи рамки и стилови - тргнете ги и напишете скрипта што ќе симне сѐ што треба од каде што треба или наведете во упатството детали за градење извршна верзија кои автоматски ќе симнат сѐ плус што е потребно
    57   *       ако користите туѓи библиотеки - тргнете ги и напишете скрипта што ќе симне сѐ што треба од каде што треба или наведете во упатството детали за градење извршна верзија кои автоматски ќе симнат сѐ плус што е потребно
    58   * ако користите извршни верзии од туѓи програми - тргнете ги и напишете скрипта што ќе симне сѐ што треба од каде што треба или наведете во упатството детали за градење извршна верзија кои автоматски ќе симнат сѐ плус што е потребно
    59   * ако користите слики во проектот кои не се ваши - тргнете ги и напишете скрипта што ќе симне сѐ што треба од каде што треба или наведете во упатството детали за градење извршна верзија кои автоматски ќе симнат сѐ плус што е потребно
     49{{{#!box information
    6050
    61 Доколку не сакате вашиот изворен код и/или проект да остане јавно достапен, може да ги смените параметрите за привилегии на вашиот проектен сајт во делот за администрација - да биде достапен само за определени групи корисници. Ако треба помош за поставување контактирајте го наставникот.
     51= Use-case XXXXX Implementation - Use-case title
     52
     53Initiating actor:
     54
     55Other actors:
     56
     57Description of the use-case goals in several sentences.
     58
     59Scenario:
     60 1. User does what. Screenshot.
     61 2. System does what. Screenshot. If the system accesses the database, include the exact SQL command to detail what data will be needed from the database, or what data will be modified in the database. Show real and tested SQL commands.
     62 3. ...
     63
     64}}}
     65
     66The **BuildInstructions** wiki page should contain the following information:
     67
     68* What software is required to compile, build, install, configure, and launch your project
     69* An explanation of how to test the application once it is launched:
     70* If it is a web application, where to launch it and what usernames and passwords it will use, if it is a desktop or mobile application, how to launch it and what usernames and passwords it will use
     71* A step-by-step mini-guide that lists the main elements of the application and how to use them
     72
     73{{{#!box information
     74
     75= Build Instructions
     76
     77Development environment description
     78
     79Build instructions
     80
     81Testing instructions
     82
     83}}}
     84
     85Up-to-date source code sent via git to DEVELOP:
     86
     87* This is not required for a public prototype presentation, but is required for the evaluation of P5 and before continuing to P6 and P7.
     88* Instructions for accessing the repositories will be available in EPRMS in the Repositories section.
     89
     90About the source code:
     91
     92* all source code needed to run your prototype application
     93* the source code from the application
     94* scripts for generating tables in the database
     95* scripts for sample data in the database tables
     96* do not send additional work that is not yours with the code
     97* if you use other people's codes - remove them and write a script that will download everything you need from where you need it or specify in the instructions details for building an executable version that will automatically download everything plus what is needed
     98* if you use other people's frameworks and styles - remove them and write a script that will download everything you need from where you need it or specify in the instructions details for building an executable version that will automatically download everything plus what is needed
     99* if you use other people's libraries - remove them and write a script that will download everything you need from where you need it or specify in the instructions details for building an executable version that will automatically download everything plus what is needed
     100* if you use other people's executables - remove them and write a script that will download everything you need from where you need it or specify in the instructions details for building an executable version that will automatically download everything plus what is needed
     101* if you use images in the project that are not yours - remove them and write a script that will download everything you need from where you need it or specify in the instructions details for building an executable version that will automatically download everything plus what is needed
     102
     103If you do not want your source code and/or project to remain publicly available, you can change the privilege settings of your project site in the administration section - to be available only to certain groups of users. If you need help with this setup, contact your teacher.
    62104
    63105**AI Use**