Create Table: project_status_history

[ericvennemeyer]

Dependency

• Evaluate django-simple-history for history tables #181

Overview

We need to create the project_status_history table so that we can update a shared data store across hackforla.org, vrms, civictechjobs, and tables (onboarding) project.

Details

A table and a model are the same thing

Action Items

• identify and document table description (see spreadsheet under Resources)
  • if not, reach out to PD leads
• compare and check off the data fields (below) against the ERD. Note any fields in the ERD that's missing from the list. (see Resources)
• compare the check off associated tables (below) against the ERD. Note any associated tables in the ERD that's missing from the list (see Resources)
• create a single model in Django (defining schema)
• write a test for the relationships this model will have with other models (e.g., creating a user and assigning them a set of permissions on a project).
• write an API end point
• write API unit tests
• document the endpoint

Resources/Instructions

• See People Depot Resources wiki page for links
  • ERD
  • Table and Field Definitions
  • API Endpoint
• See the wiki page for instructions.

Description

History of project status changes

Data Fields

1. Copied from spreadsheet and checked off according to ERD. (unchecked items indicate a mismatch between ERD and spreadsheet, which requires a review)

   • (PK) id - int - Record Id
   • (PK,FK) project_id - int - Record Id
   • (PK,FK) status_id - int - Record Id
   • updated - timestamp

2. In ERD only (having items here indicates a mismatch, which requires a review)

   • None

Associated Tables

1. Copied from spreadsheet and checked off according to ERD. (unchecked items indicate a mismatch between ERD and spreadsheet, which requires a review)

   • project (many-to-one)
   • project_status (many-to-one)

2. In ERD only (having items here indicates a mismatch, which requires a review)

   • None

[fyliu]

I'm thinking this is actually a join table that gets updated when the project status changes. When a project's status changes, it should trigger a function that will update this table to put an end_datetime on the old status and create a new row for the new status with start_datetime.

This way, we have a timeline of project statuses.

I'm not sure whether django ORM has a way to set a trigger like this.