source: main/waeup.sirp/trunk/src/waeup/sirp/students/interfaces.py @ 6634

##
## interfaces.py
from zope.interface import Interface
from zope import schema
from waeup.sirp.interfaces import IWAeUPObject

class IStudentBase(IWAeUPObject):
    """Representation of student base data.
    """
    student_id = schema.TextLine(
        title = u'Student Id',
        default = u'None',
        required = True,
        )

    name = schema.TextLine(
        title = u'Full Name',
        default = u'Nobody',
        required = True,
        )

class IStudentClearance(IWAeUPObject):
    """Representation of student clearance data.
    """

    date_of_birth = schema.Date(
        title = u'Date of Birth',
        required = True,
        )

class IStudentPersonal(IWAeUPObject):
    """Representation of student personal data.
    """

    perm_address = schema.Date(
        title = u'Permanent Address',
        required = False,
        )

class IStudent(IStudentBase,IStudentClearance,IStudentPersonal):
    """Representation of a student.
    """

class IStudentsContainer(IWAeUPObject):
    """An students container contains university students.

    """

    def addStudent(faculty):
        """Add an IStudent object and subcontainers.

        """

    def archive(id=None):
        """Create on-dist archive of students.

        If id is `None`, all students are archived.

        If id contains a single id string, only the respective
        students are archived.

        If id contains a list of id strings all of the respective
        students types are saved to disk.
        """

    def clear(id=None, archive=True):
        """Remove students of type given by 'id'.

        Optionally archive the students.

        If id is `None`, all students are archived.

        If id contains a single id string, only the respective
        students are archived.

        If id contains a list of id strings all of the respective
        student types are saved to disk.

        If `archive` is ``False`` none of the archive-handling is done
        and respective students are simply removed from the
        database.
        """

class IStudentStudyCourse(IWAeUPObject):
    """A container for student study levels.

    """

    certificate_code = schema.TextLine(
        title = u'Certificate Code',
        default = u'None',
        required = True,
        )