diff --git a/data-pipeline/scripts/muscle-descriptions.mjs b/data-pipeline/scripts/muscle-descriptions.mjs index b669652..9935743 100644 --- a/data-pipeline/scripts/muscle-descriptions.mjs +++ b/data-pipeline/scripts/muscle-descriptions.mjs @@ -16,8 +16,8 @@ export const MUSCLE_DESCRIPTIONS = { "triceps brachii": "Único extensor do cotovelo; suas três cabeças (longa, lateral e medial) convergem no olécrano da ulna.", "pectoralis major": "Músculo grande e em leque do tórax anterior; aduz e roda medialmente o braço, e o flexiona a partir de posição estendida.", "pectoralis minor": "Sob o peitoral maior; traciona a escápula para baixo e para frente, e eleva as costelas na respiração forçada.", - "rectus abdominis": "Par de músculos verticais na linha média do abdome (o 'tanquinho'); flexiona o tronco e comprime o conteúdo abdominal.", - "external oblique": "Camada mais superficial dos músculos laterais do abdome; flexiona e roda o tronco para o lado oposto, e comprime o abdome.", + "rectus abdominis": "Par de músculos verticais na linha média do abdome; flexiona o tronco e comprime o conteúdo abdominal. Na malha 3D aparece como uma superfície lisa, mas na pessoa de verdade é cruzado por 3-4 intersecções tendíneas horizontais que criam o 'tanquinho' — veja a ilustração na descrição.", + "external oblique": "Camada mais superficial dos músculos laterais do abdome; flexiona e roda o tronco para o lado oposto, e comprime o abdome. Suas fibras superiores se entrelaçam (interdigitam) com as do serrátil anterior nas costelas, um encaixe que não aparece na malha 3D — veja a ilustração na descrição.", "internal oblique": "Camada intermediária dos músculos laterais do abdome; flexiona e roda o tronco para o mesmo lado, e comprime o abdome.", "latissimus dorsi": "O maior músculo do dorso; estende, aduz e roda medialmente o braço — o principal músculo do movimento de 'puxar para baixo' (ex: nadar, remar).", "gluteus maximus": "O maior e mais superficial músculo glúteo; principal extensor do quadril, essencial para subir escadas e levantar-se de uma cadeira.", @@ -92,10 +92,10 @@ export const MUSCLE_DESCRIPTIONS = { "thyro-epiglottic part of thyro-arytenoid muscle": "Porção tireoepiglótica do tireoaritenóideo; auxilia a estreitar a entrada da laringe durante a deglutição, protegendo a via aérea.", // ---- Coluna, dorso e parede do tronco ---- - "external abdominal oblique muscle": "Mesma função do 'external oblique': camada mais superficial da parede lateral do abdome, flexiona e roda o tronco para o lado oposto.", + "external abdominal oblique muscle": "Mesma função do 'external oblique': camada mais superficial da parede lateral do abdome, flexiona e roda o tronco para o lado oposto. Suas fibras superiores se entrelaçam (interdigitam) com as do serrátil anterior nas costelas — um encaixe que a malha 3D não modela; veja a ilustração na descrição.", "internal abdominal oblique muscle": "Mesma função do 'internal oblique': camada intermediária, flexiona e roda o tronco para o mesmo lado.", "transversus abdominis muscle": "Camada mais profunda da parede abdominal, com fibras horizontais; comprime o conteúdo abdominal (como uma 'cinta' natural), estabilizando o tronco.", - "rectus abdominis muscle": "Mesma função do 'rectus abdominis': flexiona o tronco e comprime o abdome.", + "rectus abdominis muscle": "Mesma função do 'rectus abdominis': flexiona o tronco e comprime o abdome. Na pessoa de verdade é cruzado por 3-4 intersecções tendíneas horizontais (o 'tanquinho'), que a malha 3D não modela — veja a ilustração na descrição.", "pyramidalis muscle": "Pequeno músculo variável na frente do reto abdominal; tensiona a linha alba.", "quadratus lumborum muscle": "Na parede posterior do abdome; flexiona lateralmente o tronco e estabiliza a 12ª costela durante a respiração.", "psoas major": "Junto ao ilíaco (iliopsoas), é o principal flexor do quadril, essencial para caminhar e subir escadas.", @@ -155,7 +155,7 @@ export const MUSCLE_DESCRIPTIONS = { "levator scapulae": "Eleva a escápula (encolher os ombros) e auxilia a inclinar o pescoço.", "rhomboid major muscle": "Retrai (aproxima da coluna) e roda a escápula para baixo, fixando-a contra o tórax.", "rhomboid minor muscle": "Mesma ação do romboide maior: retrai e roda a escápula para baixo.", - "serratus anterior muscle": "Protrai a escápula (empurrar para frente, como em um soco) e a roda para cima, permitindo levantar o braço acima da cabeça.", + "serratus anterior muscle": "Protrai a escápula (empurrar para frente, como em um soco) e a roda para cima, permitindo levantar o braço acima da cabeça. Origina-se em várias digitações (\"dentes de serra\") nas costelas, que se entrelaçam com as do oblíquo externo do abdome — um encaixe que a malha 3D não modela; veja a ilustração na descrição.", "subclavius muscle": "Estabiliza e abaixa discretamente a clavícula, protegendo os vasos subclávios logo abaixo.", "supraspinatus muscle": "Um dos músculos do manguito rotador; inicia a abdução do ombro e estabiliza a cabeça do úmero na cavidade glenoide.", "infraspinatus muscle": "Músculo do manguito rotador; roda lateralmente o braço e estabiliza a articulação do ombro.", diff --git a/frontend/public/muscular/parede-abdominal-gray392.png b/frontend/public/muscular/parede-abdominal-gray392.png new file mode 100644 index 0000000..1b436f4 Binary files /dev/null and b/frontend/public/muscular/parede-abdominal-gray392.png differ diff --git a/frontend/src/components/StructureInfoPanel.tsx b/frontend/src/components/StructureInfoPanel.tsx index 958a4af..d2beb1c 100644 --- a/frontend/src/components/StructureInfoPanel.tsx +++ b/frontend/src/components/StructureInfoPanel.tsx @@ -1,5 +1,6 @@ import { useAtlasStore } from "../store/useAtlasStore.js"; import type { Structure } from "../lib/api.js"; +import { MUSCLE_REFERENCE_IMAGE, hasMuscleReferenceImage } from "../data/muscleReferenceImages.js"; export function StructureInfoPanel({ bySlug, @@ -59,6 +60,18 @@ export function StructureInfoPanel({

{structure.description}

)} + {hasMuscleReferenceImage(structure.slug) && ( +
+ Ilustração clássica da parede abdominal mostrando reto do abdome, oblíquo externo e serrátil anterior +

{MUSCLE_REFERENCE_IMAGE.caption}

+

{MUSCLE_REFERENCE_IMAGE.credit}

+
+ )} + {structure.regionPath.length > 0 && (

{structure.regionPath.join(" › ")}

)} diff --git a/frontend/src/data/muscleReferenceImages.ts b/frontend/src/data/muscleReferenceImages.ts new file mode 100644 index 0000000..7a4f2b6 --- /dev/null +++ b/frontend/src/data/muscleReferenceImages.ts @@ -0,0 +1,26 @@ +// Referência visual 2D pra músculos cuja malha 3D real (Z-Anatomy) não tem +// as subdivisões que a ilustração clássica de anatomia mostra — reto do +// abdome (intersecções tendíneas, o "tanquinho"), serrátil anterior e +// oblíquo externo do abdome (digitações que se entrelaçam nas costelas). +// Confirmamos (comparando com a exportação bruta do Z-Anatomy E com o app +// oficial completo, não só a amostra do GitHub) que essa é uma limitação +// real do dado de origem, não um bug do pipeline — ver extract-manifest.mjs. +// Em vez de tentar esculpir essas divisões em cima de uma malha que não as +// tem, mostramos a prancha clássica de Gray's Anatomy (Henry Vandyke +// Carter, 1918 — domínio público, sem restrição de uso) que já ilustra +// exatamente essas três estruturas e como se relacionam. +export const MUSCLE_REFERENCE_IMAGE = { + image: "/muscular/parede-abdominal-gray392.png", + credit: + "Henry Vandyke Carter, em Henry Gray, Anatomy of the Human Body (1918) — domínio público (via Wikimedia Commons).", + caption: + "No modelo 3D esses três músculos aparecem como superfícies únicas e lisas (o Z-Anatomy não modela essas subdivisões). Esta ilustração clássica mostra onde fica cada um e como se relacionam de verdade.", +}; + +// Substrings do slug (sem o prefixo de sistema nem o sufixo de lado) que +// identificam um músculo coberto por essa referência. +const MUSCLE_REFERENCE_KEYS = ["rectus-abdominis-muscle", "serratus-anterior-muscle", "external-abdominal-oblique-muscle"]; + +export function hasMuscleReferenceImage(slug: string): boolean { + return MUSCLE_REFERENCE_KEYS.some((key) => slug.includes(key)); +} diff --git a/frontend/tsconfig.tsbuildinfo b/frontend/tsconfig.tsbuildinfo index bc6168c..5aecc60 100644 --- a/frontend/tsconfig.tsbuildinfo +++ b/frontend/tsconfig.tsbuildinfo @@ -1 +1 @@ -{"root":["./src/app.tsx","./src/main.tsx","./src/vite-env.d.ts","./src/components/celldiagram3d.tsx","./src/components/clippingcontrols.tsx","./src/components/cookieconsent.tsx","./src/components/feedbackwidget.tsx","./src/components/layertoggle.tsx","./src/components/layout.tsx","./src/components/microscopydiagram.tsx","./src/components/onlinecounter.tsx","./src/components/quickregionnav.tsx","./src/components/searchnav.tsx","./src/components/skindiagram3d.tsx","./src/components/structureinfopanel.tsx","./src/components/viewer/exammarkers.tsx","./src/components/viewer/mannequin.tsx","./src/components/viewer/scene.tsx","./src/components/viewer/systemmodel.tsx","./src/data/microscopycredits.ts","./src/data/microscopyhotspots.ts","./src/data/physicalexam.ts","./src/hooks/usestructures.ts","./src/hooks/usesystemstructures.ts","./src/lib/analytics.ts","./src/lib/api.ts","./src/routes/adminstatspage.tsx","./src/routes/atlaspage.tsx","./src/routes/physicalexampage.tsx","./src/routes/planespage.tsx","./src/routes/quizpage.tsx","./src/store/useatlasstore.ts"],"version":"5.9.3"} \ No newline at end of file +{"root":["./src/app.tsx","./src/main.tsx","./src/vite-env.d.ts","./src/components/celldiagram3d.tsx","./src/components/clippingcontrols.tsx","./src/components/cookieconsent.tsx","./src/components/feedbackwidget.tsx","./src/components/layertoggle.tsx","./src/components/layout.tsx","./src/components/microscopydiagram.tsx","./src/components/onlinecounter.tsx","./src/components/quickregionnav.tsx","./src/components/searchnav.tsx","./src/components/skindiagram3d.tsx","./src/components/structureinfopanel.tsx","./src/components/viewer/exammarkers.tsx","./src/components/viewer/mannequin.tsx","./src/components/viewer/scene.tsx","./src/components/viewer/systemmodel.tsx","./src/data/microscopycredits.ts","./src/data/microscopyhotspots.ts","./src/data/musclereferenceimages.ts","./src/data/physicalexam.ts","./src/hooks/usestructures.ts","./src/hooks/usesystemstructures.ts","./src/lib/analytics.ts","./src/lib/api.ts","./src/routes/adminstatspage.tsx","./src/routes/atlaspage.tsx","./src/routes/physicalexampage.tsx","./src/routes/planespage.tsx","./src/routes/quizpage.tsx","./src/store/useatlasstore.ts"],"version":"5.9.3"} \ No newline at end of file