open-contracting / infrastructure

Documentation of the Open Contracting for Infrastructure Data Standards (OC4IDS) Toolkit
https://standard.open-contracting.org/infrastructure/
Other
6 stars 0 forks source link

Add description field to budget #336

Closed duncandewhurst closed 1 year ago

duncandewhurst commented 3 years ago

The CoST IDS mapping includes the following mapping for funding sources:

image

However, CoST West Lombok's platform captures the funding sources for a project in a single free-text field, which may combine multiple sources. For example:

Source of Funds Translation Notes
APBD Kabupaten Lombok Barat dan Hibah DFAT Australia West Lombok District Budget and Australia DFAT Grant APBDs are sub-national or local government budgets. DFAT is the Australian Government Department of Foreign Affairs and Trade.
(DAK Reguler Bidang Jalan) yang dituangkan dalam APBD Kabupaten Lombok Barat (Regular DAK for Roads) as outlined in the APBD of West Lombok Regency DAK is the Specific Allocation Fund, a policy instrument that enables central government to make ‘specific’ fiscal transfers to regional and district governments for physical facilities and infrastructure

We can recommend that, going forward, CoST West Lombok should capture a list of funding sources for each project, which can be modelled using budget.budgetBreakdown and/or the parties section. We can also recommend that CoST West Lombok manually cleanse historical data to split out the funding sources for each project. However, this issue is likely to occur with other CoST programmes, which typically implement many of the elements of the CoST IDS as free-text fields in their systems.

OCDS's approach, at the contracting process level, is to have a description field on the Budget object with the following description:

A short free text description of the budget source. May be used to provide the title of the budget line, or the programme used to fund this project.

Proposal

Add a description field to budget with the following description:

A short free-text description of the budget source(s). May be used to provide the title of the budget line, or the programme used to fund this project.

Alternative

Another option is to add a single BudgetBreakdown object to budget.budgetBreakdown and set its .description to the free-text description of the funding sources. However, semantically, this is not a breakdown of the budget.

References:

duncandewhurst commented 2 years ago

@jpmckinney are you happy with the proposal in this issue?

jpmckinney commented 2 years ago

Yes. I think the description of budget.description in the OCDS 1.2-dev branch has changed in a recent PR, so please refer to that in case any corresponding changes need to be made to the proposal.

duncandewhurst commented 2 years ago

Will do. Thanks!