Instrument Passport Features and Use Cases
Use Case: Admin
Problem:
- Ensuring secure and proper access to data based on user roles.
- Managing attributes tied to compliance categories like CITES and Lacey Act.
Solution:
- Define user roles and groups with specific access levels.
- Create and manage attributes linked to compliance categories.
- Use role-based access to control visibility of data.
Responsibilities:
- Manage user roles and assign them to users and groups.
- Define and maintain attributes and their associations with categories.
- Oversee role-based access control for attributes and data.
- Aggregate roles across groups and ensure group roles take precedence.
Examples:
- An enforcement group can view attributes relevant to law enforcement while restricted from proprietary shop data.
- Admins assign enforcement personnel to groups like Border Patrol or Southern California.
Workflow: Login → Manage roles and groups → Create and assign attributes → Define category visibility.
Use Case: Shop Owner
Problem:
- Need to track inventory and manage employee access.
- Difficulty maintaining pricing and proprietary data securely.
Solution:
- Create groups for employees and managers with different roles.
- Assign instruments and materials to the shop inventory.
- Restrict visibility of sensitive data like pricing to shop owner roles.
Responsibilities:
- Create and manage shop-specific groups and assign employees.
- Maintain an inventory of instruments and materials.
- Control attribute visibility.
- Add NFC tags to instruments for tracking.
Examples:
- Track repairs and rentals while ensuring pricing info is only visible to the owner.
- Employees view inventory but not pricing or sales data.
Workflow: Login → Create/manage groups → Add instruments and materials → Assign attributes and roles → Generate inventory reports.
Use Case: Musician
Problem:
- Need for provenance and activity history of instruments.
- Requirement for compliance documents when traveling.
Solution:
- Provide public attributes and activity history for instruments.
- Allow musicians to generate Lacey Act and CITES compliance documents.
Responsibilities:
- Scan instruments to view public attributes and provenance.
- Maintain a record of receipts, appraisals, and activities.
- Generate compliance documents for international travel.
Examples:
- Generate a compliance passport for border inspections.
- Activity logs show repairs and provenance without exposing shop data.
Workflow: Login → Scan instrument → View provenance and activities → Generate compliance documents.
Use Case: Law Enforcement
Problem:
- Need to verify material compliance during inspections.
Solution:
- Access instrument attributes and compliance data based on role-based visibility.
Responsibilities:
- Scan instruments to verify compliance with CITES and Lacey Act.
- Review materials’ provenance and compliance documentation.
Examples:
- Border agents scan NFC tag to check materials and activities.
- Compliance documents show only what enforcement needs to see.
Workflow: Login → Search instrument by ID → Verify CITES attributes.
Use Case: Supplier
Problem:
- Difficulty tracking materials through the supply chain.
Solution:
- Tag materials with provenance details, including GPS and species info.
- Record activities like milling, finishing, and transport.
Responsibilities:
- Tag harvested materials with detailed information.
- Maintain a supply chain activity log.
- Provide provenance data to buyers.
Examples:
- An ebony log tagged at harvest includes GPS data and milling/transport info.
- Each tag ensures traceability to the finished instrument.
Workflow: Login → Add materials → Tag materials with details → Track materials through the supply chain.
Use Case: Luthier
Problem:
- Difficulty managing CITES-compliant materials.
- Need for tracking instrument components.
Solution:
- Manage material inventory with compliance data.
- Track attributes like weight and origin.
- Generate compliance documents (PDFs).
Responsibilities:
- Catalog inventory of materials with provenance.
- Incorporate materials into instruments.
- Maintain activity logs.
- Add NFC tags for provenance.
Examples:
- Create a violin with tagged materials and generate export docs.
- Logs ensure traceability for all components.
Workflow: Login → Add materials → Assign materials to instruments → Generate compliance documents.