@robsun/create-keystone-app 0.1.18 → 0.2.0

package/template/scripts/check-modules.js

@@ -41,7 +41,7 @@ function parseServerModules(content) {
 }
 
 function formatList(items) {
-  return items.map((item) => `- ${item}`).join('\n')
+  return items.map((item) => `  - ${item}`).join('\n')
 }
 
 try {
@@ -60,6 +60,10 @@ try {
   }
 
   console.error('Module configuration mismatch:')
+  console.error('\napps/web/src/app.config.ts modules.enabled:')
+  console.error(formatList(webModules))
+  console.error('\napps/server/config.yaml modules.enabled:')
+  console.error(formatList(serverModules))
   if (missingInServer.length > 0) {
     console.error('\nMissing in apps/server/config.yaml:')
     console.error(formatList(missingInServer))
@@ -68,9 +72,11 @@ try {
     console.error('\nMissing in apps/web/src/app.config.ts:')
     console.error(formatList(missingInWeb))
   }
+  console.error('\nFix: keep module names identical in both files and register modules in main.tsx/manifest.go.')
   process.exit(1)
 } catch (err) {
   console.error('Failed to check modules:')
   console.error(err instanceof Error ? err.message : String(err))
+  console.error('Hint: verify apps/web/src/app.config.ts and apps/server/config.yaml exist and are valid.')
   process.exit(2)
 }

package/template/apps/server/internal/modules/demo/api/handler/task_handler.go

@@ -1,152 +0,0 @@
-package handler
-
-import (
-	"errors"
-
-	"github.com/gin-gonic/gin"
-
-	hcommon "github.com/robsuncn/keystone/api/handler/common"
-	"github.com/robsuncn/keystone/api/response"
-
-	"__APP_NAME__/apps/server/internal/modules/demo/domain/models"
-	"__APP_NAME__/apps/server/internal/modules/demo/domain/service"
-)
-
-type TaskHandler struct {
-	tasks *service.TaskService
-}
-
-func NewTaskHandler(tasks *service.TaskService) *TaskHandler {
-	if tasks == nil {
-		return nil
-	}
-	return &TaskHandler{tasks: tasks}
-}
-
-type taskInput struct {
-	Title  string            `json:"title"`
-	Status models.TaskStatus `json:"status"`
-}
-
-const defaultTenantID uint = 1
-
-func (h *TaskHandler) List(c *gin.Context) {
-	if h == nil || h.tasks == nil {
-		response.ServiceUnavailable(c, "demo tasks unavailable")
-		return
-	}
-	tenantID := resolveTenantID(c)
-
-	items, err := h.tasks.List(c.Request.Context(), tenantID)
-	if err != nil {
-		response.InternalError(c, "failed to load demo tasks")
-		return
-	}
-
-	response.Success(c, gin.H{"items": items})
-}
-
-func (h *TaskHandler) Create(c *gin.Context) {
-	if h == nil || h.tasks == nil {
-		response.ServiceUnavailable(c, "demo tasks unavailable")
-		return
-	}
-	tenantID := resolveTenantID(c)
-
-	var input taskInput
-	if err := c.ShouldBindJSON(&input); err != nil {
-		response.BadRequest(c, "invalid payload")
-		return
-	}
-
-	task, err := h.tasks.Create(c.Request.Context(), tenantID, service.TaskInput{
-		Title:  input.Title,
-		Status: input.Status,
-	})
-	if err != nil {
-		switch {
-		case errors.Is(err, service.ErrTitleRequired):
-			response.BadRequest(c, "title is required")
-		case errors.Is(err, service.ErrStatusInvalid):
-			response.BadRequest(c, "invalid status")
-		default:
-			response.InternalError(c, "failed to create demo task")
-		}
-		return
-	}
-
-	response.Created(c, task)
-}
-
-func (h *TaskHandler) Update(c *gin.Context) {
-	if h == nil || h.tasks == nil {
-		response.ServiceUnavailable(c, "demo tasks unavailable")
-		return
-	}
-	tenantID := resolveTenantID(c)
-
-	id, err := hcommon.ParseUintParam(c, "id")
-	if err != nil || id == 0 {
-		response.BadRequest(c, "invalid id")
-		return
-	}
-
-	var input taskInput
-	if err := c.ShouldBindJSON(&input); err != nil {
-		response.BadRequest(c, "invalid payload")
-		return
-	}
-
-	task, err := h.tasks.Update(c.Request.Context(), tenantID, id, service.TaskUpdateInput{
-		Title:  input.Title,
-		Status: input.Status,
-	})
-	if err != nil {
-		switch {
-		case errors.Is(err, service.ErrTaskNotFound):
-			response.NotFound(c, "task not found")
-		case errors.Is(err, service.ErrStatusInvalid):
-			response.BadRequest(c, "invalid status")
-		default:
-			response.InternalError(c, "failed to update demo task")
-		}
-		return
-	}
-
-	response.SuccessWithMessage(c, "updated", task)
-}
-
-func (h *TaskHandler) Delete(c *gin.Context) {
-	if h == nil || h.tasks == nil {
-		response.ServiceUnavailable(c, "demo tasks unavailable")
-		return
-	}
-	tenantID := resolveTenantID(c)
-
-	id, err := hcommon.ParseUintParam(c, "id")
-	if err != nil || id == 0 {
-		response.BadRequest(c, "invalid id")
-		return
-	}
-
-	if err := h.tasks.Delete(c.Request.Context(), tenantID, id); err != nil {
-		if errors.Is(err, service.ErrTaskNotFound) {
-			response.NotFound(c, "task not found")
-			return
-		}
-		response.InternalError(c, "failed to delete demo task")
-		return
-	}
-
-	response.SuccessWithMessage(c, "deleted", gin.H{"id": id})
-}
-
-func resolveTenantID(c *gin.Context) uint {
-	if c == nil {
-		return defaultTenantID
-	}
-	if tenantID, ok := hcommon.GetTenantID(c); ok && tenantID > 0 {
-		return tenantID
-	}
-	return defaultTenantID
-}

package/template/apps/server/internal/modules/demo/bootstrap/migrations/task.go

@@ -1,21 +0,0 @@
-package migrations
-
-import (
-	"fmt"
-	"log"
-
-	"gorm.io/gorm"
-
-	"__APP_NAME__/apps/server/internal/modules/demo/domain/models"
-)
-
-func Migrate(db *gorm.DB) error {
-	if db == nil {
-		return nil
-	}
-	log.Println("[demo] Running migrations...")
-	if err := db.AutoMigrate(&models.DemoTask{}); err != nil {
-		return fmt.Errorf("auto migrate demo_tasks: %w", err)
-	}
-	return nil
-}

package/template/apps/server/internal/modules/demo/bootstrap/seeds/task.go

@@ -1,33 +0,0 @@
-package seeds
-
-import (
-	"log"
-
-	"gorm.io/gorm"
-
-	"__APP_NAME__/apps/server/internal/modules/demo/domain/models"
-)
-
-func Seed(db *gorm.DB) error {
-	if db == nil {
-		return nil
-	}
-
-	var count int64
-	if err := db.Model(&models.DemoTask{}).Count(&count).Error; err != nil {
-		return err
-	}
-	if count > 0 {
-		return nil
-	}
-
-	log.Println("[demo] Seeding initial data...")
-	tasks := []models.DemoTask{
-		{Title: "Set up project", Status: models.StatusTodo},
-		{Title: "Review UI states", Status: models.StatusDone},
-	}
-	for i := range tasks {
-		tasks[i].TenantID = 1
-	}
-	return db.Create(&tasks).Error
-}

package/template/apps/server/internal/modules/demo/domain/models/task.go

@@ -1,30 +0,0 @@
-package models
-
-import "github.com/robsuncn/keystone/domain/models"
-
-type TaskStatus string
-
-const (
-	StatusTodo       TaskStatus = "todo"
-	StatusInProgress TaskStatus = "in_progress"
-	StatusDone       TaskStatus = "done"
-)
-
-func (s TaskStatus) IsValid() bool {
-	switch s {
-	case StatusTodo, StatusInProgress, StatusDone:
-		return true
-	default:
-		return false
-	}
-}
-
-type DemoTask struct {
-	models.BaseModel
-	Title  string     `gorm:"size:200;not null" json:"title"`
-	Status TaskStatus `gorm:"size:20;not null;default:'todo'" json:"status"`
-}
-
-func (DemoTask) TableName() string {
-	return "demo_tasks"
-}

package/template/apps/server/internal/modules/demo/domain/service/task_service.go

@@ -1,95 +0,0 @@
-package service
-
-import (
-	"context"
-	"strings"
-
-	"__APP_NAME__/apps/server/internal/modules/demo/domain/models"
-)
-
-type TaskRepository interface {
-	List(ctx context.Context, tenantID uint) ([]models.DemoTask, error)
-	FindByID(tenantID, id uint) (*models.DemoTask, error)
-	Create(ctx context.Context, task *models.DemoTask) error
-	Update(ctx context.Context, task *models.DemoTask) error
-	Delete(ctx context.Context, task *models.DemoTask) error
-}
-
-type TaskService struct {
-	tasks TaskRepository
-}
-
-type TaskInput struct {
-	Title  string
-	Status models.TaskStatus
-}
-
-type TaskUpdateInput struct {
-	Title  string
-	Status models.TaskStatus
-}
-
-func NewTaskService(tasks TaskRepository) *TaskService {
-	return &TaskService{tasks: tasks}
-}
-
-func (s *TaskService) List(ctx context.Context, tenantID uint) ([]models.DemoTask, error) {
-	return s.tasks.List(ctx, tenantID)
-}
-
-func (s *TaskService) Create(ctx context.Context, tenantID uint, input TaskInput) (*models.DemoTask, error) {
-	title := strings.TrimSpace(input.Title)
-	if title == "" {
-		return nil, ErrTitleRequired
-	}
-
-	status := input.Status
-	if status == "" {
-		status = models.StatusTodo
-	}
-	if !status.IsValid() {
-		return nil, ErrStatusInvalid
-	}
-
-	task := &models.DemoTask{
-		Title:  title,
-		Status: status,
-	}
-	task.TenantID = tenantID
-
-	if err := s.tasks.Create(ctx, task); err != nil {
-		return nil, err
-	}
-	return task, nil
-}
-
-func (s *TaskService) Update(ctx context.Context, tenantID, id uint, input TaskUpdateInput) (*models.DemoTask, error) {
-	task, err := s.tasks.FindByID(tenantID, id)
-	if err != nil {
-		return nil, err
-	}
-
-	if title := strings.TrimSpace(input.Title); title != "" {
-		task.Title = title
-	}
-
-	if input.Status != "" {
-		if !input.Status.IsValid() {
-			return nil, ErrStatusInvalid
-		}
-		task.Status = input.Status
-	}
-
-	if err := s.tasks.Update(ctx, task); err != nil {
-		return nil, err
-	}
-	return task, nil
-}
-
-func (s *TaskService) Delete(ctx context.Context, tenantID, id uint) error {
-	task, err := s.tasks.FindByID(tenantID, id)
-	if err != nil {
-		return err
-	}
-	return s.tasks.Delete(ctx, task)
-}

package/template/apps/server/internal/modules/demo/infra/repository/task_repository.go

@@ -1,49 +0,0 @@
-package repository
-
-import (
-	"context"
-	"errors"
-
-	"gorm.io/gorm"
-
-	"__APP_NAME__/apps/server/internal/modules/demo/domain/models"
-	"__APP_NAME__/apps/server/internal/modules/demo/domain/service"
-)
-
-type TaskRepository struct {
-	db *gorm.DB
-}
-
-func NewTaskRepository(db *gorm.DB) *TaskRepository {
-	return &TaskRepository{db: db}
-}
-
-func (r *TaskRepository) List(ctx context.Context, tenantID uint) ([]models.DemoTask, error) {
-	var tasks []models.DemoTask
-	err := r.db.WithContext(ctx).
-		Where("tenant_id = ?", tenantID).
-		Order("created_at desc").
-		Find(&tasks).Error
-	return tasks, err
-}
-
-func (r *TaskRepository) FindByID(tenantID, id uint) (*models.DemoTask, error) {
-	var task models.DemoTask
-	err := r.db.Where("tenant_id = ? AND id = ?", tenantID, id).First(&task).Error
-	if errors.Is(err, gorm.ErrRecordNotFound) {
-		return nil, service.ErrTaskNotFound
-	}
-	return &task, err
-}
-
-func (r *TaskRepository) Create(ctx context.Context, task *models.DemoTask) error {
-	return r.db.WithContext(ctx).Create(task).Error
-}
-
-func (r *TaskRepository) Update(ctx context.Context, task *models.DemoTask) error {
-	return r.db.WithContext(ctx).Save(task).Error
-}
-
-func (r *TaskRepository) Delete(ctx context.Context, task *models.DemoTask) error {
-	return r.db.WithContext(ctx).Delete(task).Error
-}

package/template/apps/server/internal/modules/demo/module.go

@@ -1,91 +0,0 @@
-package demo
-
-import (
-	"github.com/gin-gonic/gin"
-	"gorm.io/gorm"
-
-	"github.com/robsuncn/keystone/domain/permissions"
-	"github.com/robsuncn/keystone/infra/jobs"
-
-	demohandler "__APP_NAME__/apps/server/internal/modules/demo/api/handler"
-	demomigrations "__APP_NAME__/apps/server/internal/modules/demo/bootstrap/migrations"
-	demoseeds "__APP_NAME__/apps/server/internal/modules/demo/bootstrap/seeds"
-	demomodels "__APP_NAME__/apps/server/internal/modules/demo/domain/models"
-	demoservice "__APP_NAME__/apps/server/internal/modules/demo/domain/service"
-	demorepository "__APP_NAME__/apps/server/internal/modules/demo/infra/repository"
-)
-
-type Module struct {
-	tasks *demoservice.TaskService
-}
-
-func NewModule() *Module {
-	return &Module{}
-}
-
-func (m *Module) Name() string {
-	return "demo"
-}
-
-func (m *Module) RegisterRoutes(rg *gin.RouterGroup) {
-	if rg == nil || m == nil {
-		return
-	}
-	handler := demohandler.NewTaskHandler(m.tasks)
-	if handler == nil {
-		return
-	}
-	group := rg.Group("/demo")
-	group.GET("/tasks", handler.List)
-	group.POST("/tasks", handler.Create)
-	group.PATCH("/tasks/:id", handler.Update)
-	group.DELETE("/tasks/:id", handler.Delete)
-}
-
-func (m *Module) RegisterModels() []interface{} {
-	return []interface{}{&demomodels.DemoTask{}}
-}
-
-func (m *Module) RegisterPermissions(reg *permissions.Registry) error {
-	if reg == nil {
-		return nil
-	}
-	if err := reg.CreateMenu("demo:task", "Demo Tasks", "demo", 10); err != nil {
-		return err
-	}
-	if err := reg.CreateAction("demo:task:view", "View Tasks", "demo", "demo:task"); err != nil {
-		return err
-	}
-	if err := reg.CreateAction("demo:task:manage", "Manage Tasks", "demo", "demo:task"); err != nil {
-		return err
-	}
-	return nil
-}
-
-func (m *Module) RegisterJobs(_ *jobs.Registry) error {
-	return nil
-}
-
-func (m *Module) Migrate(db *gorm.DB) error {
-	if db == nil {
-		return nil
-	}
-	m.ensureServices(db)
-	return demomigrations.Migrate(db)
-}
-
-func (m *Module) Seed(db *gorm.DB) error {
-	if db == nil {
-		return nil
-	}
-	m.ensureServices(db)
-	return demoseeds.Seed(db)
-}
-
-func (m *Module) ensureServices(db *gorm.DB) {
-	if m == nil || db == nil || m.tasks != nil {
-		return
-	}
-	repo := demorepository.NewTaskRepository(db)
-	m.tasks = demoservice.NewTaskService(repo)
-}

package/template/apps/server/internal/modules/example/handlers.go

@@ -1,19 +0,0 @@
-package example
-
-import (
-	"github.com/gin-gonic/gin"
-
-	"github.com/robsuncn/keystone/api/response"
-)
-
-type HelloResponse struct {
-	Message string `json:"message"`
-	Module  string `json:"module"`
-}
-
-func handleHello(c *gin.Context) {
-	response.Success(c, HelloResponse{
-		Message: "Hello from Example module!",
-		Module:  "example",
-	})
-}

package/template/apps/web/src/modules/demo/help/overview.md

@@ -1,12 +0,0 @@
----
-helpKey: "demo/tasks"
-title: "Demo Tasks"
-description: "Manage sample tasks in the scaffold."
-category: "demo"
-tags: ["demo", "tasks"]
----
-
-# Demo Tasks
-
-Use this module as a reference for list + create + update flows. Replace it
-with real business logic when you build new modules.

package/template/apps/web/src/modules/demo/index.ts

@@ -1,7 +0,0 @@
-import { registerModule } from '@robsun/keystone-web-core'
-import { demoRoutes } from './routes'
-
-registerModule({
-  name: 'demo',
-  routes: demoRoutes,
-})