Skip to content

feat(architecture): create CALM files — platform, list artifact DDD, toolchain #117

Description

@MLKiiwy

Summary

Create the initial CALM (Common Architecture Language Model) architecture files under architecture/ that describe the current Alistigo platform architecture. Split into reusable patterns and concrete system instantiations.

Files to create

  • architecture/README.md — navigation, Mermaid overview diagrams, tooling instructions
  • architecture/patterns/ddd-hexagonal.pattern.json — reusable DDD hexagonal layer pattern
  • architecture/patterns/event-sourcing-cqrs.pattern.json — event sourcing + CQRS pattern
  • architecture/systems/alistigo-platform.arch.json — four-tier platform view (actors, tiers, external services)
  • architecture/systems/list-artifact-ddd.arch.json — list artifact internal DDD architecture (all packages as nodes + relationships)
  • architecture/systems/monorepo-toolchain.arch.json — dev toolchain: Nx, Bun, Biome, TypeScript, Vitest, Playwright, CALM, CI

Acceptance criteria

  • All files created and valid against CALM JSON Schema
  • pnpm calm validate architecture/ passes
  • Platform view covers all four tiers + external actors + external services
  • List artifact view covers all packages with correct dependency relationships
  • Toolchain view covers dev, QA, CI tools

Epic: architecture-as-code (Issue #116)

No activity

Activity on this issue will appear here.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions