Global Herbal Village - Build Summary
Production Ready v1.0.0
Admin Diagnostics:
RoleCapabilityAudit ✓
BetaTestWizard ✓
🗺️ Application Routes
/ - Home page hero featured profiles newsletter/directory - Searchable member directory filters/join - 6-step onboarding flow role account profile media social membership/profile - Public profile view social links/dashboard - User profile management 7 tabs/profile-preview - Post-signup profile preview/steward - Admin dashboard 5 tabs restricted/beta-test-wizard - Direct route for Beta Testing Wizard🧭 Navigation Structure
Public Header:
- • Home, Directory
- • Marketplace, Mentorship Soon
- • Join the Community CTA
Authenticated Header:
- • Home, Directory
- • Admin Stewards Only
- • Settings, Logout
- • Beta Test Wizard Steward Only
📊 Data Models & Key Fields
User Built-in
- • id, created_date, full_name, email, role
- • Extended roles: herbalist, grower_supplier, retailer_maker, budding_herbalist, community_member, steward
Profile
- • Basic: user_id, role, name, bio
- • Location: country, region, city
- • Taxonomy: specialties[], interests[], cultural_background[], modalities[]
- • Contact: email, website
- • Socials: 9 platforms + other[{label,url}]
- • Media: avatar_url, banner_url, gallery[]
- • Settings: membership_tier, spotlight, visibility
- • Privacy: *_visibility controls
Support Entities
- • MembershipPlan: name, price, features[], allowed_roles[]
- • TaxonomyTerm: name, type, status, parent_id
- • SystemMessage: messaging between stewards/users
- • NewsletterSubscriber: email collection
- • AnalyticsEvent: custom event tracking
- • StewardSetting: admin configuration storage
- • BetaTest: name, description, status, created_by, start_date, end_date
Role → Membership Matrix
Herbalist:Free ✓ Premium ✓
Grower & Supplier:Free ✓ Premium ✓
Retailer & Maker:Free ✓ Premium ⏳
Budding Herbalist:Free ✓ Premium ✓
Community Member:Free ✓ Premium ✓
Steward/Admin:Admin Only 🔒
🔧 Key Features
Onboarding Flow (6 Steps):
- 1. Role selection (5 role cards)
- 2. Account creation (Google OAuth)
- 3. Profile info (name, bio, location, taxonomy)
- 4. Media upload (avatar, banner)
- 5. Social profiles (9 platforms + custom)
- 6. Membership selection (Free/Premium)
Directory Features:
- • Text search, role filter, multi-select taxonomy filters
- • Auto-surface filters when ≥10 distinct tags exist
- • Sort: Default (blended), Newest, Distance
- • Reset filters, URL persistence, infinite scroll
Social Links System:
- • 9 platforms + custom links (10 total limit)
- • Auto-normalization, regex validation
- • UTM tracking (utm_source=ghv-directory)
- • Visibility controls (public/members/hidden)
Beta Test Wizard:
- • Create, manage, and invite users to beta tests
- • Collect and view structured feedback
- • Steward-only access and configuration
⚙️ Steward Settings & Toggles
Directory Settings:
- •
spotlight_weight: Premium profile sorting multiplier (default: 100) - •
premium_price: Monthly premium price USD (default: $19) - •
always_show_taxonomy_filters: Force show filters
Profile Completion Rules:
- •
profile_completion_rules: JSON array of required fields - • Available: avatar, banner, name, location, bio, specialties, contact, role, membership
Auto-Surfacing Logic:
- • Specialty/Modality filters auto-show when ≥10 distinct tags
- • Steward override bypasses minimum requirement
- • Multi-select with search, alphabetization, counts
Beta Test Settings:
- •
beta_test_enabled: Boolean toggle to enable/disable Beta Test Wizard and associated features.
👥 Dashboard Structure
User Dashboard (7 Tabs):
- • Profile: Basic info + completion tracker
- • Media: Avatar/banner upload + gallery
- • Taxonomy: Specialty/interest/cultural/modality editors
- • Contact: Email + website fields
- • Social Links: 9 platforms + custom with visibility
- • Settings: Privacy controls + visibility toggles
- • Membership: Plan display + upgrade options
Steward Dashboard (5 Tabs):
- • Profile Approvals: Pending profile review queue
- • Taxonomy: Pending tag approval/merge/reject
- • User Management: Search, roles, suspend/activate
- • Communications: System messages + newsletter export
- • Settings: All steward toggles and configuration
🚧 Stubs & Coming Soon
Marketplace: Placeholder with "Soon" badge
Mentorship: Placeholder with "Soon" badge
Retailer Premium: Shows as waitlist/coming soon
Payment Integration: Premium membership upgrade flow
Advanced Search: Geographic distance calculations
Messaging System: Direct member-to-member communication
✅ Critical QA Paths
Homepage & Onboarding
- □ Homepage order = Hero → Village → Featured → Growth → NewsletterArchive
- □ Featured section title equals ‘Featured Members’
- □ Exactly 5 tiles render in Village section
- □ NewsletterArchive form renders with input + button, both keyboard-focusable
- □ Join flow completes all 6 steps
- □ Profile creation and preview works
- □ Dashboard accessible post-signup
Directory Functionality
- □ Search returns relevant results
- □ Filters work and persist in URL
- □ Profile cards display correctly
- □ Social links open with UTM tracking
- □ Reset filters clears all selections
Profile Management
- □ Profile editing saves properly
- □ Media uploads work (avatar/banner)
- □ Social links validate and normalize
- □ Privacy settings are respected
- □ Completion tracker updates
Admin Functions
- □ Profile approval queue functional
- □ Taxonomy management works
- □ User management actions work
- □ Settings save and apply correctly
- □ Export functions generate files
Responsive & Accessibility
- □ Mobile menu works properly
- □ Touch interactions function
- □ Screen reader navigation
- □ Keyboard-only operation
- □ Loading states display
Data & Security
- □ Profile ownership validation
- □ Role-based access control
- □ Privacy settings enforcement
- □ Contact reveal anti-scraping
- □ Member-only content protection
🎉 Build Complete - Ready for Production QA Testing
Last Updated: January 2025 • Version: 1.0.0