crud-generator

name: crud_generator description: A blueprint for generating new CRUD modules (Backend & Frontend) based on the Maulana Laundry Admin pattern.

CRUD Generator Blueprint

Follow this blueprint to create a new management module (e.g., Inventory, Transactions, Customers).

1. Backend: Data Model

Create backend/models/[name].go.

package models

import (
    "time"
    "gorm.io/gorm"
)

type [ModelName] struct {
    ID        uint           `gorm:"primaryKey" json:"id"`
    // Add fields here
    CreatedAt time.Time      `json:"created_at"`
    UpdatedAt time.Time      `json:"updated_at"`
    DeletedAt gorm.DeletedAt `gorm:"index" json:"deleted_at"`
}

2. Backend: Handler

Create backend/handlers/[name]_handler.go. Implement the following pattern:

• Get[Models] (Filtered, Paginated, Unscoped for Archived)
• Create[Model]
• Update[Model]
• Archive[Model] (Soft delete)
• Restore[Model] (Set deleted_at to gorm.DeletedAt{})
• Delete[Model] (Permanent)

3. Frontend: Type Definition

Create frontend/src/types/[name].ts.

export interface [ModelName] {
    id: number;
    // fields
    created_at: string;
    updated_at: string;
    deleted_at: any | null;
}

4. Frontend: Service Layer

Create frontend/src/services/[name].service.ts. Use the Axios api instance.

5. Frontend: Page Component

Create frontend/src/pages/admin/[ModelName]Page.tsx.

• Copy structure from UserPage.tsx.
• Include isArchived helper.
• use DataTable component.
• Implement stats cards at the top.

6. Registration

1. Backend: Add to database.DB.AutoMigrate in main.go.
2. Backend: Register routes in routes/routes.go.
3. Frontend: Add route to App.tsx.
4. Frontend: Add to sidebar in AdminLayout.tsx.