Skip to main content

Welcome to Eos Docs

Eos is Logiswift's next-generation platform, replacing the legacy Logiswift system piece by piece — Eos.Api, Eos.Workers, Eos.Web, and the frontends still to come. This site is the browsable, polished documentation companion to the repository's CLAUDE.md and DEVLOG.md. Those two files remain the working source of truth during active development — this site is generated from them and follows them, not a replacement for them, so if something here ever seems out of date, the repo files win.

What's in here​

  • Getting Started — prerequisites, local environment setup (backend + frontend end-to-end), an architecture orientation tour for new engineers, and client/Key Vault onboarding for deployments.
  • Architecture — the modular-monolith layering and module structure, plus the Authorization Model that governs every controller action.
  • Backend Patterns — the conventions every new entity follows: the reference CRUD pattern, territory access, pagination, translatable labels, eventing, audit trails, and more.
  • Frontend — Eos.Web's React shell and its vendored design system.
  • API Reference — auto-generated from Eos.Api's OpenAPI spec.
  • History / Changelog — the story of how the codebase got here, chronologically.