app/soc/models/contributor.py
author Todd Larsen <tlarsen@google.com>
Mon, 29 Sep 2008 15:31:50 +0000
changeset 206 832335761384
parent 181 fdd29818a954
child 207 8ecc2e4198cd
permissions -rw-r--r--
Make use of PolyModel for Works, Documents, etc. Add some (but not all) of the missing Models related to Documents. Refactor site settings to be useful for any "/home" page view. Make the resulting home settings store a reference to the Document, rather than looking up the Document by a hard-code key name. This is to set the stage for Document editing being generic, and then being able to select from some existing documents which one to use as the "/home" static content. This makes it possible to pre-edit several Documents, have them Reviewed, and then quickly change the "/home" page content as a setting, rather than editing the Document in the settings form (though settings forms might still embed the current document into their form for convenience). Patch by: Todd Larsen Review by: Pawel Solyga Review URL: http://codereviews.googleopensourceprograms.com/1001

#!/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 Contributor Model."""

__authors__ = [
  '"Todd Larsen" <tlarsen@google.com>',
  '"Sverre Rabbelier" <sverre@rabbelier.nl>',
]

from google.appengine.ext import db

from soc import models
from soc.models import base
import soc.models.person


class Contributor(base.ModelWithFieldAttributes):
  """Contributor details for a specific Program.

  Some Contributor workflows have the Contributor (acting as an author)
  creating Proposals and desiring for one (or more?) of them to be
  converted into Tasks by Reviewers and Hosts.  Other workflows have the
  Reviewers (acting as an author) proposing Proposals, that Contributors
  claim to convert them into Tasks.

  A Contributor entity participates in the following relationships implemented 
  as a db.ReferenceProperty elsewhere in another db.Model:

   tasks)  a many:many relationship associating all of the Tasks to which
     a specific Contributor has contributed with that Contributor.  See
     the TasksContributors model for details.
  """
  
  #: a 1:1 relationship associating a Contributor with generic Author
  #: details and capabilities. The back-reference in the Author
  #: model is a Query named 'contributor'.
  person = db.ReferenceProperty(reference_class=models.person.Person, 
                                required=True, 
                                collection_name="contributor")