feat: true-microservices (#40)

Reviewed-on: #40
2026-04-29 22:06:01 +02:00
parent 67511fc649
commit 590924254e
328 changed files with 10672 additions and 2939 deletions
@@ -0,0 +1,87 @@
+syntax = "proto3";
+option java_package = "de.nowchess.core.proto";
+option java_multiple_files = true;
+option java_outer_classname = "ChessTypesProto";
+
+enum ProtoColor {
+  WHITE = 0;
+  BLACK = 1;
+}
+
+enum ProtoPieceType {
+  PAWN   = 0;
+  KNIGHT = 1;
+  BISHOP = 2;
+  ROOK   = 3;
+  QUEEN  = 4;
+  KING   = 5;
+}
+
+enum ProtoMoveKind {
+  QUIET            = 0;
+  CAPTURE          = 1;
+  CASTLE_KINGSIDE  = 2;
+  CASTLE_QUEENSIDE = 3;
+  EN_PASSANT       = 4;
+  PROMO_QUEEN      = 5;
+  PROMO_ROOK       = 6;
+  PROMO_BISHOP     = 7;
+  PROMO_KNIGHT     = 8;
+}
+
+enum ProtoGameResultKind {
+  ONGOING           = 0;
+  WIN_CHECKMATE_W   = 1;
+  WIN_CHECKMATE_B   = 2;
+  WIN_RESIGN_W      = 3;
+  WIN_RESIGN_B      = 4;
+  WIN_TIME_W        = 5;
+  WIN_TIME_B        = 6;
+  DRAW_STALEMATE    = 7;
+  DRAW_INSUFFICIENT = 8;
+  DRAW_FIFTY_MOVE   = 9;
+  DRAW_THREEFOLD    = 10;
+  DRAW_AGREEMENT    = 11;
+}
+
+message ProtoPiece {
+  ProtoColor     color      = 1;
+  ProtoPieceType piece_type = 2;
+}
+
+message ProtoSquarePiece {
+  string     square = 1;
+  ProtoPiece piece  = 2;
+}
+
+message ProtoMove {
+  string        from      = 1;
+  string        to        = 2;
+  ProtoMoveKind move_kind = 3;
+}
+
+message ProtoCastlingRights {
+  bool white_king_side  = 1;
+  bool white_queen_side = 2;
+  bool black_king_side  = 3;
+  bool black_queen_side = 4;
+}
+
+message ProtoGameContext {
+  repeated ProtoSquarePiece board             = 1;
+  ProtoColor                turn              = 2;
+  ProtoCastlingRights       castling_rights   = 3;
+  string                    en_passant_square = 4;
+  int32                     half_move_clock   = 5;
+  repeated ProtoMove        moves             = 6;
+  ProtoGameResultKind       result            = 7;
+  repeated ProtoSquarePiece initial_board     = 8;
+}
+
+message ProtoPostMoveStatus {
+  bool is_checkmate             = 1;
+  bool is_stalemate             = 2;
+  bool is_insufficient_material = 3;
+  bool is_check                 = 4;
+  bool is_threefold_repetition  = 5;
+}
@@ -0,0 +1,58 @@
+syntax = "proto3";
+option java_package = "de.nowchess.coordinator.proto";
+option java_multiple_files = true;
+option java_outer_classname = "CoordinatorServiceProto";
+
+service CoordinatorService {
+  rpc HeartbeatStream(stream HeartbeatFrame) returns (stream CoordinatorCommand);
+  rpc BatchResubscribeGames(BatchResubscribeRequest) returns (BatchResubscribeResponse);
+  rpc UnsubscribeGames(UnsubscribeGamesRequest) returns (UnsubscribeGamesResponse);
+  rpc EvictGames(EvictGamesRequest) returns (EvictGamesResponse);
+  rpc DrainInstance(DrainInstanceRequest) returns (DrainInstanceResponse);
+}
+
+message HeartbeatFrame {
+  string instanceId = 1;
+  string hostname = 2;
+  int32 httpPort = 3;
+  int32 grpcPort = 4;
+  int32 subscriptionCount = 5;
+  int32 localCacheSize = 6;
+  int64 timestampMillis = 7;
+}
+
+message CoordinatorCommand {
+  string type = 1;
+  string payload = 2;
+}
+
+message BatchResubscribeRequest {
+  repeated string gameIds = 1;
+}
+
+message BatchResubscribeResponse {
+  int32 subscribedCount = 1;
+  repeated string failedGameIds = 2;
+}
+
+message UnsubscribeGamesRequest {
+  repeated string gameIds = 1;
+}
+
+message UnsubscribeGamesResponse {
+  int32 unsubscribedCount = 1;
+}
+
+message EvictGamesRequest {
+  repeated string gameIds = 1;
+}
+
+message EvictGamesResponse {
+  int32 evictedCount = 1;
+}
+
+message DrainInstanceRequest {}
+
+message DrainInstanceResponse {
+  int32 gamesMigrated = 1;
+}
@@ -0,0 +1,31 @@
+syntax = "proto3";
+option java_package = "de.nowchess.core.proto";
+option java_multiple_files = true;
+option java_outer_classname = "IoServiceProto";
+
+import "chess_types.proto";
+
+message ProtoImportFenRequest {
+  string fen = 1;
+}
+
+message ProtoImportPgnRequest {
+  string pgn = 1;
+}
+
+message ProtoCombinedExport {
+  string fen = 1;
+  string pgn = 2;
+}
+
+message ProtoStringResult {
+  string value = 1;
+}
+
+service IoService {
+  rpc ImportFen      (ProtoImportFenRequest) returns (ProtoGameContext);
+  rpc ImportPgn      (ProtoImportPgnRequest) returns (ProtoGameContext);
+  rpc ExportCombined (ProtoGameContext)      returns (ProtoCombinedExport);
+  rpc ExportFen      (ProtoGameContext)      returns (ProtoStringResult);
+  rpc ExportPgn      (ProtoGameContext)      returns (ProtoStringResult);
+}
@@ -0,0 +1,38 @@
+syntax = "proto3";
+option java_package = "de.nowchess.core.proto";
+option java_multiple_files = true;
+option java_outer_classname = "RuleServiceProto";
+
+import "chess_types.proto";
+
+message ProtoSquareRequest {
+  ProtoGameContext context = 1;
+  string           square  = 2;
+}
+
+message ProtoMoveRequest {
+  ProtoGameContext context = 1;
+  ProtoMove        move    = 2;
+}
+
+message ProtoMoveList {
+  repeated ProtoMove moves = 1;
+}
+
+message ProtoBoolResult {
+  bool value = 1;
+}
+
+service RuleService {
+  rpc CandidateMoves         (ProtoSquareRequest) returns (ProtoMoveList);
+  rpc LegalMoves             (ProtoSquareRequest) returns (ProtoMoveList);
+  rpc AllLegalMoves          (ProtoGameContext)   returns (ProtoMoveList);
+  rpc IsCheck                (ProtoGameContext)   returns (ProtoBoolResult);
+  rpc IsCheckmate            (ProtoGameContext)   returns (ProtoBoolResult);
+  rpc IsStalemate            (ProtoGameContext)   returns (ProtoBoolResult);
+  rpc IsInsufficientMaterial (ProtoGameContext)   returns (ProtoBoolResult);
+  rpc IsFiftyMoveRule        (ProtoGameContext)   returns (ProtoBoolResult);
+  rpc IsThreefoldRepetition  (ProtoGameContext)   returns (ProtoBoolResult);
+  rpc ApplyMove              (ProtoMoveRequest)   returns (ProtoGameContext);
+  rpc PostMoveStatus         (ProtoGameContext)   returns (ProtoPostMoveStatus);
+}