rzyfront/vendix-operating-scope
skills/vendix-operating-scope/SKILL.md
Organization operating scope for Vendix: STORE vs ORGANIZATION behavior for inventory, suppliers, purchases, accounting entities, transfers, reports, and tenant isolation. Trigger: When working with organization account_type, onboarding scope, inventory/accounting visibility, suppliers, locations, transfers, or cross-store data access.
$ install --global
skillsauthnpx skillsauth add rzyfront/vendix vendix-operating-scopeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 5:10 AM146.1s1 file scanned
SKILL.md
- name:
- vendix-operating-scope
- description:
- >
- Organization operating scope for Vendix:
- STORE vs ORGANIZATION behavior for inventory,
- Trigger:
- When working with organization account_type, onboarding scope, inventory/accounting visibility, suppliers, locations, transfers, or cross-store data access.
- license:
- MIT
- author:
- rzyfront
- version:
- 1.0
- scope:
- [root]
- allowed-tools:
- Read, Edit, Write, Glob, Grep, Bash
Vendix Operating Scope
Purpose
Use this skill whenever a change depends on whether an organization operates as one consolidated organization or as isolated stores.
Core Rule
Vendix has one global operating scope per organization:
STORE: every store is isolated.ORGANIZATION: operational and accounting data are shared/consolidated by organization.
Do not introduce mixed per-store scope unless the business explicitly changes this rule.
Business Rules
SINGLE_STOREonboarding maps tooperating_scope = STORE.MULTI_STORE_ORGonboarding maps tooperating_scope = ORGANIZATION.- Upgrade
SINGLE_STORE -> MULTI_STORE_ORGmay changeSTORE -> ORGANIZATION. - Downgrade
ORGANIZATION -> STOREis blocked by default because splitting historical inventory/accounting data is unsafe. - In
STORE, a store must not see another store's inventory, locations, suppliers, purchases, accounting, valuation, or reports. - In
ORGANIZATION, stores behave as channels/locations/segments under one organization scope.
Implementation Rules
- Resolve scope through
OperatingScopeService; do not duplicate scope decisions in feature services. - For accounting, resolve
accounting_entitiesthrough the operating scope. - In
STORE, operational records should carrystore_iddirectly or be reachable through a store-scoped parent. - In
ORGANIZATION, records can useorganization_idwithstore_id = nullwhen they are shared. - Cross-store stock transfers are not internal transfers in
STORE; block them unless a future commercial/intercompany flow exists.
Related Skills
vendix-prisma-scopesvendix-settings-systemvendix-inventory-stockvendix-auto-entriesvendix-accounting-rules
Related Skills
rzyfront/mobile-dev
development
VerifiedTrustedCommunity
Mobile app development rules for Vendix Expo/React Native project. Trigger: When editing, creating, or modifying any file under apps/mobile, or when developing mobile-specific features.
5SKILL.mdUpdated May 29, 2026
rzyfront/vendix-subscription-gate
development
VerifiedTrustedCommunity
Feature gating by store subscription state: global store write guard, AI feature gate, Redis feature resolution, quota consumption, frontend paywall interceptor, banner, and subscription UI states. Trigger: When adding feature gates, paywalls, subscription-based access control, protecting store write operations, AI feature gates, or rollout flags.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-saas-billing
testing
VerifiedTrustedCommunity
SaaS subscription billing for Vendix stores: plan pricing, invoices, Wompi platform payments, manual payments, partner commissions, payouts, proration, and dunning. Trigger: When creating SaaS invoices, working with partner rev-share, margin/surcharge pricing, invoice sequence allocation, partner payout batches, subscription payments, manual payments, or dunning flows.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-redis-quota
development
VerifiedTrustedCommunity
Periodic quota counters with Redis, UTC period keys, Lua-based idempotent AI quota consumption, request-id deduplication, and post-success consumption. Trigger: When building quota counters, enforcing monthly/daily feature caps, or reusing AI quota patterns for uploads, emails, exports, or rate-limited features.
5SKILL.mdUpdated May 16, 2026