This commit is contained in:
Claude Dev
2026-02-09 01:49:02 -05:00
parent 133bc56bfb
commit cf7669f270
6 changed files with 128 additions and 88 deletions

View File

@@ -25,30 +25,24 @@ This guide will help you start building the EZSCALE Billing Platform on your dev
# Clone the repository
git clone git@github.com:EZSCALE/accounting.git ezscale_billing
cd ezscale_billing
```
The Laravel 12 application is already installed in the `website/` directory as a **base install** (no additional packages or customizations yet).
## Step 2: Navigate to Laravel Directory
```bash
# All Laravel commands run from the website/ directory
cd website
# Create develop branch
git checkout -b develop
```
## Step 2: Initialize Laravel 12 Project
Since this is currently just documentation, you'll initialize a fresh Laravel 12 project:
```bash
# Install Laravel 12 with Vue + Inertia starter kit
composer create-project laravel/laravel .
# During installation, select:
# - Starter kit: Vue + Inertia
# - Testing framework: Pest
# - Database: MySQL
```
## Step 3: Configure Environment
```bash
# Copy the planning files (already in repo)
# .env file should already exist, update it:
# The .env file is in website/ - update it:
APP_NAME="EZSCALE Billing"
APP_ENV=local
@@ -102,8 +96,15 @@ EXIT;
## Step 5: Install Dependencies
All commands below should be run from the `website/` directory:
```bash
# Install PHP dependencies
cd website
# Install base PHP dependencies (already in composer.json from base install)
composer install
# Install additional PHP dependencies for the project
composer require laravel/cashier
composer require laravel/fortify
composer require laravel/passport
@@ -119,8 +120,8 @@ npm install
```bash
# Extract Vuexy theme source files to:
# resources/js/vuexy/
# resources/css/vuexy/
# website/resources/js/vuexy/
# website/resources/css/vuexy/
# Update vite.config.js to include Vuexy assets
# Update app.js to import Vuexy components
@@ -185,7 +186,11 @@ php artisan passport:install
## Step 10: Start Development Servers
All commands below should be run from the `website/` directory:
```bash
cd website
# Terminal 1: Start Laravel server
php artisan serve
@@ -235,6 +240,9 @@ php artisan test
# Pull latest changes
git pull origin develop
# Navigate to Laravel directory
cd website
# Install any new dependencies
composer install
npm install
@@ -281,7 +289,7 @@ php artisan test --coverage
Use this checklist to track Phase 1 Foundation progress:
- [ ] Laravel 12 project initialized
- [x] Laravel 12 project initialized (base install in `website/`)
- [ ] Vuexy theme integrated
- [ ] Environment configured (.env)
- [ ] Database created and connected