updated comments

person.py

@@ -17,7 +17,14 @@ import json
 # pylint: disable=no-member
 
 ################################################################################
-# Class describing Person in the database, and via sqlalchemy, connected to the DB as well
+# Class describing Refimg in DB via sqlalchemy
+#   fname: original file name of refimg
+#   face: actual binary of numpy data for this refimg's face (always only 1)
+#   orig*: width/height of original image, because when we show in person, it get scaled
+#   face_locn: location of ace - we need to know to draw green box around face locn (with orig* above)
+#   thumbnail: image data of actual img.  once we load refimg, we only store this data, not the orig file
+#   model_used: which AI model (cnn or hog) used to create face
+#   person: read-only convenience field not in DB, just used in html
 ################################################################################
 class Refimg(db.Model):
     id = db.Column(db.Integer, db.Sequence('refimg_id_seq'), primary_key=True )
@@ -34,6 +41,9 @@ class Refimg(db.Model):
     def __repr__(self):
         return "<id: {}, fname: {}>".format(self.id, self.fname )
 
+################################################################################
+# Class describing Person to Refimg link in DB via sqlalchemy
+################################################################################
 class PersonRefimgLink(db.Model):
     __tablename__ = "person_refimg_link"
     person_id = db.Column(db.Integer, db.ForeignKey('person.id'), unique=True, nullable=False, primary_key=True)
@@ -43,6 +53,9 @@ class PersonRefimgLink(db.Model):
         return f"<person_id: {self.person_id}, refimg_id: {self.refimg_id}>"
 
 
+################################################################################
+# Class describing Person in DB via sqlalchemy
+################################################################################
 class Person(db.Model):
     id = db.Column(db.Integer, db.Sequence('person_id_seq'), primary_key=True )
     tag = db.Column(db.String(48), unique=False, nullable=False)
@@ -85,7 +98,7 @@ def persons():
  
 
 ################################################################################
-# /person -> GET/POST -> creates a new person type and when created, takes you back to /persons
+# /person -> GET/POST -> creates a new person and shows new creation
 ################################################################################
 @app.route("/person", methods=["GET", "POST"])
 @login_required
@@ -108,8 +121,7 @@ def new_person():
             return render_template("person.html", person=person, form=form, page_title = page_title)
 
 ################################################################################
-# /person/<id> -> GET/POST(save or delete) -> shows/edits/delets a single
-# person
+# /person/<id> -> GET/POST(save or delete) -> shows/edits/delets a single person
 ################################################################################
 @app.route("/person/<id>", methods=["GET", "POST"])
 @login_required