DropTone.AI

Tell us your vibe, we drop you into China.
告诉我们你的 vibe，我们把你 drop 进中国。

AI-native nightlife and entertainment concierge for young foreigners visiting Chinese cities.
面向来中国城市的海外年轻用户的 AI-native 夜生活与潮流娱乐智能体。

---

What is this? | 这是什么？

English:
DropTone.AI is an AI-native conversational agent that helps young foreigners discover, plan, and book nightlife and entertainment in Chinese cities — without needing to know Chinese or spending hours researching.

中文：
DropTone.AI 是一个 AI-native 对话式智能体，帮助年轻外国用户在中国的城市里发现、计划并预约夜生活和潮流娱乐——无需懂中文，也无需花大量时间做攻略。

It is not a content website, a Chinese-learning app, or a social platform. It is a chat-first agent that combines structured venue data with LLM-generated recommendations, survival Chinese phrases, and a free booking system.
它不是内容网站、中文学习 App 或社交平台。它是一个以聊天为核心的智能体，结合结构化场所数据、LLM 生成推荐、实用中文短语和免费预约系统。

---

Quick Start | 快速开始

# 1. Enter the web app directory / 进入 web 应用目录
cd apps/web

# 2. Install dependencies / 安装依赖
npm install

# 3. Configure environment variables / 配置环境变量
cp .env.example .env
# Edit .env with your DATABASE_URL, DEEPSEEK_API_KEY, and optional SILICONFLOW_API_KEY
# 编辑 .env，填入 DATABASE_URL、DEEPSEEK_API_KEY 和可选的 SILICONFLOW_API_KEY

# 4. Set up the database / 设置数据库
npx prisma migrate dev --name init
npm run db:seed

# 5. Start the development server / 启动开发服务器
npm run dev

Open http://localhost:3000.
打开 http://localhost:3000。

---

Tech Stack | 技术栈

Layer / 层	Tech / 技术
Framework / 框架	Next.js 14 App Router + TypeScript
Styling / 样式	Tailwind CSS + shadcn/ui
Animation / 动画	Framer Motion
Database / 数据库	PostgreSQL (Neon / local)
ORM	Prisma 5
LLM	DeepSeek v4
TTS / Image / 语音与图片	SiliconFlow
Deployment / 部署	Vercel

---

Project Structure | 项目结构

DropToneAI/
├── apps/web/              # Next.js web application / Next.js 前端应用
│   ├── app/               # App Router pages and API routes / 页面与 API
│   ├── components/        # React components / 组件
│   ├── lib/               # Utilities, AI clients, search, ORM / 工具与 AI 客户端
│   ├── prisma/            # Schema and seed data / 数据模型与种子
│   └── .env.example       # Environment variable template / 环境变量模板
├── docs/                  # Product & technical documentation / 产品与技术文档
│   ├── 01-product-spec.md
│   ├── 02-tech-spec.md
│   ├── 03-agent-content-framework.md
│   ├── 04-foreigner-first-feature-thinking.md
│   └── 05-ai-native-mvp-final.md
└── README.md              # This file / 本文件

---

Key Features | 核心功能

• AI Chat Agent — Natural-language discovery across Shanghai, Beijing, Chengdu, and Shenzhen
  AI 聊天智能体 — 自然语言发现上海、北京、成都、深圳的娱乐场所
• Rule + LLM Conversation Strategy — Intent detection, slot filling, stage progression, and fallback
  Rule + LLM 对话策略 — 意图识别、槽位填充、阶段推进与本地兜底
• Vibe It — Quick-reply preference matching
  Vibe It — 快捷回复匹配偏好
• Plan My Night — AI-generated evening itinerary with map, budget, dress code, and Chinese phrases
  Plan My Night — 生成含地图、预算、着装建议与中文短句的晚间行程
• Chinese Helper — Scene-based survival Chinese with pinyin, English, and TTS playback
  Chinese Helper — 场景化生存中文，含拼音、英文与语音播放
• Book It — Free intent-based reservation system
  Book It — 免费意向预约系统
• Save List — Save favorite venues
  收藏列表 — 收藏心仪场所
• Merchant Dashboard — View venues, bookings, and generate AI marketing content
  商家后台 — 查看店铺、预约并生成 AI 营销内容

---

Documentation | 文档

• Product Spec / 产品规格
• Tech Spec / 技术规格
• Agent Content Framework / 智能体内容框架
• Foreigner-First Thinking / 外国用户优先思考
• MVP Final Scope / MVP 最终收口

For deployment instructions, see apps/web/vercel_deploy.md.
部署说明见 apps/web/vercel_deploy.md。

---

Environment Variables | 环境变量

See apps/web/.env.example for the full list.
完整列表见 apps/web/.env.example。

Required / 必填：

• DATABASE_URL — PostgreSQL connection string / 连接串
• DEEPSEEK_API_KEY — DeepSeek API key / API 密钥

Optional / 选填：

• SILICONFLOW_API_KEY — For TTS and image generation / 用于语音与图片生成
• NEXT_PUBLIC_APP_URL — Public app URL / 公共应用地址

---

License | 许可

Private project. All rights reserved.
私有项目，保留所有权利。