ictsc-regalia

A monorepo that bundles the ICTSC contestant dashboard, operations console, and score server. The API is managed contract-first with OpenAPI.

Directory layout

.
├── backend/                 Go API, DB schema, external service adapters
│   └── openapi.json         The single source of truth for the API
├── frontend/packages/
│   ├── api/                 OpenAPI-generated types and shared REST client
│   ├── ui/                  Shared Vue UI, design, Storybook
│   ├── contestant/          Contestant Nuxt SPA
│   ├── admin/               Operations Nuxt SPA (/admin/)
│   └── config/              Shared lint/format config
├── docs/                    Design and external integration contracts
└── Taskfile.yaml            Development tasks

Generation

After changing the OpenAPI spec, update the generated artifacts for both languages from the repository root.

task generate

If differences remain after generation, commit those differences as part of the API contract change.

Development

Start the dependent services and the API with Docker.

task dev-backend

For details, see…