@oimlsmart/primmel-packages 0.1.0

package/oiml-smart-core/entities/cs-participants.prl

@@ -0,0 +1,470 @@
+class Utilizer#data {
+  store { utilizers }
+  description { "National issuing authority or national responsible body of an OIML Member State that signs a Declaration of acceptance of OIML certificates / type evaluation reports (B 18:2025 §5.6.1; admission per PD-09)." }
+  indexes { country }
+  id: string {
+    modality SHALL
+  }
+  name: string {
+    modality SHALL
+  }
+  short_name: string {
+    modality SHALL
+  }
+  country: string {
+    modality SHALL
+    definition "The OIML Member State the Utilizer acts for"
+  }
+  address: reference(Address) [0..1] {
+    modality MAY
+  }
+  contact: reference(Contact) [0..1] {
+    modality MAY
+  }
+  declaration_id: reference(ParticipantDeclaration) [0..1] {
+    modality MAY
+    definition "Its current Declaration record (PD-08 register)"
+    on_delete nullify
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class Associate#data {
+  store { associates }
+  description { "National issuing authority or national responsible body of an OIML Corresponding Member that signs a Declaration of acceptance (B 18:2025 §5.6.2; admission per PD-09)." }
+  indexes { country }
+  id: string {
+    modality SHALL
+  }
+  name: string {
+    modality SHALL
+  }
+  short_name: string {
+    modality SHALL
+  }
+  country: string {
+    modality SHALL
+    definition "The OIML Corresponding Member the Associate acts for"
+  }
+  address: reference(Address) [0..1] {
+    modality MAY
+  }
+  contact: reference(Contact) [0..1] {
+    modality MAY
+  }
+  declaration_id: reference(ParticipantDeclaration) [0..1] {
+    modality MAY
+    definition "Its current Declaration record (PD-08 register)"
+    on_delete nullify
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class ParticipantDeclaration#data {
+  store { participantDeclarations }
+  description { "A Declaration instance of the PD-08 participation register (task-40 Declaration model, data/oiml-cs/framework/declarations.yaml). For an Issuing Authority the scope is instrument categories × Schemes (PD-08 cl. 4 a); a Utilizer/Associate Declaration additionally carries its additional national requirements, the accepted IA/TL lists and the MTL acceptance policy (§5.6.3). Status draft/signed/suspended/withdrawn per the participant_declaration state machine; only `signed` discharges the PD-08 cl. 5 signing gate (browser/src/data/issuance-gate.ts)." }
+  indexes { participant_id kind status }
+  id: string {
+    modality SHALL
+  }
+  kind: enum {
+    modality SHALL
+    definition "Declaration-kind id of framework/declarations.yaml"
+    enum_values { issuing_authority_declaration utilizer_declaration associate_declaration }
+  }
+  participant_kind: enum {
+    modality SHALL
+    enum_values { issuing_authority utilizer associate }
+  }
+  participant_id: string {
+    modality SHALL
+    definition "The declaring participant: Organization id (IA oiml_code) or Utilizer/Associate id"
+  }
+  scope: reference(DeclarationScopeEntry) [0..*] {
+    modality MAY
+    definition "The categories × schemes matrix (PD-08 cl. 4 a)"
+  }
+  additional_national_requirements: string[] [0..*] {
+    modality MAY
+    definition "Utilizer/Associate only — ANRs deviating from the Recommendation (§5.6.1–5.6.2, 3.2)"
+  }
+  accepted_ia_ids: string[] [0..*] {
+    modality MAY
+    definition "Utilizer/Associate only — IAs whose reports are accepted (§5.6.3); empty = all"
+  }
+  accepted_tl_ids: string[] [0..*] {
+    modality MAY
+    definition "Utilizer/Associate only — TLs whose test data is accepted (§5.6.3); empty = all"
+  }
+  mtl_acceptance: enum [0..1] {
+    modality MAY
+    definition "Utilizer/Associate only — MTL-based report policy (§5.6.3; voluntary, no justification)"
+    enum_values { accepts declines }
+  }
+  mtl_ids: string[] [0..*] {
+    modality MAY
+    definition "IA only — the Manufacturer Test Laboratories listed in the IA's own Declaration (PD-05 §5.3.1 b/§5.5.5: only own-Declaration MTL reports may be utilised)"
+  }
+  maa_certificate_acceptance: text [0..1] {
+    modality MAY
+    definition "Conditions for accepting legacy MAA certificates (PD-08 cl. 6; B 18:2025 §15.10)"
+  }
+  status: enum {
+    modality SHALL
+    enum_values { draft signed suspended withdrawn }
+  }
+  signed_at: date [0..1] {
+    modality MAY
+  }
+  signed_by: string [0..1] {
+    modality MAY
+    definition "Responsible person who signed for the participant"
+  }
+  recorded_by: string [0..1] {
+    modality MAY
+    definition "The Executive Secretary who recorded the Declaration (PD-08 cl. 4)"
+  }
+  notes: text [0..1] {
+    modality MAY
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class AnrDeclaration#data {
+  store { anrDeclarations }
+  description { "One Additional National Requirement declared by a Utilizer/Associate for its country (TODO.adoption/11; the OIML-CS utilizer page: Utilizers and Associates may specify Additional National Requirements, and when these are specified the relevant test procedures must also be defined; B 18:2025 §5.6.1–5.6.2). The content tiers: tier_1 = Primmel-defined (the requirement and its test procedure are modelled — primmel_ref names the model; dispatchable and evaluable like any conformance test), tier_2 = declared-simple (the procedure rides as text plus the uploaded reference document; dispatched as the generic evidence-collection shape). Tier 0 is never a stored declaration — it is the per-evaluation bypass mark on the application's applied ANR (AppliedAnr.coverage). A declaration goes live only on the CS registry's approval (status APPROVED — honest moderation, never open editing); amendment or promotion to tier_1 re-enters review. The application's resolved ANR set rides the chain as Application.applied_anrs; the evaluation report and the certificate record the per-country coverage (ANRCompliance)." }
+  indexes { country standard_id status participant_id }
+  id: string {
+    modality SHALL
+  }
+  participant_id: string {
+    modality SHALL
+    definition "The declaring Utilizer/Associate (participants register id)"
+  }
+  participant_declaration_id: reference(ParticipantDeclaration) [0..1] {
+    modality MAY
+    definition "The participant's signed Declaration this ANR is listed under (§5.6.1–5.6.2 provenance)"
+    on_delete nullify
+  }
+  country: string {
+    modality SHALL
+    definition "The market the ANR applies to, keyed as targeted on applications (Application.anr_countries — e.g. NL)"
+  }
+  standard_id: string {
+    modality SHALL
+    definition "The Recommendation the ANR deviates from (e.g. oiml-r60)"
+  }
+  title: string {
+    modality SHALL
+  }
+  requirement_text: text {
+    modality SHALL
+    definition "The additional national requirement, verbatim"
+  }
+  national_instrument: string [0..1] {
+    modality MAY
+    definition "Clause ref: the national/regional instrument (e.g. the national act's section)"
+  }
+  directive_article: string [0..1] {
+    modality MAY
+    definition "Clause ref: the directive article the requirement traces to"
+  }
+  scheme_scope: enum {
+    modality SHALL
+    definition "The scheme scope the ANR applies under (PD-05 §5.1.4 names Scheme A; both = either scheme)"
+    enum_values { scheme_a scheme_b both }
+  }
+  tier: enum {
+    modality SHALL
+    definition "The content tier (TODO.adoption/11): tier_1 = Primmel-defined (primmel_ref), tier_2 = declared-simple (procedure_text + document). Promotion tier_2 → tier_1 sets primmel_ref and re-enters review; the coverage history keeps both forms' provenance (AppliedAnr.tier snapshots the tier at application time)."
+    enum_values { tier_1 tier_2 }
+  }
+  primmel_ref: string [0..1] {
+    modality MAY
+    definition "Tier 1: the modelled requirement/test identifier (the Primmel model the ANR is defined in); mandatory at tier_1"
+  }
+  procedure_text: text [0..1] {
+    modality MAY
+    definition "Tier 2: the test procedure as text — the operator performs the described procedure and records the outcome (the generic evidence-collection shape); mandatory at tier_2"
+  }
+  document: reference(DocumentRef) [0..1] {
+    modality MAY
+    definition "Tier 2: the uploaded reference document (TODO.adoption/03 blob slot; absent in the file-name-only posture)"
+  }
+  status: enum {
+    modality SHALL
+    definition "Walks the anr_declaration state machine (evaluation/state-machines.prl): the registry review path — only APPROVED is live"
+    enum_values { DRAFT SUBMITTED APPROVED REJECTED WITHDRAWN }
+  }
+  declared_by: string {
+    modality SHALL
+    definition "The account name of the Utilizer/Associate staff member who declared (provenance)"
+  }
+  reviewed_by: string [0..1] {
+    modality MAY
+    definition "The CS reviewer who decided (the registry moderation)"
+  }
+  review_notes: text [0..1] {
+    modality MAY
+  }
+  decided_at: date [0..1] {
+    modality MAY
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class ParticipantApplication#data {
+  store { participantApplications }
+  description { "One participation case through the approval pipeline (PD-03 IA, PD-04 TL, PD-09 Utilizer/Associate): application → competence evidence → RC recommendation → MC 80 % vote → Declaration signing → ACTIVE. The status field walks the participant_application state machine; competence evidence, RC recommendation and MC ballots are CompetenceEvidence / ApprovalVote records keyed by this id." }
+  indexes { status kind applicant_organization_id }
+  id: string {
+    modality SHALL
+  }
+  kind: enum {
+    modality SHALL
+    enum_values { ia_approval ia_scheme_b_application tl_approval ia_reapproval tl_reapproval utilizer_admission associate_admission }
+  }
+  applicant_organization_id: string {
+    modality SHALL
+    definition "The candidate: Organization id (IA oiml_code / TL oiml_id) or Utilizer/Associate id"
+  }
+  applicant_name: string {
+    modality SHALL
+  }
+  member_state: string {
+    modality SHALL
+  }
+  scheme: enum {
+    modality SHALL
+    enum_values { A B }
+  }
+  scope: reference(DeclarationScopeEntry) [0..*] {
+    modality MAY
+    definition "The applied scope — categories × schemes (PD-03, 5.1)"
+  }
+  tl_application_ids: string[] [0..*] {
+    modality MAY
+    definition "IA applications only — associated TL applications (PD-03, 4.1: at least one)"
+  }
+  linked_tl_ids: string[] [0..*] {
+    modality MAY
+    definition "IA applications only — the associated Test Laboratory list (PD-03, 5.1)"
+  }
+  mc_electorate: integer [0..1] {
+    modality MAY
+    definition "MC members from OIML Member States eligible to vote on this case (B 18:2025 §11.4.2 base)"
+  }
+  status: enum {
+    modality SHALL
+    enum_values { SUBMITTED ASSESSMENT RC_REVIEW MC_VOTE DECLARATION_PENDING ACTIVE REJECTED SUSPENDED WITHDRAWN }
+  }
+  declaration_id: reference(ParticipantDeclaration) [0..1] {
+    modality MAY
+    definition "The Declaration this case signs/updates (PD-03, 5.3.2 terminal step)"
+    on_delete nullify
+  }
+  submitted_by: string [0..1] {
+    modality MAY
+  }
+  decision_date: date [0..1] {
+    modality MAY
+    definition "Date of the MC participation decision"
+  }
+  notes: text [0..1] {
+    modality MAY
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class CompetenceEvidence#data {
+  store { competenceEvidence }
+  description { "One competence-demonstration dossier attached to a participation case: accreditation certificate + assessment report, peer assessment report, or the Scheme B self-declaration with supporting evidence. The competence REQUIREMENTS are delegated (ISO/IEC 17065 / 17025) — this record only evidences their demonstration." }
+  indexes { application_id }
+  id: string {
+    modality SHALL
+  }
+  application_id: reference(ParticipantApplication) {
+    modality SHALL
+    on_delete cascade
+    required true
+  }
+  kind: enum {
+    modality SHALL
+    definition "The demonstration path (B 18:2025 §5.4; PD-03/PD-04, 5.2)"
+    enum_values { accreditation peer_assessment self_declaration }
+  }
+  standard_ref: string {
+    modality SHALL
+    definition "The competence standard demonstrated (e.g. ISO/IEC 17065, ISO/IEC 17025)"
+  }
+  body: string [0..1] {
+    modality MAY
+    definition "Accreditation body (IAF-MLA / ILAC-MRA signatory) or peer-assessment team leader"
+  }
+  report_reference: string [0..1] {
+    modality MAY
+  }
+  report_date: date [0..1] {
+    modality MAY
+  }
+  team: string[] [0..*] {
+    modality MAY
+    definition "Assessment-team experts (MC-approved LME/MSE names)"
+  }
+  notes: text [0..1] {
+    modality MAY
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class ApprovalVote#data {
+  store { approvalVotes }
+  description { "One recorded vote of the approval pipeline: the Review Committee's recommendation (one per case, PD-03/PD-04 5.3.2) or a Management Committee member's ballot on the participation decision (B 18:2025 §11.4.2 — 80 % of the MC members from Member States; abstentions do not vote; a reason is recorded on against/abstain)." }
+  indexes { application_id organ }
+  id: string {
+    modality SHALL
+  }
+  application_id: reference(ParticipantApplication) {
+    modality SHALL
+    on_delete cascade
+    required true
+  }
+  organ: enum {
+    modality SHALL
+    enum_values { review_committee management_committee }
+  }
+  kind: enum {
+    modality SHALL
+    enum_values { rc_recommendation mc_ballot }
+  }
+  voter: string {
+    modality SHALL
+    definition "The RC rapporteur or the MC member (name or member-state code)"
+  }
+  member_state: string [0..1] {
+    modality MAY
+  }
+  ballot: enum {
+    modality SHALL
+    enum_values { in_favour against abstain }
+  }
+  reason: text [0..1] {
+    modality MAY
+    definition "Mandatory on against/abstain (B 18:2025 §11.4 voting rules)"
+  }
+  cast_at: datetime {
+    modality SHALL
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class CategorySchemeRecord#data {
+  store { categorySchemes }
+  description { "The registry's per-instrument-category scheme state — the instance the task-40 category_scheme lifecycle machine (framework/schemes.yaml, B 18:2025 clause 15) runs against. Included in Scheme B on inclusion (§15.1); the two-year timer (§15.2) is evaluated from this record by the registry service (browser/src/data/framework.ts evaluateSchemeLifecycle) and every fired transition is appended to `history`." }
+  indexes { standard_id state }
+  id: string {
+    modality SHALL
+    definition "Instrument-category id (snake_case, e.g. load-cells)"
+  }
+  label: string {
+    modality SHALL
+  }
+  standard_id: string [0..1] {
+    modality MAY
+    definition "The platform standard implementing the category's Recommendation (e.g. oiml-r60)"
+  }
+  recommendation_refs: string[] [0..*] {
+    modality MAY
+    definition "OIML Recommendation references covering the category (e.g. R 60:2021)"
+  }
+  state: enum {
+    modality SHALL
+    enum_values { SCHEME_A SCHEME_B }
+  }
+  included_at: date {
+    modality SHALL
+    definition "Date of inclusion in the OIML-CS — opens the two-year timer (§15.1/§15.2)"
+  }
+  transitioned_at: date [0..1] {
+    modality MAY
+    definition "Date the category reached Scheme A"
+  }
+  history: reference(CategorySchemeTransition) [0..*] {
+    modality MAY
+    definition "Every fired lifecycle transition (timer- or decision-driven)"
+  }
+  created: datetime {
+    modality SHALL
+  }
+  modified: datetime {
+    modality SHALL
+  }
+}
+
+class DeclarationScopeEntry#data {
+  description { "One scope row of a Declaration or application: an instrument category and the Schemes covered for it (PD-08 cl. 4 a — the scope model is categories × schemes)." }
+  helper { true }
+  category: string {
+    modality SHALL
+  }
+  schemes: string[] {
+    modality SHALL
+    definition "Scheme ids of framework/schemes.yaml (scheme_a | scheme_b)"
+  }
+}
+
+class CategorySchemeTransition#data {
+  description { "One fired transition of the category_scheme lifecycle recorded on a CategorySchemeRecord (e.g. the §15.2 two-year timer moving the category from SCHEME_B to SCHEME_A)." }
+  helper { true }
+  from: string {
+    modality SHALL
+  }
+  to: string {
+    modality SHALL
+  }
+  action: string {
+    modality SHALL
+  }
+  at: datetime {
+    modality SHALL
+  }
+  reason: string [0..1] {
+    modality MAY
+  }
+}
+