first

packages/asf-domain/README.md

@@ -0,0 +1,22 @@
+# asf-domain — Shared Pydantic Domain Models
+
+> Package condiviso: *tutti* i servizi Python importano i modelli da qui.
+> Non copiare-incollare modelli: se cambi un modello qui, cambia per tutti.
+
+Install (local dev):
+
+```bash
+cd packages/asf-domain
+pip install -e .
+```
+
+Provides:
+
+- `asf_domain.base` — UUID ULID factory, tenant-aware base model, enums.
+- `asf_domain.identity` — Organization, User, Team, Project.
+- `asf_domain.artifact` — Artifact, ArtifactRelationship (the core "Everything is an Artifact" model).
+- `asf_domain.job` — Job lifecycle & usage tracking.
+- `asf_domain.audit` — AuditEvent.
+- `asf_domain.integration` — Integration.
+- `asf_domain.ai_execution` — AIExecution record.
+- `asf_domain.common` — Typed aliases, shared types.