Report Official Development Assistance (RODA)

This service enables the Department for Business, Energy and Industrial Strategy (BEIS) and their partner organisations to collect and report information on the spending of Official Development Assistance (ODA).

In February 2023 BEIS became the Department for Science, Innovation and Technology (DSIT), which had a large impact on the application. You will see references to both organisations in both the code and the data, and this is worth keeping in mind as you work on the application.

Environments

The app is currently hosted on AWS ECS clusters provided by DSIT. The deployments happen automatically through AWS CodePipeline pipelines, after a successful GitHub Action build on the target GitHub branch.

NOTE: The AWS pipelines are polling-based. If a pipeline has not run in over 30 days, AWS will turn it off, and a developer will have to log in and restart deployments manually, by using "Release change".

Dev

https://dev.report-official-development-assistance.service.gov.uk

The develop branch is deployed to the dev environment.

Staging

https://staging.report-official-development-assistance.service.gov.uk

The develop branch is deployed to the staging environment.

Training

http://training.report-official-development-assistance.service.gov.uk

The main branch is deployed to the training environment.

Production

https://www.report-official-development-assistance.service.gov.uk

The main branch is deployed to the production environment.

Getting started

If this is your first time running the application, see the getting started documentation for instructions.

Day to day development

Support documentation

• Deleting activities from production
• Reset a user's MFA
• Pull back a submitted report
• Change a report's financial period
• Add channel of delivery code to the accepted list
• Downoload activies for annual impact metrics

In-depth documentation

• Glossary of business terms
• Environment variables
• Sending email notifications
• Use authentication
• Importing new partner organisation data
• Activity identifiers
• Benefitting countries and regions
• Exports
• Forecasts and versioning
• Internationalisation
• Pattern library
• IATI XML Validation
• Importing commitments
• Identifying invalid activities
• Background jobs
• Console access
• Logging
• Deployment
• DNS
• Migrations

Errors and monitoring

TBC

Architecture decision records We use ADRs to document architectural decisions

We use ADRs to document architectural decisions that we make. They can be found in doc/architecture/decisions and contributed to with the adr-tools.