Versus
In developmentPersonal projectA Flutter app for the battle operator and a NestJS REST API. The operator starts an edition, records rounds and results, and can undo. Data is the organization’s own declaration.
Problem
Rap-battle organizers in Brazil run live events with rosters, brackets, rounds and results. Versus is software for that operational work — not a social network and not a public ranking of the scene.
Architecture
The mobile app talks to a versioned REST API (`/v1`). Persistence is PostgreSQL through Prisma. Live rounds, ties and undo are stored as append-only edition events (LIFO). Scoring, bracket phases, repechage and double three are domain rules on the API. The operator drives those flows; there is no automatic bracket generator.
Stack
- Flutter
- Dart
- NestJS
- TypeScript
- Prisma
- PostgreSQL
- REST APIs
- OpenAPI
Domain concepts
- OrganizationImplemented
- EditionImplemented
- MC (participant)Implemented
- Battle (match)Implemented
- RoundImplemented
- ResultImplemented
- Ranking (per organization)Implemented
- Bracket (phase progression)Implemented
- RepescagemImplemented
- AuthPlanned
Implemented
- Organization, edition, participant (MC) and match CRUD.
- Live ops: best-of-3 rounds, sudden death, ties, undo.
- Operator-driven repechage and double three in the qualifying stage.
- Bracket phases by format target (TOP 4 / 8 / 16), including bye.
- Aggregated ranking per organization.
- OpenAPI/Swagger at `/docs`, health check, PostgreSQL via Prisma.
In development
- The product is still in progress (Phase 1 / 1.5). The public contract is an API without organizer login.
Planned
- Organizer authentication (Phase 2 in the project scope).
- Automatic bracket generation (groups / Swiss) — explicitly out of the current scope.
- Map / geolocation, public calendar, global MC profiles.
Repository
The source repositories are not public yet.
No public demo yet.