AgentSkillsCN

go-architecture

Go 语言中的清洁且模块化的架构设计。在设计新模块、明确各层职责与分工，或对代码进行合理组织时使用。

SKILL.md
--- frontmatter
name: go-architecture
description: Diseño de arquitectura limpia y modular en Go. Usar al diseñar un nuevo módulo, definir capas y responsabilidades, u organizar código.
allowed-tools: Read, Grep, Glob

Skill: go-architecture

Arquitectura de GoFHIR.

Estructura del Proyecto

code
gofhir/
├── r4/, r4b/, r5/     # FHIR types por versión
├── fhirpath/          # FHIRPath evaluator
│   ├── fhirpath.go    # API pública
│   ├── cache.go       # Expression cache
│   ├── funcs/         # Registry de funciones
│   └── types/         # Sistema de tipos
├── validator/         # FHIR Validator
│   ├── validator.go   # API pública
│   ├── pipeline.go    # Pipeline pattern
│   ├── phases.go      # Fases de validación
│   └── internal/      # Implementaciones
└── docs/adr/          # ADRs

Arquitectura del Validator

code
API: NewInitializedValidatorR4(), Validate()
         ↓
    Pipeline (ejecuta fases)
         ↓
    Phases: Structure → Constraints → Terminology → Extensions
         ↓
    Services: Registry, FHIRPath, TerminologyService

Patrones Usados

  • •Pipeline: Fases ordenadas de validación
  • •Registry: Funciones FHIRPath, StructureDefinitions
  • •Visitor: TreeWalker para recorrer JSON
  • •Composite: Servicios de terminología combinados

Inyección de Dependencias

go
// Constructor con dependencias requeridas
v := NewValidator(registry, opts)

// Builder para opcionales
v = v.WithTerminologyService(ts).
      WithReferenceResolver(resolver)

Referencias

text
validator/pipeline.go, validator/interfaces.go
fhirpath/funcs/registry.go
validator/internal/