DFE-Digital / register-early-career-teachers

This application will replace the Manage training for early career teachers service in 2025.
5 stars 0 forks source link

Appropriate body data import #472

Open peteryates opened 2 weeks ago

peteryates commented 2 weeks ago

We'll be importing data from the current AB portal at some point in January.

We expect to import the following data in CSV format.

[!NOTE] I've recorded the IDs as integer but if they're uuid in the source data that's fine too.

[!CAUTION] These are not final and need discussion

Appropriate bodies

Column Type Reason
id integer We won't store this but use it to cross-reference induction periods
name string
dfe_sign_in_organisation_id uuid We'll need this so we can link incoming users to appropriate bodies #453
local_authority_code integer Used for bulk upload (probably - to confirm)
establishment_number integer Used for bulk upload (probably - to confirm)

Teachers

Column Type Reason
trn string Even though it is called number, some have leading zeroes so we need to save them as a string
first_name string
last_name string
extension_length integer
extension_length_unit string We'd expect days, months, weeks, terms here, but they might all be recorded in terms. If they're all terms we can omit this.

Induction periods

Column Type Reason
appropriate_body_id integer used to cross reference appropriate bodies
trn string used to cross reference teachers
started_on date
finished_on date
induction_programme_choice string We're expecting fip, cip and diy here?
number_of_terms integer
emily-prudence-dfe commented 2 weeks ago

This looks good - just to say we'll need to import extensions data at some point too, which isn't included here. The good news is that extensions data is just two fields, linked to a person, and currently stored in the Induction table in DQT.

Column Type Reason
extension_length integer
extension_length_unit string We'd expect days, months, weeks, terms here, but they might all be recorded in terms

Aware we've not designed this in our new data model so the omission makes sense, but we'll need to go back to this.

peteryates commented 1 week ago

Following on from this @gunndabad confirmed:

Following on from a chat with the team we think it's worth looking at converting the other units to terms for consistency is a good idea. If the records with non-term units are history we might not even need to import them.

peteryates commented 6 days ago

Oops I forgot to add trn to induction periods, I've amended the issue above 🤦🏽‍♂️

gracecbrennan commented 4 days ago

This is mostly done - PR will follow today

gracecbrennan commented 2 days ago

Still in progress

gracecbrennan commented 20 hours ago

Made good progress on this yesterday