@mindflight/mindbrain-personal-studio 0.6.2 → 0.6.4

package/examples/immeuble/sources/documents/statuts-erables.md

@@ -0,0 +1,22 @@
+# Statuts fictifs - ACP Residence Les Erables
+
+Document fictif inspire des documents constitutifs d'une copropriete belge.
+
+ACP: Residence Les Erables, 8 avenue des Erables, 1300 Wavre.
+Syndic: Syndic Horizon Gestion. L'immeuble est organise en deux blocs, bloc A et bloc B.
+Parties communes: jardin commun central, local technique, buanderie commune, local velos.
+
+Lots privatifs principaux:
+| Bloc | Lot | Porte | Etage | Chambres | Quotites |
+| --- | --- | --- | --- | --- | --- |
+| A | A1 | A-00-01 | 0 | 2 | 120/1000 |
+| A | A2 | A-00-02 | 0 | 2 | 125/1000 |
+| A | A3 | A-01-01 | 1 | 1 | 125/1000 |
+| A | A4 | A-01-02 | 1 | 3 | 130/1000 |
+| B | B1 | B-00-01 | 0 | 2 | 120/1000 |
+| B | B2 | B-00-02 | 0 | 2 | 125/1000 |
+| B | B3 | B-01-01 | 1 | 2 | 125/1000 |
+| B | B4 | B-01-02 | 1 | 4 | 130/1000 |
+
+Chaque lot dispose d'une cave. Les lots A1, A4, B1 et B4 disposent d'un garage. Les lots du rez-de-chaussee A1, A2, B1 et B2 disposent d'un jardin privatif a usage exclusif.
+La somme des quotites de l'immeuble est de 1000/1000.

package/examples/immeuble/sources/documents/statuts-tilleuls.md

@@ -0,0 +1,19 @@
+# Statuts fictifs - ACP Residence Les Tilleuls
+
+Document fictif inspire des categories belges d'acte de base, reglement de copropriete et reglement d'ordre interieur.
+
+ACP: Residence Les Tilleuls, 12 rue des Tilleuls, 5000 Namur.
+Syndic: Syndic Horizon Gestion. Gestionnaire comptable: Marie Lambert.
+Structure: un immeuble, bloc A, cinq appartements. Parties communes: hall, local technique, buanderie commune, deux machines a laver, jardin commun.
+
+Lots privatifs principaux:
+| Lot | Porte | Etage | Chambres | Quotites |
+| --- | --- | --- | --- | --- |
+| A1 | A-00-01 | 0 | 2 | 190/1000 |
+| A2 | A-00-02 | 0 | 1 | 180/1000 |
+| A3 | A-01-01 | 1 | 3 | 220/1000 |
+| A4 | A-01-02 | 1 | 1 | 190/1000 |
+| A5 | A-02-01 | 2 | 3 | 220/1000 |
+
+Chaque appartement dispose d'une cave. Les lots du rez-de-chaussee A1 et A2 disposent d'un jardin privatif a usage exclusif. Les garages sont attribues aux lots A1, A3 et A5.
+La somme des quotites de l'immeuble est de 1000/1000.

package/examples/immeuble/sources/documents/succession-jean-dupont.md

@@ -0,0 +1,3 @@
+# Dossier succession - Jean Dupont
+
+Jean Dupont est décédé le 15 mars 2024. A partir du 16 mars 2024, la facturation opérationnelle du lot A3 est adressée à Pauline Dupont et Nicolas Dupont, dans l'attente de la régularisation successorale.

package/examples/immeuble/sources/documents/titre-propriete-tilleuls-a3.md

@@ -0,0 +1 @@
+Le lot Tilleuls Appartement A3 est détenu par Nicolas Dupont et Pauline Dupont à parts égales. Le ménage comprend deux enfants occupants, Lina et Tom Dupont.

package/examples/immeuble/sources/documents/trous-pedagogiques.md

@@ -0,0 +1,3 @@
+# Trous pedagogiques attendus
+
+Les donnees contiennent volontairement des proprietaires manquants, occupants manquants, contrats incomplets, relances sans preuve, certificats expires et chantiers a risque.

package/examples/immeuble/sources/ontology/README.md

@@ -0,0 +1 @@
+Canonical LinkML ontology: [`../../../ontologies/immeuble/core.yaml`](../../../ontologies/immeuble/core.yaml)

package/examples/immeuble/sources/ontology/core.yaml

@@ -0,0 +1,444 @@
+id: https://ghostcrab.be/ontology/immeuble/core
+name: immeuble_core
+title: Immeuble syndic ontology
+description: Copropriete reference model for syndic workflows, people, households, leases, annexes, CODA matching, and qualified documents.
+license: https://ghostcrab.be/Licence.md
+version: 2.1.0
+
+prefixes:
+  linkml: https://w3id.org/linkml/
+  ghostcrab: https://ghostcrab.be/ontology/
+  immeuble: https://ghostcrab.be/ontology/immeuble/
+  foaf: http://xmlns.com/foaf/0.1/
+  org: http://www.w3.org/ns/org#
+  prov: http://www.w3.org/ns/prov#
+  time: http://www.w3.org/2006/time#
+
+imports:
+  - linkml:types
+  - ../ghostcrab/profile.yaml
+
+default_prefix: immeuble
+default_range: string
+
+enums:
+  PaymentStatus:
+    description: CODA matching and charge-call payment states.
+    permissible_values:
+      expected:
+      matched:
+      complete:
+      partial:
+      manual_review:
+      overdue:
+      closed:
+
+classes:
+  building:
+    is_a: Asset
+    class_uri: immeuble:Building
+    description: Residential or mixed building managed by a syndic.
+    annotations:
+      ghostcrab.native_entity_type: building
+      ghostcrab.layer: structure
+
+  block:
+    is_a: Asset
+    class_uri: immeuble:Block
+    description: Physical block or stairwell inside a building.
+    annotations:
+      ghostcrab.native_entity_type: block
+      ghostcrab.layer: structure
+
+  unit:
+    is_a: Asset
+    class_uri: immeuble:Unit
+    description: Private lot, usually an apartment, within a building block.
+    annotations:
+      ghostcrab.native_entity_type: unit
+      ghostcrab.layer: structure
+
+  shared_space:
+    is_a: Asset
+    class_uri: immeuble:SharedSpace
+    description: Common area such as hall, garden, elevator, or technical room.
+    annotations:
+      ghostcrab.native_entity_type: shared_space
+      ghostcrab.layer: structure
+
+  shared_equipment:
+    is_a: Asset
+    class_uri: immeuble:SharedEquipment
+    description: Shared equipment located in a common area, such as a washing machine.
+    annotations:
+      ghostcrab.native_entity_type: shared_equipment
+      ghostcrab.layer: structure
+
+  private_garden:
+    is_a: Asset
+    class_uri: immeuble:PrivateGarden
+    description: Garden attached to a ground-floor lot under exclusive use.
+    annotations:
+      ghostcrab.native_entity_type: private_garden
+      ghostcrab.layer: structure
+
+  parking_space:
+    is_a: Asset
+    class_uri: immeuble:ParkingSpace
+    annotations:
+      ghostcrab.native_entity_type: parking_space
+      ghostcrab.layer: structure
+
+  cellar:
+    is_a: Asset
+    class_uri: immeuble:Cellar
+    annotations:
+      ghostcrab.native_entity_type: cellar
+      ghostcrab.layer: structure
+
+  person:
+    is_a: Person
+    class_uri: foaf:Person
+    annotations:
+      ghostcrab.native_entity_type: person
+      ghostcrab.layer: actors
+
+  organization:
+    is_a: Organization
+    class_uri: org:Organization
+    annotations:
+      ghostcrab.native_entity_type: organization
+      ghostcrab.layer: actors
+
+  role:
+    is_a: Role
+    class_uri: immeuble:Role
+    annotations:
+      ghostcrab.native_entity_type: role
+      ghostcrab.layer: actors
+
+  household:
+    is_a: Group
+    class_uri: immeuble:Household
+    description: Residential household occupying a lot; members remain individual persons.
+    annotations:
+      ghostcrab.native_entity_type: household
+      ghostcrab.layer: actors
+
+  ownership_group:
+    is_a: Group
+    class_uri: immeuble:OwnershipGroup
+    description: Versioned group of right holders for a lot.
+    annotations:
+      ghostcrab.native_entity_type: ownership_group
+      ghostcrab.layer: actors
+      ghostcrab.pattern: versioned_group
+
+  billing_group:
+    is_a: Group
+    class_uri: immeuble:BillingGroup
+    description: Versioned group used as the operational recipient of charges.
+    annotations:
+      ghostcrab.native_entity_type: billing_group
+      ghostcrab.layer: actors
+      ghostcrab.pattern: versioned_group
+
+  lease_contract:
+    is_a: Contract
+    class_uri: immeuble:LeaseContract
+    description: Lease contract linking a landlord, a tenant household, and a unit over time.
+    annotations:
+      ghostcrab.native_entity_type: lease_contract
+      ghostcrab.layer: legal
+
+  event:
+    is_a: Event
+    class_uri: immeuble:Event
+    annotations:
+      ghostcrab.native_entity_type: event
+      ghostcrab.layer: lifecycle
+
+  document:
+    is_a: Document
+    class_uri: prov:Entity
+    annotations:
+      ghostcrab.native_entity_type: document
+      ghostcrab.layer: evidence
+
+  decision:
+    is_a: Entity
+    class_uri: immeuble:Decision
+    annotations:
+      ghostcrab.native_entity_type: decision
+      ghostcrab.layer: governance
+
+  bank_account:
+    is_a: Entity
+    class_uri: immeuble:BankAccount
+    annotations:
+      ghostcrab.native_entity_type: bank_account
+      ghostcrab.layer: finance
+
+  coda_entry:
+    is_a: Entity
+    class_uri: immeuble:CodaEntry
+    description: Bank statement line imported from a Belgian CODA file.
+    annotations:
+      ghostcrab.native_entity_type: coda_entry
+      ghostcrab.layer: finance
+
+  charge_call:
+    is_a: Invoice
+    class_uri: immeuble:ChargeCall
+    annotations:
+      ghostcrab.native_entity_type: charge_call
+      ghostcrab.layer: finance
+
+  payment_allocation:
+    is_a: Entity
+    class_uri: immeuble:PaymentAllocation
+    annotations:
+      ghostcrab.native_entity_type: payment_allocation
+      ghostcrab.layer: finance
+
+  receipt:
+    is_a: Document
+    class_uri: immeuble:Receipt
+    annotations:
+      ghostcrab.native_entity_type: receipt
+      ghostcrab.layer: finance
+
+  reminder:
+    is_a: Document
+    class_uri: immeuble:Reminder
+    annotations:
+      ghostcrab.native_entity_type: reminder
+      ghostcrab.layer: finance
+
+slots:
+  building_contains_block:
+    domain: building
+    range: block
+    slot_uri: immeuble:contains
+    description: Building contains a physical block or stairwell.
+
+  building_contains_shared_space:
+    domain: building
+    range: shared_space
+    slot_uri: immeuble:contains
+    description: Building contains a common area.
+
+  building_contains_shared_equipment:
+    domain: building
+    range: shared_equipment
+    slot_uri: immeuble:contains
+    description: Building contains shared equipment.
+
+  building_contains_cellar:
+    domain: building
+    range: cellar
+    slot_uri: immeuble:contains
+    description: Building contains cellar lots.
+
+  building_contains_parking_space:
+    domain: building
+    range: parking_space
+    slot_uri: immeuble:contains
+    description: Building contains parking spaces and garages.
+
+  building_contains_private_garden:
+    domain: building
+    range: private_garden
+    slot_uri: immeuble:contains
+    description: Building contains private gardens attached to lots.
+
+  building_contains_unit:
+    domain: building
+    range: unit
+    slot_uri: immeuble:contains
+    description: Building directly contains a private lot such as an apartment.
+
+  block_contains_unit:
+    domain: block
+    range: unit
+    slot_uri: immeuble:contains
+    description: Block contains private lots such as apartments.
+
+  shared_space_contains_equipment:
+    domain: shared_space
+    range: shared_equipment
+    slot_uri: immeuble:contains
+    description: Common area contains shared equipment such as a washing machine.
+
+  part_of:
+    domain: Asset
+    range: building
+    slot_uri: immeuble:partOf
+    annotations:
+      ghostcrab.native_edge_type: part_of
+
+  owns:
+    domain: Agent
+    range: Asset
+    slot_uri: immeuble:owns
+    annotations:
+      ghostcrab.native_edge_type: owns
+      ghostcrab.pattern: qualified_relation
+
+  occupies:
+    domain: person
+    range: unit
+    slot_uri: immeuble:occupies
+    annotations:
+      ghostcrab.native_edge_type: occupies
+
+  household_member:
+    domain: household
+    range: person
+    slot_uri: immeuble:householdMember
+    annotations:
+      ghostcrab.native_edge_type: household_member
+
+  primary_residence_of:
+    domain: unit
+    range: household
+    slot_uri: immeuble:primaryResidenceOf
+    annotations:
+      ghostcrab.native_edge_type: primary_residence_of
+
+  uses_exclusive:
+    domain: unit
+    range: Asset
+    slot_uri: immeuble:usesExclusive
+    annotations:
+      ghostcrab.native_edge_type: uses_exclusive
+
+  uses_common:
+    domain: household
+    range: Asset
+    slot_uri: immeuble:usesCommon
+    annotations:
+      ghostcrab.native_edge_type: uses_common
+
+  has_member:
+    domain: Group
+    range: person
+    slot_uri: org:hasMember
+    annotations:
+      ghostcrab.native_edge_type: has_member
+      ghostcrab.pattern: temporal_membership
+
+  assigned_garage:
+    domain: unit
+    range: parking_space
+    slot_uri: immeuble:assignedGarage
+    annotations:
+      ghostcrab.native_edge_type: assigned_garage
+
+  assigned_cellar:
+    domain: unit
+    range: cellar
+    slot_uri: immeuble:assignedCellar
+    annotations:
+      ghostcrab.native_edge_type: assigned_cellar
+
+  leases:
+    domain: lease_contract
+    range: unit
+    slot_uri: immeuble:leases
+    annotations:
+      ghostcrab.native_edge_type: leases
+
+  rented_to:
+    domain: Entity
+    range: household
+    slot_uri: immeuble:rentedTo
+    annotations:
+      ghostcrab.native_edge_type: rented_to
+
+  manages:
+    domain: organization
+    range: building
+    slot_uri: immeuble:manages
+    annotations:
+      ghostcrab.native_edge_type: manages
+
+  represents:
+    domain: organization
+    range: building
+    slot_uri: immeuble:represents
+    annotations:
+      ghostcrab.native_edge_type: represents
+
+  superseded_by:
+    domain: Group
+    range: Group
+    slot_uri: immeuble:supersededBy
+    annotations:
+      ghostcrab.native_edge_type: superseded_by
+      ghostcrab.pattern: temporal
+
+  closed:
+    domain: event
+    range: Entity
+    slot_uri: immeuble:closed
+    annotations:
+      ghostcrab.native_edge_type: closed
+      ghostcrab.pattern: event
+
+  created:
+    domain: event
+    range: Entity
+    slot_uri: immeuble:created
+    annotations:
+      ghostcrab.native_edge_type: created
+      ghostcrab.pattern: event
+
+  bills_to:
+    domain: billing_group
+    range: unit
+    slot_uri: immeuble:billsTo
+    annotations:
+      ghostcrab.native_edge_type: bills_to
+
+  records:
+    domain: bank_account
+    range: coda_entry
+    slot_uri: immeuble:records
+    annotations:
+      ghostcrab.native_edge_type: records
+
+  matched_to:
+    domain: coda_entry
+    range: charge_call
+    slot_uri: immeuble:matchedTo
+    annotations:
+      ghostcrab.native_edge_type: matched_to
+
+  allocated_to:
+    domain: coda_entry
+    range: billing_group
+    slot_uri: immeuble:allocatedTo
+    annotations:
+      ghostcrab.native_edge_type: allocated_to
+
+  triggered:
+    domain: coda_entry
+    range: Entity
+    slot_uri: immeuble:triggered
+    annotations:
+      ghostcrab.native_edge_type: triggered
+
+  requires_review:
+    domain: coda_entry
+    range: charge_call
+    slot_uri: immeuble:requiresReview
+    annotations:
+      ghostcrab.native_edge_type: requires_review
+
+  decided_by:
+    domain: Entity
+    range: decision
+    slot_uri: immeuble:decidedBy
+    annotations:
+      ghostcrab.native_edge_type: decided_by

package/examples/immeuble/success-criteria.yaml

@@ -0,0 +1,35 @@
+workspace_id: immeuble
+golden_workspace_id: immeuble
+parity_note: Single canonical workspace - bundle and structured-import share immeuble
+
+entity_counts_min:
+  buildings: 5
+  blocks: 9
+  units: 40
+  households: 40
+  cellars: 40
+  lease_contracts: 10
+  coda_entries: 35
+  persons: 80
+  maintenance_tickets: 10
+  worksite_projects: 2
+
+relation_edges:
+  - contains
+  - owns
+  - occupies
+  - leases
+  - bills_to
+  - matched_to
+  - has_intervention
+  - covers_asset
+  - certified_asset
+  - has_work_package
+
+graph_search_min:
+  appartement: 40
+
+diagnostics:
+  rules_pack: gap-rules/L3-full.json
+  expected_findings: gap-rules/expected-findings.yaml
+  missing_required_relations_min: 12

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mindflight/mindbrain-personal-studio",
-	"version": "0.6.2",
+	"version": "0.6.4",
 	"description": "Local GhostCrab MindBrain Studio for SQLite-backed workspaces.",
 	"license": "UNLICENSED",
 	"type": "module",
@@ -11,11 +11,16 @@
 	"files": [
 		"bin",
 		"build",
+		"examples/immeuble",
+		"fixtures/immeuble-demo.sqlite",
 		"fixtures/minimal-graph.sqlite",
 		"scripts/backend-sqlite.mjs",
 		"scripts/dev-sqlite.mjs",
+		"scripts/load-immeuble-demo.sh",
 		"scripts/publish-npm.mjs",
 		"scripts/seed-immeuble-projections.mjs",
+		"scripts/verify-immeuble-demo-sources.mjs",
+		"scripts/verify-immeuble-demo.mjs",
 		"scripts/studio-sqlite.mjs",
 		"scripts/lib",
 		"README.md",
@@ -48,8 +53,12 @@
 		"dev": "node scripts/dev-sqlite.mjs",
 		"studio": "node scripts/studio-sqlite.mjs --dev",
 		"start": "node scripts/studio-sqlite.mjs --serve",
+		"demo:build": "node examples/immeuble/scripts/enrich-immeuble-demo.mjs && node examples/immeuble/scripts/build-immeuble-model.mjs && node scripts/verify-immeuble-demo-sources.mjs",
+		"demo:load": "pnpm load:demo",
+		"demo:verify": "node scripts/verify-immeuble-demo.mjs",
+		"demo:fixture": "bash scripts/load-immeuble-demo.sh --sqlite fixtures/immeuble-demo.sqlite",
 		"load:demo": "bash scripts/load-immeuble-demo.sh",
-		"dev:fixture": "DATA_SOURCE=sqlite-demo GHOSTCRAB_SQLITE_PATH=fixtures/minimal-graph.sqlite vite dev",
+		"dev:fixture": "DATA_SOURCE=sqlite-demo GHOSTCRAB_SQLITE_PATH=fixtures/immeuble-demo.sqlite vite dev",
 		"backend:immeuble": "node -e \"console.warn('deprecated: use pnpm backend');\" && node scripts/backend-sqlite.mjs",
 		"dev:immeuble": "node -e \"console.warn('deprecated: use pnpm dev');\" && node scripts/dev-sqlite.mjs",
 		"backend:sqlite": "node -e \"console.warn('deprecated: use pnpm backend');\" && node scripts/backend-sqlite.mjs",

package/scripts/lib/sqlite-runtime.mjs

@@ -4,7 +4,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, join, resolve } from "node:path";
 
-export const DEMO_SQLITE_PATH = "fixtures/minimal-graph.sqlite";
+export const DEMO_SQLITE_PATH = "fixtures/immeuble-demo.sqlite";
 export const RUNTIME_DIR = "data/runtime";
 
 export function studioRootFromScript(importMetaUrl) {