Files
FreeCADWasmDev/WORKSPACE-SNAPSHOT.md
wangdequan 9a7c4f0335 Save FreeCAD Web workspace sources and user validation evidence
IFC native binding remains incomplete; preserve accurate test results.
2026-09-15 22:01:58 +08:00

48 lines
2.6 KiB
Markdown

# FreeCAD Web workspace snapshot
This snapshot preserves the working layout: `freecad-source/` contains desktop
sources and native Web adapters, `web/` the React/Three.js application, `tools/`
the build and test orchestration, and `docs/` the implementation and user-test
evidence. It is not a release or a claim that all functionality has passed.
The local outer `.git` is a link to `freecad-source/.git`. Do not run a blanket
`git add -A` from that outer directory: the canonical repository otherwise
interprets desktop source files as removed. The snapshot script uses an isolated
temporary index, preserves main and the user's staging area, and publishes a
separate branch with the real workspace layout.
Dependency source trees, build directories, node_modules, credentials, automated
agent session logs, browser profiles and generated WASM bundles are excluded.
Reuse the supplied local dependencies and WASM artifacts for builds; this is a
source and evidence backup, not a self-contained offline binary distribution.
See `docs/current/user-tests-20260915/REMAINING-NINE-REPORT.md` for the current
acceptance boundary: eight of the former nine items passed; IFC import is still
unresolved. Current tests do not certify all 1452 command registrations.
## IFC continuation, 2026-09-15
Local reference `Web_FreeCAD_Bitbybit/src/facade/bim.ts` counts proxy entities;
it is not a substitute for a real IFC geometry parser. The source inventory and
the actual failing test are retained in the accompanying reports.
Official IfcOpenShell v0.8.0 branch source was downloaded from
https://codeload.github.com/IfcOpenShell/IfcOpenShell/tar.gz/refs/heads/v0.8.0 .
The branch head observed at retrieval was
`f8da61bf9249126c3ce41e7b995c68ae3ab520d9`.
Archive SHA-256: `c4e1efb7910dede9fabb5003e6599b52528220bf8309c00c196741e7933176fc`.
For a fresh reproducible fetch, use the commit URL instead of the moving branch
and record that new archive's checksum separately.
Temporary local source: `/dev/shm/freecad-ifc-build-GUcTWr/IfcOpenShell-0.8.0`.
Temporary archive: `/dev/shm/freecad-ifc-build-GUcTWr/source.tar.gz`.
These are RAM-backed and are not durable or part of this snapshot.
Official build files expose OpenCASCADE-only geometry and WASM Python wrapper
options. The default WASM wrapper is a SIDE_MODULE; compatibility with this
project's static Python 3.12/pthread/OCCT runtime still needs implementation and
testing. No IfcOpenShell native binding has yet been compiled or installed.
Do not remove IFC failure guards, substitute proxy metadata, or introduce a
second geometry backend to claim completion.