System Requirements Document (SRD)

Project Name: Hollow-Cannabis

1. Introduction

The Hollow-Cannabis project aims to bridge legacy cannabis culture into legal retail through a unique pop-up shop drop model. By pairing legacy names with licensed operators, the project leverages cultural equity, storytelling, and scarcity to create demand and premium positioning. This document outlines the system requirements for the pilot phase, focusing on validating the model in a single market with simple tactics that do not require engineering support.

2. System Overview

The Hollow-Cannabis platform will serve as a digital hub for showcasing exclusive cannabis drops. It will feature a landing page that emphasizes storytelling, scarcity, and cultural authenticity. The platform will integrate dynamic visual elements, such as a countdown timer represented by an emptying beaker, to enhance user engagement and urgency.

3. Functional Requirements

• As User, I should see a full-width hero section featuring the packaging design and a maker-first headline.
• As User, I should be able to read rich text and view visuals in the "Meet the Maker" section.
• As User, I should see a dynamic countdown timer represented by an emptying beaker.
• As User, I should see scarcity messaging like "250 units. 72 hours." integrated with the countdown timer.
• As User, I should be able to click a CTA to add the drop to my calendar pre-launch.
• As User, I should be able to click a CTA to purchase the product on launch day via a deep link to the dispensary menu.
• As User, I should see social proof, including mentions, partner co-signs, and press coverage.

4. User Personas

1. Legacy Maker

• Description: Experienced cannabis cultivators with underground reputations and cultural credibility.
• Goals: Showcase their craft and connect with a wider audience while maintaining authenticity.

2. Retail Operator

• Description: Licensed dispensaries responsible for compliant product distribution.
• Goals: Build traffic, demand, and premium positioning through exclusive drops.

3. Consumer

• Description: Cannabis enthusiasts seeking unique, culturally significant products.
• Goals: Access exclusive drops, engage with storytelling, and participate in the hype.

5. Visuals Colors and Theme

Color Palette:

• Background: #F5F9FC (soft, clean white-blue)
• Surface: #E3F2FD (light sky blue)
• Text: #212121 (dark charcoal gray for readability)
• Accent: #00C853 (vibrant green matching packaging and countdown beaker)
• Muted Tones: #B0BEC5 (soft gray for secondary elements)

6. Signature Design Concept

Dynamic Countdown Timer with Emptying Beaker Animation

The landing page will feature a visually striking countdown timer integrated into the scarcity section. The timer will be represented by a vibrant green beaker that smoothly empties as time runs out.

Details:

• Animation: The liquid inside the beaker will decrease smoothly, creating a sense of urgency.
• Color: Vibrant green (#00C853) to match the packaging and reinforce the brand identity.
• Placement: Integrated into the "Countdown Timer + Scarcity Line" section, directly below the hero image.
• Micro-interactions: Hovering over the timer will display the exact time remaining in hours, minutes, and seconds.

This concept ties the scientific, craft-oriented vibe of the drop into the user experience, making the scarcity visually compelling and memorable.

7. Non-Functional Requirements

• The platform must be responsive and optimized for mobile and desktop devices.
• The countdown timer animation must run smoothly without lag.
• The landing page must load within 3 seconds to ensure a seamless user experience.
• The system must comply with legal cannabis retail regulations in the U.S.

8. Tech Stack

Frontend:

• React for web development.

Backend:

• Python with FastAPI for API development.

Database:

• MySQL for structured data storage.

AI Tools:

• Litellm for LLM routing.
• Langchain for advanced integrations.

Local Orchestration:

• Docker and docker-compose for containerization.

Server-Side Orchestration:

• Kubernetes for scalability and deployment.

9. Assumptions and Constraints

• The pilot phase will focus on a single market in the U.S.
• No engineering support is required for this phase.
• The platform must prioritize storytelling and visual impact over complex functionality.

10. Glossary

• Legacy Maker: Cannabis cultivators with underground reputations and cultural credibility.
• Retail Operator: Licensed dispensaries responsible for compliant product distribution.
• Countdown Timer: A dynamic visual element representing the time remaining for the drop.
• Scarcity Line: Messaging emphasizing the limited availability of the product.
• CTA: Call-to-action button for user engagement.