Merge 4ef0aca into 09beee6

README.adoc

@@ -6,6 +6,25 @@ image:https://www.ohloh.net/p/gymy-seminar/widgets/project_thin_badge.gif["Ohloh
 
 A seminar grouping system.
 
+=== Problem statement
+
+A school provides custom curriculum for all senior students, as a means of preparation for graduation and successive studying.
+The school lists classes (called "seminars") and students select a subset, which they wish to study the next term.
+
+A Teacher teaches a specific Seminar. Students select Seminars. Seminars can be split up into Subseminars, if the demand
+is greater than the capacity (the number of Subseminars per each Seminar is set manually).
+Seminars are assigned into groups (or blocks) which are taught at the same time.
+
+The respective hard constraints that have to be met are:
+
+* Students have to pick a selected number of Seminars.
+* pass:[<strike>Teachers cannot teach two seminars in one Group.</strike>]
+
+The soft constraints that should be optimized:
+
+* Students cannot attend two seminars that are planned into one Group.
+* Students can be assigned any of the Subseminars of a Seminar they chose, such that it minimizes collisions with other constraints.
+
 === Building
 * *Recommended*: `mvn clean install -DskipTests`
 * To run *unit tests*: `mvn clean install`

data/seminar/import/gymy2014-2.sem

@@ -3,6 +3,7 @@ Groups: 3
 Seminars: 13
 Students: 48
 Teachers: 1
+ChooseSeminars: 3
 
 TEACHERS:
 NONE

data/seminar/import/gymy2014-4.sem

@@ -3,6 +3,7 @@ Groups: 4
 Seminars: 10
 Students: 48
 Teachers: 1
+ChooseSeminars: 3
 
 TEACHERS:
 NONE

data/seminar/import/simple5.sem

@@ -3,6 +3,7 @@ Groups: 3
 Seminars: 5
 Students: 20
 Teachers: 3
+ChooseSeminars: 2
 
 TEACHERS:
 t01

data/seminar/import/unsolvable5.sem

@@ -3,6 +3,7 @@ Groups: 3
 Seminars: 5
 Students: 20
 Teachers: 3
+ChooseSeminars: 2
 
 TEACHERS:
 t01