moveme_score #

SDK oficial Dart / Flutter para o MoveMe Score Service.

Avaliações desacopladas (motorista ↔ passageiro), score público, unmatch e rating protection.

Install #

dependencies:
  moveme_score: ^1.3.0

flutter pub add moveme_score
# ou
dart pub add moveme_score

Uso rápido #

import 'package:moveme_score/moveme_score.dart';

final score = ScoreClient(
  baseUrl: 'https://score.example.com', // URL do score-service
  apiKey: const String.fromEnvironment('SCORE_API_KEY'),
);

// Cadastro
final alice = await score.registerUser(
  name: 'Alice',
  uidExternal: 'app-user-123',
);

// Score público
final publicScore = await score.getScore(alice.id);
print(publicScore?.avgScore);

// Viagem + avaliação
final trip = await score.createTrip(
  driverId: alice.id,
  riderId: bob.id,
  price: 42,
);
await score.startTrip(trip.id);
await score.completeTrip(trip.id);

await score.submitRating(
  tripId: trip.id,
  fromUserId: bob.id,
  score: 5,
  comment: 'Ótimo!',
);

Auth #

Todas as rotas (exceto /health) exigem header:

apikey: <SCORE_API_KEY>

O SDK envia automaticamente apikey e x-api-key.

API coberta #

Zonas de disponibilidade #

await score.createZone(
  name: 'Luanda Centro',
  points: [
    ZonePointInput(lat: -8.81, lng: 13.22, orderIndex: 0),
    ZonePointInput(lat: -8.81, lng: 13.26, orderIndex: 1),
    ZonePointInput(lat: -8.85, lng: 13.26, orderIndex: 2),
    ZonePointInput(lat: -8.85, lng: 13.22, orderIndex: 3),
  ],
);

final ok = await score.checkAvailability(lat: -8.83, lng: 13.24); // true|false

Paragens / phase #

Enquanto status = accepted ou in_progress:

final trip = await score.createTrip(
  driverId: a.id,
  riderId: b.id,
  endLocation: 'Destino',
  stops: [
    TripStopInput(location: 'Paragem 1'),
  ],
);
await score.acceptTrip(trip.id);       // status=accepted
await score.startPickup(trip.id);      // phase=to_pickup (busca)
await score.arrivePickup(trip.id);     // phase=at_pickup (ponto de encontro)
await score.startTrip(trip.id);        // phase=to_stop (embarque)
await score.arriveStop(trip.id);
await score.completeStop(trip.id);
await score.completeTrip(trip.id);

License #

MIT