Albergue Municipal Carrascalejo

Repository for the Albergue Municipal Carrascalejo system (Camino de Santiago / Vía de la Plata).

• frontend/: Astro static frontend
• backend/: Rust services compiled to WebAssembly and run on Spin
• gateway/: API gateway/BFF layer (Rust + Spin)
• domain_model/: Schema baseline + migrations/tooling (SQLite/Turso)

Tooling

• Node.js >= 18
• pnpm (frontend)
• Rust (stable) + wasm32-wasip1 target
• Spin CLI
• go-task (task)

Quick start

List available tasks:

task -l

Run the default dev pipeline:

task dev

Readmes

• Frontend
• Frontend runtime scripts
• Backend
• Auth service
• Gateway
• Domain model
• Taskfiles
• Scripts
• Tests
• UX docs
• Documentation hub
• Architecture (arc42)
• ADRs

Frontend

cd frontend
pnpm install
pnpm dev

Build and preview:

pnpm build
pnpm preview

Backend

Backend components are designed to run under Spin (Wasm). For day-to-day work:

• Build/run a service with Spin from its directory (spin build, spin up)
• Run focused Rust tests per crate (some binaries are Spin/Wasm-specific)

Gateway

The gateway is a separate Cargo workspace under gateway/ and runs under Spin.