원클릭으로 Manus에서 모든 스킬 실행

work-with-sof

스타40

포크16

업데이트2026년 6월 11일 03:46

Work on SQL-on-FHIR, ViewDefinition processing, sof-cli, sof-server, SOF HTTP configuration, output formats, or parquet export. Use for helios-sof changes, ViewDefinitionTrait behavior, transformation tests, and SOF server endpoints.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

HeliosSoftware

HeliosSoftware/hfs

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

SQL-on-FHIR

Use this when working in helios-sof, sof-cli, sof-server, or ViewDefinition transformation code.

Server Environment

Variable	Default	Description
`SOF_SERVER_PORT`	`8080`	Server port
`SOF_SERVER_HOST`	`127.0.0.1`	Host to bind
`SOF_LOG_LEVEL`	`info`	Log level
`SOF_MAX_BODY_SIZE`	`10485760`	Max request body size in bytes, applied after decompression
`SOF_REQUEST_TIMEOUT`	`30`	Request timeout in seconds
`SOF_ENABLE_CORS`	`true`	Enable CORS
`SOF_CORS_ORIGINS`	`*`	Allowed origins
`SOF_TERMINOLOGY_SERVER`	none	Terminology server URL for FHIRPath memberOf and subsumes

API Endpoints

GET /metadata: return CapabilityStatement.
GET /health: health check.
POST /ViewDefinition/$viewdefinition-run: execute ViewDefinition transformation.

$viewdefinition-run accepts these parameters in the request body or query:

_format: csv, ndjson, json, or parquet.
header: CSV header control, true or false.
viewResource: ViewDefinition resource.
resource: FHIR resources to transform.
patient: filter by patient reference.
_limit: limit results, 1 to 10000.
_since: filter by modification time.

Parameter precedence is request body, then query params, then Accept header.

Parquet Export

# CLI
cargo run --bin sof-cli -- --view view.json --bundle data.json --format parquet

# Server
curl -X POST http://localhost:8080/ViewDefinition/\$viewdefinition-run \
  -H "Content-Type: application/json" \
  -d '{"_format": "parquet", "viewResource": {...}, "resource": [...]}'

Parquet type mapping follows Pathling conventions:

SOF type	Parquet type
boolean	BOOLEAN
string, code, uri	UTF8
integer	INT32
decimal	FLOAT64
dateTime, date	UTF8

Arrays map to Arrow List types. All fields are OPTIONAL. Snappy compression is the default.

Testing

Unit tests live in src/ files.
Integration tests live in tests/.
ViewDefinition examples are embedded in test files.
For version-independent logic, use enum wrappers such as SofViewDefinition and traits such as ViewDefinitionTrait, BundleTrait, and ResourceTrait.

이 저장소의 다른 Skills

같은 저장소

run-hfs-server

HeliosSoftware/hfs

Run, configure, or debug the main HFS FHIR server. Use for hfs binary startup, HFS environment variables, storage backend selection, multi-tenancy routing, HFS REST endpoints, request/response compression, S3 storage, and server behavior flags.

2026-07-1740

work-with-auth

HeliosSoftware/hfs

Work on HFS authentication & authorization. Use for SMART-on-FHIR/OAuth2, JWT bearer validation, JWKS, scopes/permissions, token replay semantics, SMART discovery, and HFS_AUTH_* configuration.

2026-07-1540

work-with-auth

HeliosSoftware/hfs

Work on HFS authentication & authorization. Use for SMART-on-FHIR/OAuth2, JWT bearer validation, JWKS, scopes/permissions, token replay semantics, SMART discovery, and HFS_AUTH_* configuration.

2026-07-1440

work-with-audit

HeliosSoftware/hfs

Work on HFS audit logging. Use for FHIR AuditEvent, IHE BALP profiles, audit sinks (database/file/CloudWatch), path exclusions, and HFS_AUDIT_* configuration.

Work on the HFS Terminology Server. Use for hts runtime configuration, HTS APIs, terminology import, bootstrap sync, CodeSystem, ValueSet, ConceptMap, SNOMED, LOINC, RxNorm, ICD-10-CM, and HFS terminology integration.

2026-06-1240

name	work-with-sof
description	Work on SQL-on-FHIR, ViewDefinition processing, sof-cli, sof-server, SOF HTTP configuration, output formats, or parquet export. Use for helios-sof changes, ViewDefinitionTrait behavior, transformation tests, and SOF server endpoints.

SQL-on-FHIR

Use this when working in helios-sof, sof-cli, sof-server, or ViewDefinition transformation code.

Server Environment

Variable	Default	Description
`SOF_SERVER_PORT`	`8080`	Server port
`SOF_SERVER_HOST`	`127.0.0.1`	Host to bind
`SOF_LOG_LEVEL`	`info`	Log level
`SOF_MAX_BODY_SIZE`	`10485760`	Max request body size in bytes, applied after decompression
`SOF_REQUEST_TIMEOUT`	`30`	Request timeout in seconds
`SOF_ENABLE_CORS`	`true`	Enable CORS
`SOF_CORS_ORIGINS`	`*`	Allowed origins
`SOF_TERMINOLOGY_SERVER`	none	Terminology server URL for FHIRPath memberOf and subsumes

API Endpoints

GET /metadata: return CapabilityStatement.
GET /health: health check.
POST /ViewDefinition/$viewdefinition-run: execute ViewDefinition transformation.

$viewdefinition-run accepts these parameters in the request body or query:

_format: csv, ndjson, json, or parquet.
header: CSV header control, true or false.
viewResource: ViewDefinition resource.
resource: FHIR resources to transform.
patient: filter by patient reference.
_limit: limit results, 1 to 10000.
_since: filter by modification time.

Parameter precedence is request body, then query params, then Accept header.

Parquet Export

# CLI
cargo run --bin sof-cli -- --view view.json --bundle data.json --format parquet

# Server
curl -X POST http://localhost:8080/ViewDefinition/\$viewdefinition-run \
  -H "Content-Type: application/json" \
  -d '{"_format": "parquet", "viewResource": {...}, "resource": [...]}'

Parquet type mapping follows Pathling conventions:

SOF type	Parquet type
boolean	BOOLEAN
string, code, uri	UTF8
integer	INT32
decimal	FLOAT64
dateTime, date	UTF8

Arrays map to Arrow List types. All fields are OPTIONAL. Snappy compression is the default.

Testing

Unit tests live in src/ files.
Integration tests live in tests/.
ViewDefinition examples are embedded in test files.
For version-independent logic, use enum wrappers such as SofViewDefinition and traits such as ViewDefinitionTrait, BundleTrait, and ResourceTrait.