by Davo Smith.
Have you tried looking at any of the standard Moodle modules that do this?
assign, forum, data, quiz (off the top of my head)
They all have functions in 'lib.php' with 'grade' in the name, which is a good starting point.