Files
hub/docs/APP_OVERVIEW.md
Jon Leopard ed871a6275 FIRST
2025-05-19 17:10:49 -07:00

2.3 KiB
Raw Permalink Blame History

Cannabrands B2B Platform Development Plan

🚧 Development Tools

  • ChatGPT: For strategic planning, architecture decisions, and feature scaffolding
  • Cursor: For inline AI-assisted coding and refactoring
  • Figma: UI design source, translated using Tailwind CSS
  • Git/GitHub: Version control

🧱 Chosen Tech Stack

Layer Technology
Backend Laravel (latest stable)
Frontend Blade + Tailwind CSS
UI Components DaisyUI
Admin Panel Filament (optional, phase 2+)
Permissions spatie/laravel-permission
Media Uploads spatie/laravel-medialibrary
Notifications Laravels built-in Notification system
Dynamic UI Livewire (optional, if needed)
Testing Pest (preferred over PHPUnit)

🧭 Development Approach

  • App is structured in phases for incremental development.
  • Phase 1 includes:
    • Buyer & Seller roles
    • Authentication & registration
    • Role-based dashboards:
      • Buyer: Browse products, place orders, view order history
      • Seller: Manage product listings, process orders
    • Product catalog & order system (with line items)
    • Order status notifications
    • Clean, modular Laravel codebase with minimal tech debt

🎨 Design Process

  • All components must follow TailwindCSS spacing and typography utilities.
  • Use DaisyUI to implement components cleanly.
  • Translate pixel-perfect Figma designs into Blade components.
  • Components should be reusable and match a design system.

🧠 Workflow & Philosophy

  • Use AI (ChatGPT + Cursor) heavily throughout development.
  • Prioritize clean, service-based logic over bloated controllers.
  • Avoid premature Livewire or SPA complexity — introduce only where justified.
  • Prefer Blade + Tailwind + Alpine for UI.
  • Use spatie/laravel-permission and spatie/laravel-medialibrary over custom ACLs/media logic.

🏗️ Future Phases (Outline)

  • Add multi-tenancy using spatie/laravel-multitenancy or stancl/tenancy
  • Consider Filament for internal admin panel
  • Add customer invoicing and payment features
  • Advanced analytics/dashboarding
  • Audit trail and activity logging