Take advantage of the Model inheritance provided by polymodel.PolyModel to
have Club, School, Sponsor, and Organization actually inherit from the Group
Model class, rather than being composed via ReferenceProperties.
Patch by: Todd Larsen
Review by: Pawel Solyga, Sverre Rabbelier, Augie Fackler
Review URL: http://codereviews.googleopensourceprograms.com/606
#!/usr/bin/python2.5
#
# Copyright 2008 the Melange authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""This module contains the Administrator Model."""
__authors__ = [
'"Todd Larsen" <tlarsen@google.com>',
]
from google.appengine.ext import db
import soc.models.person
class Role(soc.models.person.Person):
"""Information common to Program participation for all Roles.
Role is the entity that is created when a Person actually participates
in some fashion in a Program. Person details could *possibly* be collected
without actual participation (voluntary, opt-in, of course).
A Role is a Person's participation in a single Program. To avoid
duplication of data entry, facilities will be available for selecting
an existing Role associated with a particular User to be duplicated for
participation in a new Program.
A Person has to have at least one Role in order to be able to create
any Work (such as a Document) on the site. The easiest-to-obtain Role is
probably Club Member (though Clubs can set their own membership criteria).
A Role entity participates in the following relationships implemented
as a db.ReferenceProperty elsewhere in another db.Model:
documentation) a 1:many relationship of Documentation (tax forms,
letters from schools, etc.) associated with the Role by Hosts. This
relation is implemented as the 'documentation' back-reference Query of
the Documentation model 'role' reference.
works) a many:many relationship with Works, stored in a separate
WorksRoles model, representing the Work authored by this Role.
See the WorksRoles model class for details.
"""
pass