trd

type APIEndpoint struct {
	Method      string   `json:"method"`
	Path        string   `json:"path"`
	Description string   `json:"description,omitempty"`
	Request     string   `json:"request,omitempty"`  // Schema reference
	Response    string   `json:"response,omitempty"` // Schema reference
	Errors      []string `json:"errors,omitempty"`
}

type APISpec struct {
	ID          string        `json:"id"`
	Name        string        `json:"name"`
	Type        string        `json:"type"` // REST, gRPC, GraphQL, WebSocket
	Version     string        `json:"version,omitempty"`
	Description string        `json:"description,omitempty"`
	BaseURL     string        `json:"base_url,omitempty"`
	Auth        string        `json:"auth,omitempty"` // OAuth2, API Key, mTLS, etc.
	Endpoints   []APIEndpoint `json:"endpoints,omitempty"`
	SpecURL     string        `json:"spec_url,omitempty"` // OpenAPI, Proto file, etc.
	RateLimit   string        `json:"rate_limit,omitempty"`
	Tags        []string      `json:"tags,omitempty"` // For filtering by topic/domain
}

type Approver = common.Approver

type ArchDecision struct {
	ID           string   `json:"id"`
	Title        string   `json:"title"`
	Status       string   `json:"status"` // Proposed, Accepted, Deprecated, Superseded
	Context      string   `json:"context"`
	Decision     string   `json:"decision"`
	Consequences []string `json:"consequences,omitempty"`
	Alternatives []string `json:"alternatives,omitempty"`
	Date         string   `json:"date,omitempty"`
	Tags         []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type Architecture struct {
	Overview      string         `json:"overview"`
	Principles    []string       `json:"principles,omitempty"`
	Patterns      []string       `json:"patterns,omitempty"` // e.g., "Microservices", "Event-driven"
	Components    []Component    `json:"components"`
	Diagrams      []Diagram      `json:"diagrams,omitempty"`
	DataFlows     []DataFlow     `json:"data_flows,omitempty"`
	ArchDecisions []ArchDecision `json:"architecture_decisions,omitempty"`
}

type Assumption struct {
	ID          string `json:"id"`
	Description string `json:"description"`
	Rationale   string `json:"rationale,omitempty"`
	Validated   bool   `json:"validated,omitempty"`
	Risk        string `json:"risk,omitempty"`
}

type Attribute struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Required    bool   `json:"required,omitempty"`
	Description string `json:"description,omitempty"`
	Constraints string `json:"constraints,omitempty"`
}

type AuthN struct {
	Method      string `json:"method"` // OAuth2, SAML, mTLS, API Key
	Provider    string `json:"provider,omitempty"`
	MFA         bool   `json:"mfa,omitempty"`
	SessionMgmt string `json:"session_management,omitempty"`
	Details     string `json:"details,omitempty"`
}

type AuthZ struct {
	Model    string   `json:"model"` // RBAC, ABAC, ReBAC
	Policies string   `json:"policies,omitempty"`
	Roles    []string `json:"roles,omitempty"`
	Details  string   `json:"details,omitempty"`
}

type Benchmark struct {
	Name     string `json:"name"`
	Scenario string `json:"scenario"`
	Result   string `json:"result,omitempty"`
	Date     string `json:"date,omitempty"`
}

type Component struct {
	ID               string   `json:"id"`
	Name             string   `json:"name"`
	Description      string   `json:"description"`
	Type             string   `json:"type,omitempty"` // Service, Library, Database, Queue, etc.
	Responsibilities []string `json:"responsibilities,omitempty"`
	Dependencies     []string `json:"dependencies,omitempty"` // IDs of dependent components
	Technology       string   `json:"technology,omitempty"`
	Owner            string   `json:"owner,omitempty"`
	Tags             []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type Constraint struct {
	ID          string   `json:"id"`
	Type        string   `json:"type"` // Technical, Resource, Time, Budget
	Description string   `json:"description"`
	Impact      string   `json:"impact,omitempty"`
	Rationale   string   `json:"rationale,omitempty"`
	Tags        []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type CustomSection struct {
	ID      string `json:"id"`
	Title   string `json:"title"`
	Content any    `json:"content"`
}

type DataFlow struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Source      string `json:"source"`      // Component ID
	Destination string `json:"destination"` // Component ID
	DataType    string `json:"data_type,omitempty"`
	Protocol    string `json:"protocol,omitempty"` // HTTP, gRPC, AMQP, etc.
	Description string `json:"description,omitempty"`
}

type DataModel struct {
	Overview   string      `json:"overview"`
	Entities   []Entity    `json:"entities,omitempty"`
	Diagrams   []Diagram   `json:"diagrams,omitempty"`
	DataStores []DataStore `json:"data_stores,omitempty"`
	Migrations string      `json:"migrations,omitempty"` // Migration strategy
}

type DataStore struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Type        string   `json:"type"` // PostgreSQL, MongoDB, Redis, S3, etc.
	Purpose     string   `json:"purpose"`
	Capacity    string   `json:"capacity,omitempty"`
	Replication string   `json:"replication,omitempty"`
	Backup      string   `json:"backup,omitempty"`
	Tags        []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type Deployment struct {
	Overview       string        `json:"overview"`
	Environments   []Environment `json:"environments"`
	Strategy       string        `json:"strategy,omitempty"`       // Blue-green, Canary, Rolling
	Infrastructure string        `json:"infrastructure,omitempty"` // Kubernetes, VMs, Serverless
	Regions        []string      `json:"regions,omitempty"`
	HA             string        `json:"high_availability,omitempty"`
	DR             string        `json:"disaster_recovery,omitempty"`
}

type Development struct {
	CodingStandards string   `json:"coding_standards,omitempty"`
	BranchStrategy  string   `json:"branch_strategy,omitempty"`
	CodeReview      string   `json:"code_review,omitempty"`
	Documentation   string   `json:"documentation,omitempty"`
	Tools           []string `json:"tools,omitempty"`
}

type Diagram struct {
	ID          string `json:"id"`
	Title       string `json:"title"`
	Type        string `json:"type,omitempty"` // C4, Sequence, ER, Flowchart
	URL         string `json:"url,omitempty"`
	Description string `json:"description,omitempty"`
	Source      string `json:"source,omitempty"` // Mermaid, PlantUML, draw.io, etc.
}

type Document struct {
	Metadata          Metadata         `json:"metadata"`
	ExecutiveSummary  ExecutiveSummary `json:"executive_summary"`
	Architecture      Architecture     `json:"architecture"`
	TechnologyStack   TechnologyStack  `json:"technology_stack"`
	APISpecifications []APISpec        `json:"api_specifications,omitempty"`
	DataModel         *DataModel       `json:"data_model,omitempty"`
	SecurityDesign    SecurityDesign   `json:"security_design"`
	Performance       Performance      `json:"performance"`
	Scalability       *Scalability     `json:"scalability,omitempty"`
	Deployment        Deployment       `json:"deployment"`
	Integration       []Integration    `json:"integrations,omitempty"`
	Development       *Development     `json:"development,omitempty"`
	Testing           *Testing         `json:"testing,omitempty"`

	// Optional sections
	Risks          []Risk          `json:"risks,omitempty"`
	Constraints    []Constraint    `json:"constraints,omitempty"`
	Assumptions    []Assumption    `json:"assumptions,omitempty"`
	Glossary       []GlossaryTerm  `json:"glossary,omitempty"`
	CustomSections []CustomSection `json:"custom_sections,omitempty"`
}

type Encryption struct {
	AtRest    string `json:"at_rest,omitempty"`    // AES-256, etc.
	InTransit string `json:"in_transit,omitempty"` // TLS 1.3, mTLS
	KeyMgmt   string `json:"key_management,omitempty"`
	Details   string `json:"details,omitempty"`
}

type Entity struct {
	ID            string      `json:"id"`
	Name          string      `json:"name"`
	Description   string      `json:"description,omitempty"`
	Attributes    []Attribute `json:"attributes,omitempty"`
	Relationships []string    `json:"relationships,omitempty"`
	Tags          []string    `json:"tags,omitempty"` // For filtering by topic/domain
}

type Environment struct {
	Name        string `json:"name"` // Development, Staging, Production
	Purpose     string `json:"purpose,omitempty"`
	URL         string `json:"url,omitempty"`
	Resources   string `json:"resources,omitempty"`
	AccessLevel string `json:"access_level,omitempty"`
}

type ExecutiveSummary struct {
	Purpose           string   `json:"purpose"`
	Scope             string   `json:"scope"`
	TechnicalApproach string   `json:"technical_approach"`
	KeyDecisions      []string `json:"key_decisions,omitempty"`
	OutOfScope        []string `json:"out_of_scope,omitempty"`
}

type GlossaryTerm struct {
	Term       string `json:"term"`
	Definition string `json:"definition"`
	Acronym    string `json:"acronym,omitempty"`
}

type Integration struct {
	ID            string   `json:"id"`
	Name          string   `json:"name"`
	Type          string   `json:"type"`      // API, SDK, Webhook, File
	Direction     string   `json:"direction"` // Inbound, Outbound, Bidirectional
	Protocol      string   `json:"protocol,omitempty"`
	AuthMethod    string   `json:"auth_method,omitempty"`
	DataFormat    string   `json:"data_format,omitempty"`
	Frequency     string   `json:"frequency,omitempty"` // Real-time, Batch, On-demand
	Description   string   `json:"description,omitempty"`
	Documentation string   `json:"documentation,omitempty"`
	Tags          []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type Limit struct {
	Name         string `json:"name"`
	Value        string `json:"value"`
	Rationale    string `json:"rationale,omitempty"`
	Configurable bool   `json:"configurable,omitempty"`
}

type MarkdownOptions struct {
	IncludeFrontmatter bool
	Margin             string
	MainFont           string
	SansFont           string
	MonoFont           string
	FontFamily         string
}

type Metadata struct {
	ID               string       `json:"id"`
	Title            string       `json:"title"`
	Version          string       `json:"version"`
	Status           Status       `json:"status"`
	CreatedAt        time.Time    `json:"created_at"`
	UpdatedAt        time.Time    `json:"updated_at"`
	Authors          []Person     `json:"authors"`
	Reviewers        []Person     `json:"reviewers,omitempty"`
	Approvers        []Approver   `json:"approvers,omitempty"`
	Tags             []string     `json:"tags,omitempty"`
	RelatedDocuments []RelatedDoc `json:"related_documents,omitempty"`
}

type NetworkSecurity struct {
	Firewall      string `json:"firewall,omitempty"`
	WAF           string `json:"waf,omitempty"`
	DDoS          string `json:"ddos_protection,omitempty"`
	NetworkPolicy string `json:"network_policy,omitempty"`
	Segmentation  string `json:"segmentation,omitempty"`
	Details       string `json:"details,omitempty"`
}

type PerfRequirement struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Metric      string   `json:"metric"` // Latency, Throughput, etc.
	Target      string   `json:"target"` // e.g., "< 100ms p99"
	Priority    string   `json:"priority,omitempty"`
	Measurement string   `json:"measurement,omitempty"`
	Tags        []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type Performance struct {
	Overview      string            `json:"overview,omitempty"`
	Requirements  []PerfRequirement `json:"requirements"`
	Benchmarks    []Benchmark       `json:"benchmarks,omitempty"`
	Optimizations []string          `json:"optimizations,omitempty"`
}

type Person = common.Person

type RelatedDoc struct {
	Title        string `json:"title"`
	URL          string `json:"url,omitempty"`
	Relationship string `json:"relationship,omitempty"` // implements, extends, references
	Description  string `json:"description,omitempty"`
}

type Risk struct {
	ID          string   `json:"id"`
	Description string   `json:"description"`
	Probability string   `json:"probability"`
	Impact      string   `json:"impact"`
	Mitigation  string   `json:"mitigation"`
	Owner       string   `json:"owner,omitempty"`
	Status      string   `json:"status,omitempty"`
	Tags        []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type Scalability struct {
	Overview        string  `json:"overview"`
	HorizontalScale string  `json:"horizontal_scaling,omitempty"`
	VerticalScale   string  `json:"vertical_scaling,omitempty"`
	LoadBalancing   string  `json:"load_balancing,omitempty"`
	AutoScaling     string  `json:"auto_scaling,omitempty"`
	Limits          []Limit `json:"limits,omitempty"`
}

type SecurityControl struct {
	ID             string   `json:"id"`
	Name           string   `json:"name"`
	Category       string   `json:"category,omitempty"`
	Description    string   `json:"description"`
	Implementation string   `json:"implementation,omitempty"`
	Tags           []string `json:"tags,omitempty"` // For filtering by topic/domain
}

type SecurityDesign struct {
	Overview         string            `json:"overview"`
	AuthN            *AuthN            `json:"authentication,omitempty"`
	AuthZ            *AuthZ            `json:"authorization,omitempty"`
	Encryption       *Encryption       `json:"encryption,omitempty"`
	NetworkSecurity  *NetworkSecurity  `json:"network_security,omitempty"`
	Compliance       []string          `json:"compliance,omitempty"` // SOC2, HIPAA, PCI-DSS, etc.
	ThreatModel      []Threat          `json:"threat_model,omitempty"`
	SecurityControls []SecurityControl `json:"security_controls,omitempty"`
}

type Status string

type Technology struct {
	Name         string   `json:"name"`
	Version      string   `json:"version,omitempty"`
	Purpose      string   `json:"purpose"`
	Rationale    string   `json:"rationale,omitempty"`
	Alternatives []string `json:"alternatives,omitempty"`
	Constraints  []string `json:"constraints,omitempty"`
}

type TechnologyStack struct {
	Languages      []Technology `json:"languages,omitempty"`
	Frameworks     []Technology `json:"frameworks,omitempty"`
	Databases      []Technology `json:"databases,omitempty"`
	MessageQueues  []Technology `json:"message_queues,omitempty"`
	Caching        []Technology `json:"caching,omitempty"`
	Infrastructure []Technology `json:"infrastructure,omitempty"`
	Monitoring     []Technology `json:"monitoring,omitempty"`
	CICD           []Technology `json:"cicd,omitempty"`
	Other          []Technology `json:"other,omitempty"`
}

type Testing struct {
	Strategy     string   `json:"strategy"`
	UnitTests    string   `json:"unit_tests,omitempty"`
	Integration  string   `json:"integration_tests,omitempty"`
	E2E          string   `json:"e2e_tests,omitempty"`
	Performance  string   `json:"performance_tests,omitempty"`
	Security     string   `json:"security_tests,omitempty"`
	Coverage     string   `json:"coverage_requirements,omitempty"`
	Environments []string `json:"test_environments,omitempty"`
}

type Threat struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Category    string   `json:"category,omitempty"` // STRIDE categories
	Description string   `json:"description"`
	Likelihood  string   `json:"likelihood,omitempty"`
	Impact      string   `json:"impact,omitempty"`
	Mitigation  string   `json:"mitigation"`
	Tags        []string `json:"tags,omitempty"` // For filtering by topic/domain
}