CMS Protobuf API Definitions

// admin/service/v1/i_post.proto
service PostService {
  rpc List (pagination.PagingRequest) returns (content.service.v1.ListPostResponse) {
    option (google.api.http) = { get: "/admin/v1/posts" };
  }
  rpc Get (content.service.v1.GetPostRequest) returns (content.service.v1.Post) {
    option (google.api.http) = { get: "/admin/v1/posts/{id}" };
  }
  rpc Create (content.service.v1.CreatePostRequest) returns (content.service.v1.Post) {
    option (google.api.http) = { post: "/admin/v1/posts" body: "*" };
  }
  rpc Update (content.service.v1.UpdatePostRequest) returns (content.service.v1.Post) {
    option (google.api.http) = { put: "/admin/v1/posts/{id}" body: "*" };
  }
  rpc Delete (content.service.v1.DeletePostRequest) returns (google.protobuf.Empty) {
    option (google.api.http) = { delete: "/admin/v1/posts/{id}" };
  }
  // Check whether a translation exists
  rpc TranslationExists(...) returns (...) {
    option (google.api.http) = { get: "/admin/v1/posts/{post_id}/translations/{language_code}" };
  }
}

// app/service/v1/i_post.proto
service PostService {
  rpc List (pagination.PagingRequest) returns (content.service.v1.ListPostResponse) {
    option (google.api.http) = { get: "/app/v1/posts" };
  }
  rpc Get (content.service.v1.GetPostRequest) returns (content.service.v1.Post) {
    option (google.api.http) = { get: "/app/v1/posts/{id}" };
  }
  rpc Create (content.service.v1.CreatePostRequest) returns (content.service.v1.Post) {
    option (google.api.http) = { post: "/app/v1/posts" body: "*" };
  }
  // Fetch translation data (frontends fetch content by language)
  rpc GetTranslation(content.service.v1.GetPostRequest) returns (content.service.v1.PostTranslation) {
    option (google.api.http) = { get: "/app/v1/posts/{id}/translation" };
  }
}

message Post {
  optional uint32 id = 1;
  optional string title = 2;          // Title
  optional string slug = 3;           // URL alias
  optional string content = 5;        // Content
  optional Post.Status status = 6;    // Status: draft/published/offline
  optional EditorType editor_type = 7;// Editor type
  repeated Section sections = 8;      // Content sections/blocks (rich-text builder)

  optional uint32 author_id = 20;     // Author ID
  optional string author_name = 21;   // Author name (guest)

  map<string, string> custom_fields = 30;    // Custom fields

  repeated PostTranslation translations = 40; // Multilingual translations
  repeated string available_languages = 41;   // Available language list

  repeated uint32 category_ids = 50;  // Associated categories
  repeated uint32 tag_ids = 51;       // Associated tags

  optional string password_hash = 60; // Password protection
}

enum Status {
  POST_STATUS_DRAFT = 0;      // Draft
  POST_STATUS_PUBLISHED = 1;  // Published
  POST_STATUS_OFFLINE = 2;    // Offline
}

message Section {
  optional SectionType type = 1;  // Section type
  optional string name = 2;       // Section name
  optional uint32 sort_order = 3; // Sort order
  map<string, string> config = 4; // Section config
  map<string, string> content = 5;// Section content
}

message Category {
  optional string name = 4;        // Category name
  optional string slug = 5;        // URL alias
  optional string icon = 6;        // Icon
  optional string code = 7;        // Unique code

  optional uint32 parent_id = 60;  // Parent node ID
  repeated Category children = 61; // Child node tree
  optional int32 depth = 62;       // Depth level
  optional string path = 63;       // Materialized path (e.g. "1/5/23")

  repeated CategoryTranslation translations = 20; // Multilingual translations
}

// Post translation
message PostTranslation {
  optional uint32 post_id = 2;        // Associated post ID
  optional string language_code = 3;  // Language code (e.g. zh-CN, en-US)

  optional string title = 10;         // Translated title
  optional string slug = 11;          // Language-specific slug
  optional string summary = 12;       // Translated summary
  optional string content = 13;       // Translated content
  optional string thumbnail = 15;     // Translated thumbnail
  optional string full_path = 17;     // Full path

  optional SeoMeta seo = 20;          // SEO metadata
}

// admin/service/v1/i_post.proto
service PostService {
  // Check whether a translation exists
  rpc TranslationExists(PostTranslationExistsRequest) returns (PostTranslationExistsResponse) {
    option (google.api.http) = {
      get: "/admin/v1/posts/{post_id}/translations/{language_code}"
    };
  }
}

// app/service/v1/i_post.proto
service PostService {
  // Frontends fetch translated content by language
  rpc GetTranslation(GetPostRequest) returns (PostTranslation) {
    option (google.api.http) = {
      get: "/app/v1/posts/{id}/translation"
    };
  }
}

message SeoMeta {
  optional string seo_title = 1;        // SEO title
  optional string meta_keywords = 2;    // SEO keywords
  optional string meta_description = 3; // SEO description

  optional string og_title = 4;         // Open Graph title
  optional string og_description = 5;   // Open Graph description
  optional string og_image = 6;         // Open Graph image

  optional string canonical_url = 33;   // Canonical URL
}