返回技能列表

implement-pharma-serialisation

pjt222
更新于 2 days ago
2 次查看
17
2
17
在 GitHub 上查看
designdata

关于

This skill helps developers implement pharmaceutical serialization systems compliant with global regulations like EU FMD and US DSCSA. It covers unique identifier generation, aggregation hierarchies, EPCIS data exchange, and verification endpoint integration. Use it when launching serialized products, integrating with national verification systems, or designing compliant transaction exchanges.

快速安装

Claude Code

推荐
主要方式
npx skills add pjt222/agent-almanac -a claude-code
插件命令备选方式
/plugin add https://github.com/pjt222/agent-almanac
Git 克隆备选方式
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/implement-pharma-serialisation

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

Implement Pharmaceutical Serialisation

Set up pharmaceutical serialisation systems for regulatory compliance with global track-and-trace mandates.

When Use

  • Implement serialisation for new product launch in EU or US market
  • Integrate with European Medicines Verification System (EMVS/NMVS)
  • Design DSCSA-compliant transaction information exchange
  • Build or integrate EPCIS event repository for supply chain visibility
  • Extend serialisation to additional markets (China NMPA, Brazil ANVISA)

Inputs

  • Required: Product information (GTIN, product code, dosage form, pack sizes)
  • Required: Target market regulations (EU FMD, DSCSA, or both)
  • Required: Packaging hierarchy (unit, bundle, case, pallet)
  • Optional: Existing ERP/MES system details for integration
  • Optional: Contract manufacturer serialisation capabilities
  • Optional: Verification endpoint specifications

Steps

Step 1: Understand Regulatory Landscape

RegulationRegionKey RequirementsDeadline
EU FMD (2011/62/EU)EU/EEAUnique identifier + tamper-evident feature on each unitLive since Feb 2019
DSCSAUSAElectronic, interoperable tracing at package levelFull enforcement Nov 2024+
China NMPAChinaUnique drug traceability code per minimum saleable unitRolling
Brazil ANVISA (SNCM)BrazilSerialisation of pharmaceuticals with IUMRolling
Russia MDLPRussiaCrypto-code per unit, mandatory scanningLive

Key data elements per regulation:

EU FMD unique identifier (per Delegated Regulation 2016/161):

  • Product code (GTIN-14 from GS1)
  • Serial number (up to 20 alphanumeric characters, randomised)
  • Batch/lot number
  • Expiry date

DSCSA transaction information:

  • Product identifier (NDC/GTIN, serial number, lot, expiry)
  • Transaction information (date, entities, shipment details)
  • Transaction history and transaction statement
  • Verification at package level

Got: Clear understanding of which regulations apply to each product-market combination.

If fail: Engage regulatory affairs to confirm market requirements before proceeding.

Step 2: Design Serialisation Data Model

-- Core serialisation data model
CREATE TABLE serial_numbers (
    id BIGSERIAL PRIMARY KEY,
    gtin VARCHAR(14) NOT NULL,          -- GS1 GTIN-14
    serial_number VARCHAR(20) NOT NULL,  -- Unique per GTIN
    batch_lot VARCHAR(20) NOT NULL,
    expiry_date DATE NOT NULL,
    status VARCHAR(20) DEFAULT 'ACTIVE', -- ACTIVE, DECOMMISSIONED, DISPENSED, etc.
    created_at TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(gtin, serial_number)
);

-- Aggregation hierarchy
CREATE TABLE aggregation (
    id BIGSERIAL PRIMARY KEY,
    parent_code VARCHAR(50) NOT NULL,     -- SSCC or higher-level code
    parent_level VARCHAR(10) NOT NULL,    -- CASE, PALLET, BUNDLE
    child_code VARCHAR(50) NOT NULL,      -- GTIN+serial or child SSCC
    child_level VARCHAR(10) NOT NULL,     -- UNIT, BUNDLE, CASE
    aggregation_event_id UUID NOT NULL,
    created_at TIMESTAMPTZ DEFAULT NOW()
);

-- EPCIS events
CREATE TABLE epcis_events (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    event_type VARCHAR(30) NOT NULL,      -- ObjectEvent, AggregationEvent, TransactionEvent
    action VARCHAR(10) NOT NULL,          -- ADD, OBSERVE, DELETE
    biz_step VARCHAR(100),               -- urn:epcglobal:cbv:bizstep:commissioning
    disposition VARCHAR(100),             -- urn:epcglobal:cbv:disp:active
    read_point VARCHAR(100),             -- urn:epc:id:sgln:location
    event_time TIMESTAMPTZ NOT NULL,
    event_timezone VARCHAR(6) NOT NULL,
    payload JSONB NOT NULL,
    created_at TIMESTAMPTZ DEFAULT NOW()
);

Aggregation hierarchy:

Pallet (SSCC)
  └── Case (SSCC)
       └── Bundle (GTIN + serial) [optional level]
            └── Unit (GTIN + serial)

Got: Data model supports full pack hierarchy with EPCIS event tracking.

If fail: Existing ERP schema conflicts? Design integration layer rather than modifying ERP direct.

Step 3: Implement Serial Number Generation

import secrets
import string

def generate_serial_number(length: int = 20, charset: str = None) -> str:
    """Generate a random serial number compliant with GS1 standards.

    EU FMD requires randomised serial numbers to prevent prediction.
    Max 20 characters, alphanumeric (GS1 Application Identifier 21).
    """
    if charset is None:
        # GS1 AI(21) allows: digits, uppercase, lowercase, and some special chars
        # Most implementations use alphanumeric only for interoperability
        charset = string.ascii_uppercase + string.digits
    return ''.join(secrets.choice(charset) for _ in range(length))


def generate_serial_batch(gtin: str, batch_lot: str, expiry: str, count: int) -> list:
    """Generate a batch of unique serial numbers for a production run."""
    serials = set()
    while len(serials) < count:
        serials.add(generate_serial_number())
    return [
        {
            "gtin": gtin,
            "serial_number": sn,
            "batch_lot": batch_lot,
            "expiry_date": expiry,
            "status": "COMMISSIONED"
        }
        for sn in serials
    ]

Got: Serial numbers cryptographically random, unique per GTIN, stored before printing.

If fail: Uniqueness collision occurs? Regenerate conflicting serial + log event.

Step 4: Implement GS1 DataMatrix Encoding

2D DataMatrix barcode encodes GS1 element string:

(01)GTIN(21)Serial(10)Batch(17)Expiry

Example:

(01)05012345678901(21)A1B2C3D4E5(10)LOT123(17)261231

Where:

  • AI(01) = GTIN-14
  • AI(21) = Serial number
  • AI(10) = Batch/lot number
  • AI(17) = Expiry date (YYMMDD)

GS1 DataMatrix uses FNC1 as separator (GS character, ASCII 29) between variable-length fields.

def encode_gs1_element_string(gtin: str, serial: str, batch: str, expiry: str) -> str:
    """Encode GS1 element string for DataMatrix printing.

    FNC1 (GS character \\x1d) separates variable-length fields.
    AI(01) and AI(17) are fixed length, so no separator needed after them.
    AI(21) and AI(10) are variable length and need FNC1 terminator.
    """
    GS = '\x1d'  # GS1 FNC1 / Group Separator
    return f"01{gtin}21{serial}{GS}10{batch}{GS}17{expiry}"

Got: Encoded strings verified by scanning test prints with GS1-certified verifier (ISO 15415 grade C or above).

If fail: Scan verification fails? Check print quality, quiet zones, encoding order.

Step 5: Integrate with National Verification Systems

EU FMD — EMVS/NMVS Integration

MAH → Upload serial data → EU Hub → Distribute to National Systems (NMVS)
                                      ├── Germany (securPharm)
                                      ├── France (CTS)
                                      ├── Italy (AIFA)
                                      └── ... 31 markets

API operations:

  1. Upload (MAH → EU Hub): Batch upload of commissioned serial numbers
  2. Verify (Pharmacy → NMVS): Check serial status before dispensing
  3. Decommission (Pharmacy → NMVS): Mark as dispensed at point of sale
  4. Reactivate (MAH → NMVS): Reverse accidental decommission

DSCSA — Verification Router Service

Trading Partner A → VRS Request → Verification Router → MAH's VRS → Response

Implement VRS responder endpoint:

# Simplified VRS endpoint (DSCSA verification)
from fastapi import FastAPI, HTTPException

app = FastAPI()

@app.get("/verify/{gtin}/{serial}/{lot}/{expiry}")
async def verify_product(gtin: str, serial: str, lot: str, expiry: str):
    """DSCSA product verification endpoint."""
    record = await lookup_serial(gtin, serial)
    if record is None:
        return {"verified": False, "reason": "SERIAL_NOT_FOUND"}
    if record.batch_lot != lot or str(record.expiry_date) != expiry:
        return {"verified": False, "reason": "DATA_MISMATCH"}
    if record.status != "ACTIVE":
        return {"verified": False, "reason": f"STATUS_{record.status}"}
    return {"verified": True, "status": record.status}

Got: Verification endpoints respond within 1 second with correct status.

If fail: National system upload fails? Retry with exponential backoff + alert operations.

Step 6: Implement EPCIS Event Capture

Record supply chain events in EPCIS 2.0 format:

{
  "@context": "https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld",
  "type": "ObjectEvent",
  "eventTime": "2025-03-15T10:30:00.000+01:00",
  "eventTimeZoneOffset": "+01:00",
  "epcList": ["urn:epc:id:sgtin:5012345.067890.A1B2C3D4E5"],
  "action": "ADD",
  "bizStep": "urn:epcglobal:cbv:bizstep:commissioning",
  "disposition": "urn:epcglobal:cbv:disp:active",
  "readPoint": {"id": "urn:epc:id:sgln:5012345.00001.0"},
  "bizLocation": {"id": "urn:epc:id:sgln:5012345.00001.0"}
}

Key business steps in pharma supply chain:

  • commissioning — serial number assigned to physical unit
  • packing — aggregation into cases/pallets
  • shipping — departure from location
  • receiving — arrival at location
  • dispensing — supplied to patient (decommission trigger)

Got: Every status change generates EPCIS event with correct timestamps + locations.

If fail: Failed event capture must be queued + retried; never silently dropped.

Checks

  • Serial numbers randomised + unique per GTIN
  • GS1 DataMatrix encoding verified by barcode scanner (ISO 15415 grade C+)
  • Aggregation hierarchy correctly links units → bundles → cases → pallets
  • National verification system integration tested (upload, verify, decommission)
  • EPCIS events captured for all business steps
  • Verification endpoint responds within 1 second
  • Exception handling covers upload failures, scan failures, network errors

Pitfalls

  • Sequential serial numbers: EU FMD explicit requires randomisation to prevent counterfeiting. Never use sequential numbering.
  • Aggregation errors: Disaggregation (breaking case) must update hierarchy. Shipping case with wrong child associations → verification failures downstream.
  • Timezone handling: EPCIS events must include timezone offset. Using local time without offset → event ordering ambiguity across sites.
  • Late uploads: Serial data must be uploaded to national systems before product enters supply chain. Late upload = product flagged suspicious at pharmacy.
  • Ignoring exceptions: Legitimate products get flagged (false alerts) regular. Process for investigating + resolving alerts essential.

See Also

  • perform-csv-assessment — validate serialisation system as computerised system
  • conduct-gxp-audit — audit serialisation processes
  • implement-audit-trail — audit trail for serialisation events
  • serialize-data-formats — general data serialisation (different domain, complementary concepts)
  • design-serialization-schema — schema design for data exchange formats

GitHub 仓库

pjt222/agent-almanac
路径: i18n/caveman/skills/implement-pharma-serialisation
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

content-collections

Content Collections 是一个 TypeScript 优先的构建工具,可将本地 Markdown/MDX 文件转换为类型安全的数据集合。它专为构建博客、文档站和内容密集型 Vite+React 应用而设计,提供基于 Zod 的自动模式验证。该工具涵盖从 Vite 插件配置、MDX 编译到生产环境部署的完整工作流。

查看技能

polymarket

这个Claude Skill为开发者提供完整的Polymarket预测市场开发支持,涵盖API调用、交易执行和市场数据分析。关键特性包括实时WebSocket数据流,可监控实时交易、订单和市场动态。开发者可用它构建预测市场应用、实施交易策略并集成实时市场预测功能。

查看技能

creating-opencode-plugins

该Skill帮助开发者创建OpenCode插件,用于接入命令、文件、LSP等25+种事件。它提供了插件结构、事件API规范和JavaScript/TypeScript实现模式,适合需要拦截操作、扩展功能或自定义事件处理的场景。开发者可通过它快速构建响应式模块来增强OpenCode AI助手的能力。

查看技能

sglang

SGLang是一个专为LLM设计的高性能推理框架,特别适用于需要结构化输出的场景。它通过RadixAttention前缀缓存技术,在处理JSON、正则表达式、工具调用等具有重复前缀的复杂工作流时,能实现极速生成。如果你正在构建智能体或多轮对话系统,并追求远超vLLM的推理性能,SGLang是理想选择。

查看技能