sergio
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# modules/dominium/ — Simulador psicológico de campo medio
|
|
|
|
**Propósito.** Laboratorio de complejidad emergente: agentes vectoriales
|
|
(Lemmings) sin cognición reaccionan mecánicamente a una grilla plana de
|
|
5 campos ejecutando una de 6 acciones atómicas. Civilización, guerra, fe
|
|
y poder son patrones emergentes, no algoritmos. La maqueta se ve en
|
|
pseudo-3D isométrico calculado en CPU.
|
|
|
|
## Crates
|
|
|
|
| crate | tipo | rol |
|
|
| ---------------------- | ---- | ---------------------------------------------------------- |
|
|
| `dominium-core` | lib | `Grid` (5 capas SoA) + `Lemmings` (SoA) + `World` + 6 `Action` + `SimParams` |
|
|
| `dominium-physics` | lib | `diffuse` (difusión + entropía) + `tick`/`run` (ciclo completo) |
|
|
| `dominium-iso` | lib | `IsoProjector` (matriz iso fija vía `libm`) + `ZWeights` (relieve) + sombra Lambert |
|
|
| `dominium-render-plan` | lib | `build_plan` → `RenderPlan` de `Quad`s 2D ordenados por profundidad |
|
|
| `dominium-canvas-gpui` | lib | `DominiumCanvas`: `Element` GPUI que pinta el `RenderPlan` |
|
|
|
|
App: `apps/dominium` — ventana GPUI con bucle de simulación, maqueta
|
|
isométrica viva, panel de estadísticas y controles play/re-sembrar.
|
|
|
|
## Cadena de datos
|
|
|
|
```
|
|
dominium-core ─► dominium-physics ─► dominium-iso ─►
|
|
dominium-render-plan ─► dominium-canvas-gpui ─► apps/dominium
|
|
```
|
|
|
|
## Dependencias
|
|
|
|
- `core` ← sólo `serde` (regla inviolable: cero deps gráficas).
|
|
- `physics`, `iso`, `render-plan` ← `core` (+ `iso` ← `libm`).
|
|
- `canvas-gpui` ← `render-plan` + `gpui` (único crate que toca GPUI).
|
|
- La separación es estricta: un `dominium-canvas-web` o `-tui` hermano
|
|
se escribiría sin tocar el núcleo.
|
|
|
|
## Determinismo
|
|
|
|
`core` + `physics` + `iso` son bit-exactos: sólo aritmética `f32` en
|
|
orden fijo, trig vía `libm`, sin iteración de `HashMap` ni reducciones
|
|
paralelas. Mismo seed → mismo estado en cualquier plataforma.
|
|
|
|
## Estado
|
|
|
|
5 crates lib + 1 app, todos implementados y verdes. ~37 tests unitarios
|
|
(`run_is_deterministic`, `plan_is_deterministic` incluidos).
|