diff --git a/Rewritten-docs.md b/Rewritten-docs.md index 17b84d6..7d00eab 100644 --- a/Rewritten-docs.md +++ b/Rewritten-docs.md @@ -394,21 +394,21 @@ group, how points are assigned for solutions, ... @todo: merge with next chapter (Solution concept analysis) -None of the existing systems we came across is capable of all the required -features of the new system. There is no grading system which is designed to -support a complicated evaluation pipeline, so this part is an unexplored field -and has to be designed with caution. Also, no project is modern and extensible -so it could be used as a base for ReCodEx. After considering all these facts, -it was clear that a new system has to be written from scratch. This implies, -that only a subset of all the features will be implemented in the first version, -the other in the following ones. +None of the existing projects we came across is capable of all the required +features for the new system. There is no grading system which is designed to +support a complicated evaluation pipeline, so this unexplored field has to be +designed with caution. Also, no project is modern and extensible enough so it +could be used as a base for the new system. After considering all these facts, +it is clear that a new system has to be written from scratch. This implies, that +only a subset of all the features will be implemented in the first version, the +others coming in the following releases. Gathered features are categorized based on priorities for the whole system. The highest priority has main functionality similar to current CodEx. It is a base line to be useful in production environment, but a new design allows to easily develop further. On top of that, most of ideas from faculty staff belongs to -second priority bucket, which will be implemented as part of the project. Most -advanced tasks from this category are advanced low-level evaluation +second priority bucket, which will be implemented as part of the project. The +most complicated tasks from this category are advanced low-level evaluation configuration format, using modern tools, connecting to a university systems and merging separate system instances into single one. Other tasks are scheduled for next releases after successful project defense. Namely, these are high-level @@ -418,30 +418,49 @@ side) and command-line submit tool. Plagiarism detection is not likely to be part of any release in near future unless someone other makes the engine. The detection problem is too hard to be solved as part of this project. -We named the project as **ReCodEx -- ReCodEx Code Examiner**. The name should -point to the old CodEx, but also reflect the new approach to solve issues. -**Re** as part of the name means redesigned, rewritten, renewed, or restarted. +We named the new project as **ReCodEx -- ReCodEx Code Examiner**. The name +should point to the old CodEx, but also reflect the new approach to solve +issues. **Re** as part of the name means redesigned, rewritten, renewed, or +restarted. At this point there is a clear idea how the new system will be used and what are the major enhancements for future releases. With this in mind, the overall -architecture can be sketched. From the previous research, we set up several -goals, which the new system should have. They mostly reflect drawbacks of the -current version of CodEx and some reasonable wishes of university users. Most -notable features are following: +architecture can be sketched. From the previous research, several goals are set +up for the new project. They mostly reflect drawbacks of the current version of +CodEx and some reasonable wishes of university users. Most notable features are +following: - modern HTML5 web frontend written in JavaScript using a suitable framework - REST API implemented in PHP, communicating with database, evaluation backend and a file server - evaluation backend implemented as a distributed system on top of a message - queue framework (ZeroMQ) with master-worker architecture -- worker with basic support of the Windows environment (without sandbox, no - general purpose suitable tool available yet) + queue framework (ZeroMQ) with master-worker architecture +- multi-platform worker supporting Linux and Windows environment (latter + without sandbox, no general purpose suitable tool available yet) - evaluation procedure configured in a YAML file, compound of small tasks connected into an arbitrary oriented acyclic graph - -## Solution concepts analysis +The reasons supporting these decisions are explained in the rest of analysis +chapter. Also a lot of smaller design choices are mentioned including possible +options, what is picked to implement and why. But first, discuss basic concepts +of the system. + +### Basic concepts + +The system is designed as a web application. The requirements say, that user +interface must be accessible from students' computers without installation +additional software. This immediately implies that users are connected to the +internet, so it is used as communication medium. Today, there are two main ways +of designing graphical user interface -- native app or web page. Make nice and +multi-platform application with graphical interface is almost impossible because +of large number of different environments. Also, these applications often +requires installation or at least downloading its files (sources or binaries). +However, creating web application is easier, because every personal computer has +a internet browser installed. Also, browsers supports sort of unified and +standardized environment of HTML5 and JavaScript. CodEx is also web application +and everybody seems happy about it. There are other communicating channels every +user have available like email or git, but they are totally inappropriate for +designing user interfaces on top of them. @todo: what problems were solved on abstract and high levels, how they can be solved and what was the final solution @@ -457,6 +476,7 @@ notable features are following: - judges, discuss what they possibly can do and what it can be used for (returning for instance 2 numbers instead of 1 and why we return just one) - discuss points assigned to solution, why are there bonus points, explain minimal point threshold - discuss several ways how points can be assigned to solution, propose basic systems but also general systems which can use outputs from judges or other executed programs, there is need for variables or other concept, explain why +- where is kept the state (MariaDB) - and many many more general concepts which can be discussed and solved... please append more of them if something comes to your mind... thanks @@ -520,7 +540,7 @@ is a database of exercises which can be assigned to the groups and the users of these groups can submit their solutions for these assignments. The frontend will initiate evaluation of these solutions by the backend and it will store the results afterwards. The results will be visible to authorized users and the -results will be awarded with points according to the score given by the Backend +results will be awarded with points according to the score given by the backend in the evaluation process. The supervisors of the groups can edit the parameters of the assignments, review the solutions and the evaluations in detail and award the solutions with bonus points (both positive and negative) and discuss about @@ -541,13 +561,13 @@ of the users. The frontend developed as part of this project is a web application created with the needs of the Faculty of Mathematics and Physics of the Charles university in -Prague in mind. The users are the students and their teachers, groups -correspond to the different courses, the teachers are the supervisors of these -groups. We believe that this model is applicable to the needs of other -universities, schools, and IT companies, which can use the same system for their -needs. It is also possible to develop their own frontend with their own user -management system for their specific needs and use the possibilities of the -Backend without any changes, as was mentioned in the previous paragraphs. +Prague in mind. The users are the students and their teachers, groups correspond +to the different courses, the teachers are the supervisors of these groups. We +believe that this model is applicable to the needs of other universities, +schools, and IT companies, which can use the same system for their needs. It is +also possible to develop their own frontend with their own user management +system for their specific needs and use the possibilities of the backend without +any changes, as was mentioned in the previous paragraphs. In the latter parts of the documentation, both of the backend and frontend parts will be introduced separately and covered in more detail. The communication @@ -645,7 +665,11 @@ interesting observations will be discussed in this chapter. ### Backend communication -@todo: what type of communication within backend could be used, mention some frameworks, queue managers, protocols, which was considered +@todo: what type of communication within backend could be used, mention some +frameworks, queue managers, protocols, which was considered - why we don't use +CORBA, RabbitMQ and why is ZeroMQ great + +@todo: maybe merge frontend communication into this ### Broker