feat(schema): add findings tree + parse species JSON via Zod
Replaces the flat Pathology[] model with a hierarchical SpeciesFindings tree (zones → categories → nested children → leaves) authored as JSON and validated at boot. Equine catalog JSON is now wired through SpeciesFindingsSchema.parse() so malformed data fails loudly instead of corrupting an observation later. Species manifest swaps `pathologies` loader for `findings`. JSON species id renamed equin → equine to match the registry. Old equine pathology test deleted; new findings test covers parse + FR/EN label coverage + zone/category/leaf structure. Foundational step of the v2 domain pivot; callers in observation/store/ UI/PDF migrated in follow-up commits. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
31be3155ef
commit
f80e161d61
7 files changed
+135
-52
No files matched your search
@@ -0,0 +1,67 @@
|
||||
import { z } from 'zod'
|
||||
|
||||
/**
|
||||
* Schema for the species findings tree.
|
||||
*
|
||||
* Source of truth for what a practitioner can attach to an observation:
|
||||
* a hierarchical tree of dysfunctions/observations per anatomical zone,
|
||||
* authored by the domain expert in JSON and parsed at boot.
|
||||
*
|
||||
* Field names match the JSON authoring contract (snake_case).
|
||||
* Recursive children are typed via z.lazy + an explicit ZodType annotation
|
||||
* so TS can resolve the self-reference.
|
||||
*/
|
||||
|
||||
export const SourceRefSchema = z.object({
|
||||
type: z.enum(['manual', 'journal', 'database', 'web']),
|
||||
citation: z.string().min(1),
|
||||
url: z.string().url().optional(),
|
||||
})
|
||||
|
||||
export type SourceRef = z.infer<typeof SourceRefSchema>
|
||||
|
||||
export interface FindingNode {
|
||||
id: string
|
||||
name_fr: string
|
||||
name_en: string
|
||||
description_fr?: string
|
||||
description_en?: string
|
||||
requires_vet_referral?: boolean
|
||||
sources?: SourceRef[]
|
||||
children?: FindingNode[]
|
||||
}
|
||||
|
||||
export const FindingNodeSchema: z.ZodType<FindingNode> = z.lazy(() =>
|
||||
z.object({
|
||||
id: z.string().min(1),
|
||||
name_fr: z.string().min(1),
|
||||
name_en: z.string().min(1),
|
||||
description_fr: z.string().optional(),
|
||||
description_en: z.string().optional(),
|
||||
requires_vet_referral: z.boolean().optional(),
|
||||
sources: z.array(SourceRefSchema).optional(),
|
||||
children: z.array(FindingNodeSchema).optional(),
|
||||
}),
|
||||
)
|
||||
|
||||
export const ZoneFindingsSchema = z.object({
|
||||
id: z.string().min(1),
|
||||
name_fr: z.string().min(1),
|
||||
name_en: z.string().min(1),
|
||||
categories: z.array(FindingNodeSchema),
|
||||
})
|
||||
|
||||
export type ZoneFindings = z.infer<typeof ZoneFindingsSchema>
|
||||
|
||||
export const SpeciesFindingsSchema = z.object({
|
||||
schema_version: z.string().min(1),
|
||||
scope_disclaimer: z.string().min(1),
|
||||
species: z.object({
|
||||
id: z.string().min(1),
|
||||
name_fr: z.string().min(1),
|
||||
name_en: z.string().min(1),
|
||||
}),
|
||||
zones: z.record(z.string(), ZoneFindingsSchema),
|
||||
})
|
||||
|
||||
export type SpeciesFindings = z.infer<typeof SpeciesFindingsSchema>
|
||||
Reference in new issue
Block a user