Staff On-Costs Calculator¶
[Team : Johnson Team] [Tech Lead : TBC] [Service Owner : TBC] [Service Manager : TBC] [Product Manager : TBC]
Service Description¶
Staff On-Costs Calculator is a system designed to be the canonical reference for salary on-costs data. It will provide an interface for HR to add raw salary scale data, from which the system will calculate on-cost totals. It will therefore replace:
- the manual process currently used by HR to calculate on-costs data
- the existing Salary scales including on-costs page on the HR website (the system will provide a front-end which replaces this)
- the calculations currently carried out directly within Research Dashboard to calculate team expected expenditure across the duration of an award
Service Status¶
The Staff On-Costs Calculator is currently pre-alpha.
Contact¶
Technical queries and support should be directed to devops-johnson@uis.cam.ac.uk and will be picked up by a member of the team working on the service. To ensure that you receive a response, always direct requests to devops-johnson@uis.cam.ac.uk rather than reaching out to team members directly.
Issues discovered in the service or new feature requests should be opened as GitLab issues in the application repository.
Environments¶
The Staff On-Costs Calculator is currently deployed to the following environments:
| Name | URL |
|---|---|
| Production | https://webapp.prod.staff-on-costs.gcp.uis.cam.ac.uk/ |
| Staging | https://webapp.test.staff-on-costs.gcp.uis.cam.ac.uk/ |
| Development | https://webapp.devel.staff-on-costs.gcp.uis.cam.ac.uk/ |
Source code¶
The source code for the Staff On-Costs Calculator is spread over the following repositories:
| Repository | Description |
|---|---|
| Application Server | The source code for the main application server |
| Infrastructure Deployment | The Terraform infrastructure code for deploying the application server to GCP |
| ucamstaffoncosts module | Python module currently used to provide the logic for carrying out staff on-cost calculations |
Technologies used¶
The following gives an overview of the technologies the Staff On-Costs Calculator is built on.
| Category | Language | Framework(s) |
|---|---|---|
| Server | Python | Django |
| Client | TypeScript | React |
Operational documentation¶
The following gives an overview of how the Staff On-Costs Calculator is deployed and maintained.
How and where the Staff On-Costs Calculator is deployed¶
The database for application data is a PostgreSQL database hosted by GCP Cloud SQL. The main web application is a Django application, hosted by GCP Cloud Run.
Deploying a new release¶
The README.md file in the Infrastructure Deployment repository explains how to deploy the Staff On-Costs Calculator.
Monitoring¶
To see the Monitoring dashboard go to the GCP Console.
Debugging¶
See the monitoring section above for debugging information.
Service Management¶
The Team responsible for this service is Johnson Team.
The Tech Lead for this service is TBC.
The Service Owner for this service is TBC.
The Service Manager for this service is TBC.
The Product Manager for this service is TBC.