Raido

"Raido" is the codename of the sourcecode for the new Oceania region ARDC RAiD service implementation of ISO 23527:2022.

"RAiD" is the name of the ISO standard and overall project, including global raid.org infrastructure and services not included in this repository.

"ARDC RAiD Service" is one instance of the Raido software, operated by the ARDC for the Oceania region.

See raid-vs-raido.md for more explanation.

Client API integrations

Folks looking to get started quickly integrating with the Raido API should look at the api-integration guide.

Environments

The production (PROD) environment is available at https://app.prod.raid.org.au.

There is also a DEMO environment for the RAiD service available at https://app.demo.raid.org.au.

Note that:

• you will not be approved to use either environment without prior agreement - send email to [email protected]
• the demo environment is under active development and is unstable
  • the data gets reset frequently

The service-level-guide.md page provides guidance to the expected level of Service provided by the RAiD team.

Technology / Architecture

See raid-architecture.md for a high-level view of the system.

There is also a guide to the operational environment which outlines how we use AWS services for the operation of Raido.

Project structure

• /
  • the root project contains no production code, it's just the container that holds all the other sub-projects
  • it does contain some build code though, see: /buildSrc
• /api-svc
  • /api-svc/db
    • database schema definition, implemented as a series of Flyway migrations
  • /api-svc/spring
    • the main API server, implemented as a Spring application
  • /api-svc/idl-raid-v2
    • the OpenAPI definition of the API that the api-svc serves
  • /api-svc/load-test
    • the load-tests and their results
• /raid-agency-app
  • The default Raido UI that uses api-svc
• /doc
  • Various high-level technical documentation topics for Raido
  • /doc/adr
    • Architecture decision log
  • /doc/api-integration
    • introductory documentation for folks who want to integrate directly with the Raido API
  • /doc/architecture
    • an overview of the Raido architecture and our implementation in AWS
  • /doc/code
    • coding standards/guidelines, etc.
  • /doc/data-export
    • details about data exports
  • /doc/development
    • details and guides for local development
  • /doc/security
    • documentation and overview of the authentication and authorization processes

Development

Documentation about running locally, building and releasing can all be found in /doc/development.