Changes between Version 4 and Version 5 of BossaReference

Timestamp:

Jul 18, 2008, 9:12:42 PM (16 years ago)

Author:

davea

Comment:

--

BossaReference

@@ -2 +2 @@
 == Abstractions ==
 
-A Bossa project has one or more ''applications''.
-The job may consist of a single web page or a sequence of web pages.
+ * A Bossa project has one or more '''applications'''.
+ * A application has a dynamic set of '''jobs'''.
+ * An application has a dynamic set of '''batches''', which are used to group jobs.
+ * Each job has a set of '''job instances''', in progress or completed.
+ * A '''user''' is a person who volunteers to perform jobs.
 
-A application has a dynamic set of ''jobs''.
+Each of these is represented by a table in a MySQL database.
 
-Each job has a set of ''job instances''.
-Each one represents a copy of the job, either in progress or completed.
+Jobs may be marked as '''calibration jobs'''.
+These are jobs for which the answer is known in advance;
+their purpose is to estimate the accuracy of each user.
+Each application has a '''calibration job fraction''';
+this is the probability with which calibration jobs are assigned.
+
+Each job has a '''state''', one of:
+
+'''BOSSA_JOB_EMBARGOED''': the job is not yet eligible to be issued.
+
+'''BOSSA_JOB_IN_PROGRESS''': the job is eligible to be issued.
+
+'''BOSSA_JOB_DONE''': the job has been finished successfully.
+
+'''BOSSA_JOB_INCONCLUSIVE''': the job has finished unsuccessfully
+(typically because a consensus was not reached).
+
+Each job has a floating-point '''priority'''.
+Jobs are assigned to users in order of decreasing priority.
+
+Each job, job instance, and user has an associated '''app data''' - a PHP structure
+whose contents are determined by the project, not by Bossa.
+These structures are stored in the database.
 
 == Volunteer characteristics ==