oneie
Version:
Build apps, websites, and AI agents in English. Zero-interaction setup for AI agents (Claude Code, Cursor, Windsurf). Download to your computer, run in the cloud, deploy to the edge. Open source and free forever.
405 lines (310 loc) • 12.6 kB
Markdown
title: Lemonade Stand
dimension: things
category: examples
tags: ai, connections, people, things
related_dimensions: connections, events, groups, knowledge, people
scope: global
created: 2025-11-03
updated: 2025-11-03
version: 1.0.0
ai_context: |
This document is part of the things dimension in the examples category.
Location: one/things/examples/children/lemonade-stand.md
Purpose: Documents building a lemonade stand with one platform 🍋
Related dimensions: connections, events, groups, knowledge, people
For AI agents: Read this to understand lemonade stand.
# Building a Lemonade Stand with ONE Platform 🍋
## Introduction
Have you ever had a lemonade stand? It's a fun way to learn about business! But did you know that you can make your lemonade stand even smarter with AI?
The ONE Platform helps you build apps using **6 dimensions** - that's just a fancy way of saying "6 things that make up your business." When you understand these 6 dimensions, you can build anything - from a lemonade stand to a video game to a robot that does your homework (well, maybe not that last one!).
Let's learn how to build a smart lemonade stand that learns and gets better every day!
## The 6 Dimensions (Easy Version)
Think of these as the 6 building blocks of your lemonade stand:
1. **Organization** 🏢 - Your lemonade stand business (you own it!)
2. **People** 👥 - You're the boss, your friends can help, and customers buy lemonade
3. **Things** 🧃 - Everything you have: lemonade, cups, money, even a sign!
4. **Connections** 🔗 - How things work together: customers buy lemonade, you own the stand
5. **Events** 📅 - Everything that happens: a sale, making more lemonade, counting money
6. **Knowledge** 🧠 - What your AI learns: sunny days mean more customers!
## Building Your First AI Lemonade Stand
Let's build a real lemonade stand using code! Don't worry - we'll explain every step.
```typescript
// Step 1: Create your lemonade stand (Organization)
// This is like opening your business for the first time!
const myStand = await createOrganization({
name: "Emma's Lemonade Stand",
owner: "Emma",
plan: "starter", // Just starting out!
});
// Step 2: You are the owner! (Person)
// This tells the computer that YOU are in charge
const me = await createPerson({
name: "Emma",
role: "org_owner", // You're the boss!
organizationId: myStand._id, // This is YOUR stand
});
// Step 3: Make some lemonade! (Thing)
// This is what you're selling
const lemonade = await createThing({
type: "product",
name: "Fresh Lemonade",
organizationId: myStand._id, // Belongs to your stand
properties: {
price: 1.0, // $1 per cup
inventory: 20, // You made 20 cups!
flavor: "lemon",
sweetness: "just right",
},
});
// Step 4: Create some cups (Thing)
// You need something to put the lemonade in!
const cups = await createThing({
type: "inventory",
name: "Paper Cups",
organizationId: myStand._id,
properties: {
quantity: 50, // You have 50 cups
size: "medium",
},
});
// Step 5: Your first customer arrives! (Person)
const customer = await createPerson({
name: "Alex",
role: "customer",
});
// Step 6: Alex buys lemonade! (Connection)
// This creates a link between Alex and your lemonade
await createConnection({
from: customer._id,
to: lemonade._id,
type: "purchased",
organizationId: myStand._id,
metadata: {
payment: 1.0,
time: "2:30 PM",
weather: "sunny",
},
});
// Step 7: Record the sale! (Event)
// This remembers that the sale happened
await createEvent({
type: "tokens_purchased",
actor: customer._id, // WHO: Alex
target: lemonade._id, // WHAT: bought lemonade
organizationId: myStand._id, // WHERE: at your stand
metadata: {
amount: 1.0,
weather: "sunny",
time: "2:30 PM",
customerMood: "happy",
},
timestamp: Date.now(), // WHEN: right now!
});
// Step 8: Update your inventory (Thing update)
// You sold one cup, so you have 19 left
await updateThing(lemonade._id, {
properties: {
...lemonade.properties,
inventory: 19, // One less cup!
},
});
// Step 9: The AI learns! (Knowledge)
// The AI notices patterns and helps you make decisions
// This happens automatically in the background!
```
## What the AI Learned 🧠
After running your lemonade stand for a week, your AI has learned some cool things:
### Pattern 1: Weather Matters! ☀️
- **Monday (sunny):** Sold 18 cups
- **Tuesday (rainy):** Sold 3 cups
- **Wednesday (sunny):** Sold 20 cups
- **AI's conclusion:** "Sunny days = more customers!"
- **AI's suggestion:** "Tomorrow is sunny - make 25 cups instead of 20!"
### Pattern 2: Time of Day 🕐
- **Morning (9 AM - 12 PM):** Sold 5 cups
- **Afternoon (12 PM - 3 PM):** Sold 8 cups
- **After School (3 PM - 5 PM):** Sold 12 cups
- **AI's conclusion:** "Most kids buy lemonade after school!"
- **AI's suggestion:** "Open at 3 PM on school days to save time!"
### Pattern 3: Taste Preferences 😋
- **Customer feedback:**
- "Too sour!" (3 customers)
- "Too sweet!" (1 customer)
- "Just right!" (11 customers)
- **AI's conclusion:** "Most people like it when it's 'just right' sweet!"
- **AI's suggestion:** "Add 2 more tablespoons of sugar to make it sweeter"
### Pattern 4: Price Testing 💰
- **Week 1 ($1.00 per cup):** Sold 45 cups = $45
- **Week 2 ($1.25 per cup):** Sold 40 cups = $50
- **Week 3 ($1.50 per cup):** Sold 30 cups = $45
- **AI's conclusion:** "$1.25 makes the most money!"
- **AI's suggestion:** "Price at $1.25 for best earnings"
## Your AI Can Now Help With... 🎯
### Daily Planning
- "It's going to be sunny tomorrow - prepare 30 cups instead of 20!"
- "Rain forecast for Friday - make only 10 cups or take the day off"
- "Weekend coming up - you'll need extra inventory!"
### Making Better Lemonade
- "Customer reviews say lemonade is too sour - add 2 more tablespoons of sugar"
- "5 people asked for 'less ice' - adjust your recipe!"
- "Someone suggested adding strawberries - want to try a new flavor?"
### Inventory Management
- "You're running low on lemons - order more before the weekend rush"
- "You have 12 cups left and usually sell 15 after school - need more cups!"
- "You bought 50 cups last week but only used 35 - buy 40 this time"
### Money Smarts
- "You made $45 this week - that's $10 more than last week!"
- "Lemons cost $8, sugar costs $3, cups cost $5 - total expenses: $16"
- "Revenue $45 - expenses $16 = profit $29! Great job!"
- "You've saved enough to buy a bigger lemonade pitcher!"
### Customer Happiness
- "Alex bought lemonade 3 times this week - give them a loyalty discount!"
- "10 new customers this week - your stand is getting popular!"
- "Sarah's birthday is tomorrow - make a special birthday lemonade flavor!"
## The Complete Picture: How It All Works Together 🔄
Let's see how all 6 dimensions work together in your lemonade stand:
```
🏢 ORGANIZATION: Emma's Lemonade Stand
↓
👥 PEOPLE:
- Emma (owner - that's you!)
- Mom (helper)
- Dad (supplier - buys lemons)
- Alex, Sarah, Jake (customers)
↓
🧃 THINGS:
- Fresh Lemonade (product)
- Paper Cups (inventory)
- $29 (money/tokens)
- Recipe Card (content)
- Stand Sign (asset)
↓
🔗 CONNECTIONS:
- Emma OWNS lemonade stand
- Alex PURCHASED lemonade
- Lemonade IS_IN cup
- Recipe DESCRIBES lemonade
- Mom HELPS Emma
↓
📅 EVENTS:
- Alex purchased lemonade ($1.25)
- Emma made 25 cups
- Rain stopped sales
- Sarah gave 5-star review
- Emma counted money ($29 profit!)
↓
🧠 KNOWLEDGE:
- "Sunny days → 3x more sales"
- "After school (3-5 PM) → busiest time"
- "Sweet lemonade → happy customers"
- "$1.25 price → most profit"
- "Alex is a regular → offer loyalty discount"
```
### Why This Is Powerful
Every time something happens at your lemonade stand:
1. **Organization** knows which stand it belongs to (yours!)
2. **People** know who did it (you, a helper, or a customer)
3. **Things** get created, updated, or used (lemonade, cups, money)
4. **Connections** link everything together (who bought what)
5. **Events** record what happened (for your AI to learn from)
6. **Knowledge** learns patterns and gives you smart suggestions
This is how your lemonade stand gets SMARTER every single day! 🎉
## Try It Yourself! 🚀
Want to build your own AI lemonade stand? Here's what to do:
### For Kids Learning to Code:
1. **Start Simple:** Use the code above to create your first stand
2. **Add Customers:** Create 5 different customers with different names
3. **Record Sales:** Log 10 sales throughout the day
4. **Check the AI:** Ask "What patterns do you see?"
### For Slightly Older Kids:
1. **Add New Features:**
- Different lemonade flavors (strawberry, raspberry)
- A loyalty program (buy 5, get 1 free)
- Special events (birthday parties)
2. **Track Everything:**
- Weather data
- Customer feedback
- Daily expenses
3. **Let the AI Help:**
- "Should I make more lemonade?"
- "What price is best?"
- "Which flavor sells most?"
### For Parents & Teachers:
This example teaches:
- **Business basics:** Revenue, expenses, profit
- **Data collection:** Recording what happens
- **Pattern recognition:** Learning from data
- **Decision making:** Using information to improve
- **Coding concepts:** Objects, relationships, events
- **AI fundamentals:** How machines learn from data
## What You Learned 🎓
Congratulations! You now understand the **6 dimensions** that power every app on the ONE Platform:
1. **Organization** - Who owns the business
2. **People** - Who does what (owners, helpers, customers)
3. **Things** - What exists (products, inventory, money)
4. **Connections** - How things relate (purchases, ownership)
5. **Events** - What happens (sales, reviews, restocking)
6. **Knowledge** - What the AI learns (patterns, suggestions)
### From Lemonade Stands to Video Games to Apps
These same 6 dimensions can build ANYTHING:
**A Pet Care App:**
- Organization: Pet Shelter
- People: Pet owners, volunteers
- Things: Dogs, cats, food, toys
- Connections: Owner adopts pet
- Events: Feeding time, vet visit
- Knowledge: "Dogs need 2 walks per day"
**A Homework Helper:**
- Organization: Your School
- People: Students, teachers
- Things: Assignments, textbooks
- Connections: Student assigned homework
- Events: Homework submitted
- Knowledge: "Math homework takes 30 minutes"
**A Garden Tracker:**
- Organization: Emma's Garden
- People: Gardeners
- Things: Tomato plants, seeds
- Connections: Plant in garden bed
- Events: Watering, harvesting
- Knowledge: "Water every 2 days in summer"
## Next Steps 🌟
Ready to build more? Try these projects:
### Beginner Level:
- 🍪 **Cookie Stand:** Sell cookies instead of lemonade
- 🎨 **Art Gallery:** Track your drawings and who likes them
- 📚 **Book Tracker:** Remember books you've read
### Intermediate Level:
- 🎮 **Game Points:** Track scores in your favorite game
- 🐕 **Pet Manager:** Take care of virtual pets
- 🏆 **Chore Tracker:** Earn points for doing chores
### Advanced Level:
- 🎵 **Music Playlist AI:** Learns your favorite songs
- 🍕 **Restaurant Simulator:** Run a pizza shop
- 🚀 **Space Explorer:** Manage a space station
Remember: Every big app starts with understanding these 6 simple dimensions!
## Questions? 🤔
**Q: Do I need to know coding to understand this?**
A: No! The 6 dimensions are concepts you can understand even without coding. When you're ready to code, these concepts make it easier!
**Q: Can I really build apps with this?**
A: Yes! These same 6 dimensions power apps used by millions of people. You're learning the same system that professionals use!
**Q: What if I want to build something different than a lemonade stand?**
A: Perfect! Use the same 6 dimensions for ANY idea. Just swap "lemonade" for your product and follow the same pattern!
**Q: How does the AI actually learn?**
A: Every event you record teaches the AI a little bit. After many events, it finds patterns - like "sunny = more sales." That's machine learning!
**Q: Can I share my lemonade stand with friends?**
A: Absolutely! You can invite friends as "helpers" (org_user role) and they can help run the stand with you!
**Remember:** The ONE Platform scales from lemonade stands to apps serving millions of people - and it all starts with these 6 simple dimensions! 🍋✨
Happy building! 🚀