CMS Protobuf API 定义

// 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}" };
  }
  // 检查翻译是否存在
  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: "*" };
  }
  // 获取翻译数据（前台按语言获取内容）
  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;          // 标题
  optional string slug = 3;           // URL 别名
  optional string content = 5;        // 内容
  optional Post.Status status = 6;    // 状态：草稿/已发布/已下架
  optional EditorType editor_type = 7;// 编辑器类型
  repeated Section sections = 8;      // 内容区块（富文本构建器）

  optional uint32 author_id = 20;     // 作者 ID
  optional string author_name = 21;   // 作者名（游客）

  map<string, string> custom_fields = 30;    // 自定义字段

  repeated PostTranslation translations = 40; // 多语言翻译
  repeated string available_languages = 41;   // 可用语言列表

  repeated uint32 category_ids = 50;  // 关联分类
  repeated uint32 tag_ids = 51;       // 关联标签

  optional string password_hash = 60; // 密码保护
}

enum Status {
  POST_STATUS_DRAFT = 0;      // 草稿
  POST_STATUS_PUBLISHED = 1;  // 已发布
  POST_STATUS_OFFLINE = 2;    // 已下架
}

message Section {
  optional SectionType type = 1;  // 区块类型
  optional string name = 2;       // 区块名称
  optional uint32 sort_order = 3; // 排序
  map<string, string> config = 4; // 区块配置
  map<string, string> content = 5;// 区块内容
}

message Category {
  optional string name = 4;        // 分类名称
  optional string slug = 5;        // URL 别名
  optional string icon = 6;        // 图标
  optional string code = 7;        // 唯一代码

  optional uint32 parent_id = 60;  // 父节点 ID
  repeated Category children = 61; // 子节点树
  optional int32 depth = 62;       // 层级深度
  optional string path = 63;       // 物化路径（如 "1/5/23"）

  repeated CategoryTranslation translations = 20; // 多语言翻译
}

// 帖子翻译
message PostTranslation {
  optional uint32 post_id = 2;        // 关联的帖子 ID
  optional string language_code = 3;  // 语言代码（如 zh-CN, en-US）

  optional string title = 10;         // 翻译标题
  optional string slug = 11;          // 语言特定 slug
  optional string summary = 12;       // 翻译摘要
  optional string content = 13;       // 翻译内容
  optional string thumbnail = 15;     // 翻译缩略图
  optional string full_path = 17;     // 完整路径

  optional SeoMeta seo = 20;          // SEO 元数据
}

// admin/service/v1/i_post.proto
service PostService {
  // 检查翻译是否存在
  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 {
  // 前台按语言获取翻译内容
  rpc GetTranslation(GetPostRequest) returns (PostTranslation) {
    option (google.api.http) = {
      get: "/app/v1/posts/{id}/translation"
    };
  }
}

message SeoMeta {
  optional string seo_title = 1;        // SEO 标题
  optional string meta_keywords = 2;    // SEO 关键词
  optional string meta_description = 3; // SEO 描述

  optional string og_title = 4;         // Open Graph 标题
  optional string og_description = 5;   // Open Graph 描述
  optional string og_image = 6;         // Open Graph 图片

  optional string canonical_url = 33;   // 规范 URL
}