naive-framework 0.0.0-stage → 0.2.0

package/schema/vocab/business-models.json

@@ -0,0 +1,298 @@
+{
+  "vocabulary": "business-models",
+  "note": "Controlled values for a product's business_model (EE-017). The 55 patterns of the St. Gallen Business Model Navigator (Gassmann, Frankenberger and Csik 2014), as slugs, plus named extras that the 55 lack, each with its source. check-ventures warns on any other value.",
+  "references": [
+    "gassmann-2014-business-model-navigator"
+  ],
+  "patterns": [
+    {
+      "id": "add-on",
+      "name": "Add-on",
+      "source": "st-gallen"
+    },
+    {
+      "id": "affiliation",
+      "name": "Affiliation",
+      "source": "st-gallen"
+    },
+    {
+      "id": "aikido",
+      "name": "Aikido",
+      "source": "st-gallen"
+    },
+    {
+      "id": "auction",
+      "name": "Auction",
+      "source": "st-gallen"
+    },
+    {
+      "id": "barter",
+      "name": "Barter",
+      "source": "st-gallen"
+    },
+    {
+      "id": "cash-machine",
+      "name": "Cash machine",
+      "source": "st-gallen"
+    },
+    {
+      "id": "cross-selling",
+      "name": "Cross-selling",
+      "source": "st-gallen"
+    },
+    {
+      "id": "crowdfunding",
+      "name": "Crowdfunding",
+      "source": "st-gallen"
+    },
+    {
+      "id": "crowdsourcing",
+      "name": "Crowdsourcing",
+      "source": "st-gallen"
+    },
+    {
+      "id": "customer-loyalty",
+      "name": "Customer loyalty",
+      "source": "st-gallen"
+    },
+    {
+      "id": "digitisation",
+      "name": "Digitisation",
+      "source": "st-gallen"
+    },
+    {
+      "id": "direct-selling",
+      "name": "Direct selling",
+      "source": "st-gallen"
+    },
+    {
+      "id": "e-commerce",
+      "name": "E-commerce",
+      "source": "st-gallen"
+    },
+    {
+      "id": "experience-selling",
+      "name": "Experience selling",
+      "source": "st-gallen"
+    },
+    {
+      "id": "flat-rate",
+      "name": "Flat rate",
+      "source": "st-gallen"
+    },
+    {
+      "id": "fractional-ownership",
+      "name": "Fractional ownership",
+      "source": "st-gallen"
+    },
+    {
+      "id": "franchising",
+      "name": "Franchising",
+      "source": "st-gallen"
+    },
+    {
+      "id": "freemium",
+      "name": "Freemium",
+      "source": "st-gallen"
+    },
+    {
+      "id": "from-push-to-pull",
+      "name": "From push to pull",
+      "source": "st-gallen"
+    },
+    {
+      "id": "guaranteed-availability",
+      "name": "Guaranteed availability",
+      "source": "st-gallen"
+    },
+    {
+      "id": "hidden-revenue",
+      "name": "Hidden revenue",
+      "source": "st-gallen"
+    },
+    {
+      "id": "ingredient-branding",
+      "name": "Ingredient branding",
+      "source": "st-gallen"
+    },
+    {
+      "id": "integrator",
+      "name": "Integrator",
+      "source": "st-gallen"
+    },
+    {
+      "id": "layer-player",
+      "name": "Layer player",
+      "source": "st-gallen"
+    },
+    {
+      "id": "leverage-customer-data",
+      "name": "Leverage customer data",
+      "source": "st-gallen"
+    },
+    {
+      "id": "license",
+      "name": "License",
+      "source": "st-gallen"
+    },
+    {
+      "id": "lock-in",
+      "name": "Lock-in",
+      "source": "st-gallen"
+    },
+    {
+      "id": "long-tail",
+      "name": "Long tail",
+      "source": "st-gallen"
+    },
+    {
+      "id": "make-more-of-it",
+      "name": "Make more of it",
+      "source": "st-gallen"
+    },
+    {
+      "id": "mass-customisation",
+      "name": "Mass customisation",
+      "source": "st-gallen"
+    },
+    {
+      "id": "no-frills",
+      "name": "No frills",
+      "source": "st-gallen"
+    },
+    {
+      "id": "open-business",
+      "name": "Open business",
+      "source": "st-gallen"
+    },
+    {
+      "id": "open-source",
+      "name": "Open source",
+      "source": "st-gallen"
+    },
+    {
+      "id": "orchestrator",
+      "name": "Orchestrator",
+      "source": "st-gallen"
+    },
+    {
+      "id": "pay-per-use",
+      "name": "Pay per use",
+      "source": "st-gallen"
+    },
+    {
+      "id": "pay-what-you-want",
+      "name": "Pay what you want",
+      "source": "st-gallen"
+    },
+    {
+      "id": "peer-to-peer",
+      "name": "Peer to peer",
+      "source": "st-gallen"
+    },
+    {
+      "id": "performance-based-contracting",
+      "name": "Performance-based contracting",
+      "source": "st-gallen"
+    },
+    {
+      "id": "razor-and-blade",
+      "name": "Razor and blade",
+      "source": "st-gallen"
+    },
+    {
+      "id": "rent-instead-of-buy",
+      "name": "Rent instead of buy",
+      "source": "st-gallen"
+    },
+    {
+      "id": "revenue-sharing",
+      "name": "Revenue sharing",
+      "source": "st-gallen"
+    },
+    {
+      "id": "reverse-engineering",
+      "name": "Reverse engineering",
+      "source": "st-gallen"
+    },
+    {
+      "id": "reverse-innovation",
+      "name": "Reverse innovation",
+      "source": "st-gallen"
+    },
+    {
+      "id": "robin-hood",
+      "name": "Robin Hood",
+      "source": "st-gallen"
+    },
+    {
+      "id": "self-service",
+      "name": "Self-service",
+      "source": "st-gallen"
+    },
+    {
+      "id": "shop-in-shop",
+      "name": "Shop in shop",
+      "source": "st-gallen"
+    },
+    {
+      "id": "solution-provider",
+      "name": "Solution provider",
+      "source": "st-gallen"
+    },
+    {
+      "id": "subscription",
+      "name": "Subscription",
+      "source": "st-gallen"
+    },
+    {
+      "id": "supermarket",
+      "name": "Supermarket",
+      "source": "st-gallen"
+    },
+    {
+      "id": "target-the-poor",
+      "name": "Target the poor",
+      "source": "st-gallen"
+    },
+    {
+      "id": "trash-to-cash",
+      "name": "Trash to cash",
+      "source": "st-gallen"
+    },
+    {
+      "id": "two-sided-market",
+      "name": "Two-sided market",
+      "source": "st-gallen"
+    },
+    {
+      "id": "ultimate-luxury",
+      "name": "Ultimate luxury",
+      "source": "st-gallen"
+    },
+    {
+      "id": "user-designed",
+      "name": "User designed",
+      "source": "st-gallen"
+    },
+    {
+      "id": "white-label",
+      "name": "White label",
+      "source": "st-gallen"
+    }
+  ],
+  "extras": [
+    {
+      "id": "open-core",
+      "name": "Open core",
+      "source": "Lampitt 2008, the open-core model: a free open-source core with paid proprietary additions",
+      "why": "The 55 have Open source and Freemium but not their combination, which is the common model for developer tools"
+    },
+    {
+      "id": "fee-for-service",
+      "name": "Fee for service",
+      "source": "professional-services usage: work billed per project, day or hour",
+      "why": "The 55 describe product and platform models; a studio or consultancy selling its time needs a plain name for that"
+    }
+  ]
+}

package/schema/where-used.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "where-used.schema.json",
+  "title": "Where-used list",
+  "description": "A venture's where-used list (<venture>/knowledge/where-used.json, EE-042): for each fact kept once in its system of record (a parent, such as a product's price), every place that repeats it (its children: a pricing page, a newsletter, a payment provider, a constant in code). Update the parent once and the children show what must follow. The framework checks live children offline and reports drift (schema/check-where-used.mjs); delivering the change into a vendor's system is the platform's (coexistence or centralized style). Written for a fast model to read: every field present.",
+  "type": "object",
+  "required": ["facts"],
+  "additionalProperties": false,
+  "properties": {
+    "facts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "parent", "children"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "parent": {
+            "type": "object",
+            "required": ["route", "pointer"],
+            "additionalProperties": false,
+            "description": "Where the fact is mastered: a record route and a JSON pointer into it",
+            "properties": {
+              "route": { "type": "string", "description": "A record route, such as purpose/product/shop-app" },
+              "pointer": { "type": "string", "pattern": "^(/[^/]+)+$", "description": "A JSON pointer to the value, such as /price" }
+            }
+          },
+          "children": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": ["source", "path", "match", "status", "deliver"],
+              "additionalProperties": false,
+              "properties": {
+                "source": { "type": "string", "description": "A source id from knowledge/sources.json, or venture for the venture's own folder" },
+                "path": { "type": "string", "description": "The file inside that source" },
+                "match": {
+                  "oneOf": [
+                    { "type": "object", "required": ["kind", "template"], "additionalProperties": false, "properties": { "kind": { "const": "text" }, "template": { "type": "string", "pattern": "\\{value\\}", "description": "How the value appears in the text, {value} standing for it, such as $ {value}/month" } } },
+                    { "type": "object", "required": ["kind", "pointer"], "additionalProperties": false, "properties": { "kind": { "const": "json" }, "pointer": { "type": "string", "pattern": "^(/[^/]+)+$" } } }
+                  ]
+                },
+                "status": { "enum": ["live", "frozen"], "description": "live: must always show the parent's value. frozen: history that keeps the value it had (a newsletter already sent, a past invoice); never checked or changed" },
+                "deliver": { "enum": ["agent", "person", "platform"], "description": "Who carries a change to this child: an agent through a handoff, a person, or the platform's sync" },
+                "note": { "type": "string" }
+              }
+            }
+          },
+          "note": { "type": "string" }
+        }
+      }
+    },
+    "note": { "type": "string" }
+  }
+}

package/schema/workspace.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "workspace.schema.json",
+  "title": "Workspace",
+  "description": "A builder's workspace: one instance of the system. A workspace.json at its top says which schema version it follows, where its vault is and where its repositories are (EE-002, EE-011, EE-020). A workspace always has a vault; it has a code folder of repositories once any venture builds software.",
+  "type": "object",
+  "required": [
+    "schema",
+    "schema_version",
+    "ventures"
+  ],
+  "properties": {
+    "schema": {
+      "const": "everything-ecosystem"
+    },
+    "schema_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "The version in schema/VERSION that this workspace follows"
+    },
+    "ventures": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Folders to search for venture.json files, relative to the workspace. Grouping folders inside them are for people to browse and carry no meaning; each venture.json is the truth."
+    },
+    "code": {
+      "type": "string",
+      "description": "The folder holding the ventures' repositories (repository, short repo: a version-controlled store, normally Git, for code and the documents that ship with it). Needed once any venture builds software"
+    },
+    "vault": {
+      "type": "string",
+      "description": "The vault: the folder of documents (Markdown and JSON records) that holds the venture folders, their records and their decisions. Relative to the workspace; defaults to the workspace itself. Any notes app can open it; Obsidian calls such a folder a vault"
+    }
+  },
+  "additionalProperties": false
+}