The BEE Suite
Childcare CRM, school operations, billing, parent portal, teacher portal, and executive reporting platform.
Last refreshed: September 23, 2026
The BEE Suite is a multi-tenant, white-label operating system for childcare brands and schools. It supports inquiry intake, enrollment, families, children, classrooms, staffing, tuition billing, Stripe Connect payout setup, parent communications, documents, compliance workflows, FTE reporting, role-specific portals, and human-reviewed AI assistance.
Current State
- Production app:
https://thebeesuite.io
- Hosting: Vercel project
the-bee-suite
- Database/Auth/Storage: Supabase-backed Prisma application
- Payments: Stripe Checkout and Connect foundations with school payout onboarding and autopay billing workflows
- Communication: in-app messaging, SendGrid email paths, Twilio SMS foundations, notification preferences, and delivery logging
- Rollout focus: Kokomo may continue approved normal production use; the wider Kid City school wave and each sensitive module remain independently gated
Main User Flows
- Parents:
/parents for parent login, /parent-portal for family account access, /parents/setup and /parent-portal/setup for onboarding/setup flows.
- Teachers:
/teachers for teacher login and /teacher-portal for classroom-safe workflows.
- Directors:
/directors for school operations login and /dashboard, /messages, /billing-settings, /staff, /documents, /attendance, /daily-reports, /incident-reports, /fte-reports, and related school modules.
- Executives:
/executives for corporate login, /multi-location-dashboard, /agency-admin, /team-permissions, /analytics, /fte-reports, and cross-location reporting.
- Public/support:
/, /app, /registration, /check-in, /support, /resources, /privacy, /login, /forgot-password, and /reset-password.
Most operating modules are served through src/app/[slug]/page.tsx with RBAC and center/family/classroom scoping enforced server-side.
Tech Stack
- Next.js 16 App Router, React 19, TypeScript, Tailwind CSS, shadcn-style UI primitives, Recharts, and lucide-react.
- Prisma 6 with Supabase/Postgres.
- Supabase Auth session-cookie login plus server-side user/access-grant checks.
- Stripe Checkout, Connect, billing webhooks, payment method setup, autopay/dunning/reminder cron routes, and terminal store checkout.
- SendGrid/Twilio integration paths for email/SMS and in-app notification records.
- Playwright-assisted visual capture scripts and Node test coverage for core workflows.
Repository Layout
.
├── docs/ Operational docs, SOPs, rollout plans, launch guides, security notes
├── ios/ Capacitor iOS parent shell
├── native/ Static native/PWA shell helpers
├── output/ Committed launch screenshots, graphics, and printable deliverables
├── prisma/ Prisma schema, seed data, and migrations config
├── public/ Brand/public assets
├── scripts/ Import, rollout, payout, setup, graphics, and validation scripts
├── src/
│ ├── app/ App Router pages, role portal routes, API routes, cron routes
│ ├── components/ Workspace panels, forms, dashboards, portal UI, shared UI primitives
│ └── lib/ Auth, RBAC, billing, communications, import, reporting, Stripe/Supabase helpers
├── supabase/ Supabase config and SQL migrations
├── tests/ Node test suite for guardrails and critical workflows
└── wordpress-avada/ Kid City public inquiry embed snippets
Local Setup
npm install
npm run cloud:link
npm run cloud:env
npm run dev
Open http://localhost:3000.
Use .env.example as the safe template. Do not commit .env.local, pulled production env files, SendGrid env files, or machine-specific Supabase/Vercel temp state.
For machine setup details, see docs/LOCAL_CLOUD_SETUP.md.
For parallel Codespace quick fixes and isolated local worktrees, see docs/CLOUD_LOCAL_WORKFLOW.md.
Common Commands
npm run lint
npm run typecheck
npm test
npm run vercel-build
npm run cloud:validate
npm run work:quick -- <slug>
npm run work:tree -- <slug>
npm run test:smoke
Database and rollout helpers:
npm run db:generate
npm run db:migrate
npm run pilot:check
npm run procare:prepare-rendered -- <secure-export-directory> <ignored-review-directory>
npm run kidcity:ensure-corporate-schools
npm run kidcity:prepare-school-payouts
Production Vercel builds use:
npm run vercel-build
That command runs Prisma generate, lint, typecheck, the full Node test suite, and next build.
Environment Variables
Start from .env.example. Important production groups:
- App/auth:
APP_URL, NEXT_PUBLIC_APP_URL, AUTH_SECRET, AUTH_PASSWORD_RESET_REDIRECT_URL
- Supabase/Postgres:
DATABASE_URL, POSTGRES_URL, POSTGRES_PRISMA_URL, SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY
- Stripe:
STRIPE_SECRET_KEY, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, STRIPE_WEBHOOK_SECRET, Connect/payment fee settings, payout settings, and STRIPE_ACCOUNTS_V2_API_VERSION=2026-06-24.dahlia
- Messaging:
SENDGRID_API_KEY, SENDGRID_FROM_EMAIL, Twilio account/auth/from/webhook settings, and server-only Web Push VAPID keys
- Operations:
CRON_SECRET, OPENAI_API_KEY, Google Sheets/Calendar credentials where enabled
See docs/DEPLOYMENT.md, docs/STRIPE_CONNECT.md, and docs/STRIPE_CONNECT_SETUP.md.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
