1. Public Works Department
  2. Data model
Reference

The tables behind Public Works Department

Public Works Department ships with 11 tables, grouped here by the feature that uses them. Every record your team works with lives in one of them, and you can add fields and tables in Proto.

Tables
11
Features
6, plus shared settings
Change it
Add fields and tables in Proto

How the model is organised

Organization

Organizations identify agencies; Projects identify counterparties under an organization; team members connect people and Users to the agency.

Operations

Work packages hold the scoped job, owner, revision, due date and hour budget. Tasks are numbered lines beneath a package. Public work inspections record site observations against a package and organization.

Review and evidence

Record attachments hold package files, review decisions preserve reviewer decisions against revisions, and operation receipts preserve guarded action results.

Reference

Exchange rates provide read-only effective currency rates for the app.

Every table, by feature

Agencies and projects

5 tablesAbout this feature
  • Organizations

    Public works agencies and contracting organizations

  • Projects

    Public works projects and contracted counterparties

    Linked to Organizations
  • Team members

    Staff and contractor personnel linked to an organization and platform user

    Linked to Organizations, Users
  • Users

    Users

    Linked to Users
  • Work packages

    Baseline work packages with lifecycle, budget hours and counterparty scope

    Linked to Organizations, Team members, Projects

Work packages

8 tablesAbout this feature
  • Work packages

    Baseline work packages with lifecycle, budget hours and counterparty scope

    Linked to Organizations, Team members, Projects
  • Projects

    Public works projects and contracted counterparties

    Linked to Organizations
  • Organizations

    Public works agencies and contracting organizations

  • Team members

    Staff and contractor personnel linked to an organization and platform user

    Linked to Organizations, Users
  • Tasks

    Task lines under a work package with planned and actual hours

    Linked to Work packages
  • Record attachments

    Evidence files attached to work packages

    Linked to Work packages, Team members
  • Review decisions

    Independent reviewer decisions on work package revisions

    Linked to Work packages, Team members
  • Operation receipts

    Durable receipts for guarded operations with stable operation keys

    Linked to Work packages

Tasks and delivery

4 tablesAbout this feature
  • Tasks

    Task lines under a work package with planned and actual hours

    Linked to Work packages
  • Work packages

    Baseline work packages with lifecycle, budget hours and counterparty scope

    Linked to Organizations, Team members, Projects
  • Team members

    Staff and contractor personnel linked to an organization and platform user

    Linked to Organizations, Users
  • Record attachments

    Evidence files attached to work packages

    Linked to Work packages, Team members

Evidence and review

5 tablesAbout this feature
  • Record attachments

    Evidence files attached to work packages

    Linked to Work packages, Team members
  • Review decisions

    Independent reviewer decisions on work package revisions

    Linked to Work packages, Team members
  • Work packages

    Baseline work packages with lifecycle, budget hours and counterparty scope

    Linked to Organizations, Team members, Projects
  • Tasks

    Task lines under a work package with planned and actual hours

    Linked to Work packages
  • Team members

    Staff and contractor personnel linked to an organization and platform user

    Linked to Organizations, Users

Field inspections

5 tablesAbout this feature
  • Public work inspections

    Field inspections that certify accepted public works quantities

    Linked to Work packages, Organizations
  • Work packages

    Baseline work packages with lifecycle, budget hours and counterparty scope

    Linked to Organizations, Team members, Projects
  • Organizations

    Public works agencies and contracting organizations

  • Record attachments

    Evidence files attached to work packages

    Linked to Work packages, Team members
  • Review decisions

    Independent reviewer decisions on work package revisions

    Linked to Work packages, Team members

Operations and exceptions

5 tablesAbout this feature
  • Operation receipts

    Durable receipts for guarded operations with stable operation keys

    Linked to Work packages
  • Work packages

    Baseline work packages with lifecycle, budget hours and counterparty scope

    Linked to Organizations, Team members, Projects
  • Tasks

    Task lines under a work package with planned and actual hours

    Linked to Work packages
  • Public work inspections

    Field inspections that certify accepted public works quantities

    Linked to Work packages, Organizations
  • Review decisions

    Independent reviewer decisions on work package revisions

    Linked to Work packages, Team members

Shared and settings

1 table
  • Exchange rates

    Read-only effective exchange rates for this app.

Keys and references

A work packages record points to Organizations, team members and Projects. Tasks, record attachments, review decisions, public work inspections and operation receipts point back to their parent package. Review decisions.Reviewer and record attachments.uploaded by point to team members. Public work inspections.Organization points to Organizations. Use operation receipts.operation key with expected revision when reconciling an uncertain action. Keep the package record number distinct from the internal Id.

Migration order

  1. Import Organizations and Projects with their agency references.
  2. Map Users and team members to the appropriate organization.
  3. Import work packages with owners, counterparties and current revisions.
  4. Import Tasks, then record attachments and review decisions under the correct parent.
  5. Import public work inspections and operation receipts with their parent and revision context.
  6. Check exchange rates only where currency conversion is relevant to imported records.

Set up Public Works Department your way.

Start free, then use Proto to change fields, steps and approvals before your team goes live.

How to get started