haixunMaster/haixun-backend/generate/api/persona.api

syntax = "v1"

type (
	CopyResearchMapData {
		AudienceSummary string   `json:"audience_summary,omitempty"`
		ContentGoal     string   `json:"content_goal,omitempty"`
		Questions       []string `json:"questions,omitempty"`
		Pillars         []string `json:"pillars,omitempty"`
		Exclusions      []string `json:"exclusions,omitempty"`
		SuggestedTags   []string `json:"suggested_tags,omitempty"`
		BenchmarkNotes  string   `json:"benchmark_notes,omitempty"`
	}

	PersonaData {
		ID              string              `json:"id"`
		DisplayName     string              `json:"display_name,omitempty"`
		Persona         string              `json:"persona,omitempty"`
		Brief           string              `json:"brief,omitempty"`
		StyleProfile    string              `json:"style_profile,omitempty"`
		StyleBenchmark  string              `json:"style_benchmark,omitempty"`
		SeedQuery       string              `json:"seed_query,omitempty"`
		CopyResearchMap CopyResearchMapData `json:"copy_research_map,omitempty"`
		CreateAt        int64               `json:"create_at"`
		UpdateAt        int64               `json:"update_at"`
	}

	ListPersonasData {
		List []PersonaData `json:"list"`
	}

	CreatePersonaReq {
		DisplayName string `json:"display_name,optional"`
	}

	PersonaPath {
		ID string `path:"id" validate:"required"`
	}

	UpdatePersonaReq {
		DisplayName    *string `json:"display_name,optional"`
		Persona        *string `json:"persona,optional"`
		StyleProfile   *string `json:"style_profile,optional"`
		StyleBenchmark *string `json:"style_benchmark,optional"`
	}

	StartPersonaStyleAnalysisReq {
		BenchmarkUsername string `json:"benchmark_username" validate:"required"`
	}

	StartPersonaStyleAnalysisData {
		JobID   string `json:"job_id"`
		Status  string `json:"status"`
		Message string `json:"message"`
	}

	UpdatePersonaHandlerReq {
		PersonaPath
		UpdatePersonaReq
	}

	StartPersonaStyleAnalysisHandlerReq {
		PersonaPath
		StartPersonaStyleAnalysisReq
	}

	StartPersonaViralScanJobReq {
		Keywords []string `json:"keywords,optional"`
	}

	StartPersonaViralScanJobData {
		JobID   string `json:"job_id"`
		Status  string `json:"status"`
		Message string `json:"message"`
	}

	StartPersonaViralScanJobHandlerReq {
		PersonaPath
		StartPersonaViralScanJobReq
	}

	ListPersonaViralScanPostsReq {
		Limit int `form:"limit,optional"`
	}

	ViralScanPostData {
		ID              string `json:"id"`
		SearchTag       string `json:"search_tag"`
		Permalink       string `json:"permalink"`
		Author          string `json:"author"`
		Text            string `json:"text"`
		LikeCount       int    `json:"like_count"`
		ReplyCount      int    `json:"reply_count"`
		EngagementScore int    `json:"engagement_score"`
		Source          string `json:"source"`
		ScanJobID       string `json:"scan_job_id"`
		CreateAt        int64  `json:"create_at"`
	}

	ListPersonaViralScanPostsData {
		List  []ViralScanPostData `json:"list"`
		Total int                 `json:"total"`
	}

	ListPersonaViralScanPostsHandlerReq {
		PersonaPath
		ListPersonaViralScanPostsReq
	}

	CopyDraftData {
		ID         string   `json:"id"`
		PersonaID  string   `json:"persona_id"`
		ScanPostID string   `json:"scan_post_id,omitempty"`
		DraftType  string   `json:"draft_type"`
		Text       string   `json:"text"`
		Angle      string   `json:"angle,omitempty"`
		Hook           string   `json:"hook,omitempty"`
		Rationale      string   `json:"rationale,omitempty"`
		ReferenceNotes string   `json:"reference_notes,omitempty"`
		Sources        []string `json:"sources,omitempty"`
		Status         string   `json:"status,omitempty"`
		CreateAt       int64    `json:"create_at"`
	}

	ListPersonaCopyDraftsData {
		List  []CopyDraftData `json:"list"`
		Total int             `json:"total"`
	}

	GeneratePersonaCopyDraftReq {
		ScanPostID string `json:"scan_post_id" validate:"required"`
	}

	GeneratePersonaCopyDraftHandlerReq {
		PersonaPath
		GeneratePersonaCopyDraftReq
	}

	GeneratePersonaCopyDraftData {
		Draft   CopyDraftData `json:"draft"`
		Message string        `json:"message"`
	}
)

@server(
	group:      persona
	prefix:     /api/v1/personas
	middleware: AuthJWT
	tags:       "Persona"
	summary:    "Reusable persona profiles with 8D style strategy. Requires Bearer JWT."
)
service gateway {
	@handler listPersonas
	get / returns (ListPersonasData)

	@handler createPersona
	post / (CreatePersonaReq) returns (PersonaData)

	@handler getPersona
	get /:id (PersonaPath) returns (PersonaData)

	@handler updatePersona
	patch /:id (UpdatePersonaHandlerReq) returns (PersonaData)

	@handler deletePersona
	delete /:id (PersonaPath)

	@handler startPersonaStyleAnalysis
	post /:id/style-analysis (StartPersonaStyleAnalysisHandlerReq) returns (StartPersonaStyleAnalysisData)

	@handler startPersonaViralScanJob
	post /:id/viral-scan-jobs (StartPersonaViralScanJobHandlerReq) returns (StartPersonaViralScanJobData)

	@handler listPersonaViralScanPosts
	get /:id/viral-scan-posts (ListPersonaViralScanPostsHandlerReq) returns (ListPersonaViralScanPostsData)

	@handler listPersonaCopyDrafts
	get /:id/copy-drafts (PersonaPath) returns (ListPersonaCopyDraftsData)

	@handler generatePersonaCopyDraft
	post /:id/copy-drafts/generate (GeneratePersonaCopyDraftHandlerReq) returns (GeneratePersonaCopyDraftData)
}