@robsun/create-keystone-app 0.2.15 → 0.4.0

package/template/.claude/skills/keystone-dev/references/TESTING.md

@@ -1,44 +0,0 @@
-# Keystone 开发测试清单
-
-## 快速入口
-- 仓库根目录：`pnpm test`（模板测试 + `go test ./...`）
-- 仅 Go：`go test ./...`
-- 模板项目：`pnpm -C packages/create-keystone-app/template test`
-
-## 按改动范围选择
-后端（api/domain/infra/bootstrap/server）
-- `go test ./...`
-- 若改动较大可补 `go vet ./...`
-
-模板前端（packages/create-keystone-app/template/apps/web）
-- `pnpm -C packages/create-keystone-app/template/apps/web typecheck`
-- `pnpm -C packages/create-keystone-app/template/apps/web lint`
-- `pnpm -C packages/create-keystone-app/template/apps/web test`
-
-前端核心包（packages/keystone-web-core）
-- `pnpm -C packages/keystone-web-core build`
-
-脚手架/模板变更
-- `pnpm scaffold:verify`
-
-合同变更
-- `pnpm contracts:check`
-- 如更新了合同内容，执行 `pnpm contracts:sync`
-
-## 写测试（必做）
-后端
-- 领域/服务逻辑新增或改动：在 `tests/unit/platform/service` 或对应 domain 下补单测。
-- Repository 变更：在 `tests/unit/platform/repository` 补单测。
-- 新增/调整 API：在 `tests/integration/platform/api` 补集成测试。
-- 参考用例：`tests/unit/platform/approval/service_test.go`、`tests/integration/platform/api/approval_schema_test.go`。
-
-前端（模板 web）
-- 新增页面/交互：在 `packages/create-keystone-app/template/apps/web/tests` 新增 `*.test.tsx`。
-- 使用 vitest + Testing Library（已在 `vite.config.ts` 配好 test 配置）。
-
-前端核心包（keystone-web-core）
-- 新增核心组件/逻辑：优先在模板 web 侧写集成测试覆盖。
-- 如必须在包内写单测，需要补齐包内测试配置后再添加用例。
-
-## 最小通过标准
-- 单点改动跑对应子项；跨域改动直接跑 `pnpm test`。

package/template/.codex/skills/keystone-dev/SKILL.md

@@ -1,90 +0,0 @@
----
-name: keystone-dev
-description: Build and extend Keystone modules and features (frontend + backend) with consistent structure, permissions, i18n, help docs, and OpenAPI contracts. Use when adding new modules, routes, APIs, migrations, or updating the scaffold template in this repo.
----
-# Keystone Dev
-
-## Core workflow
-1) Identify the target app root: this repo's scaffold template or a generated app.
-2) Create or update the module using the generator or the Example module as the baseline.
-3) Add or update tests for new behavior before finishing implementation.
-4) Wire frontend routes, menus, permissions, help docs, and i18n.
-5) Wire backend module registration, permissions, i18n, routes, migrations, and seeds.
-6) Update contracts and types when APIs change.
-7) Run the relevant checks before finishing.
-
-## Module creation
-- Use the generator when possible:
-  ```bash
-  pnpm create:module <module-name> [options]
-
-  Options:
-    --frontend-only    Only generate the frontend module
-    --backend-only     Only generate the backend module
-    --with-crud        Include CRUD example code
-    --with-approval    Include approval workflow code (implies --with-crud)
-    --skip-register    Skip auto registration steps
-  ```
-- Keep module names in kebab-case and consistent across frontend, backend, and permissions.
-- Prefer copying the Example module if you need a manual template.
-
-## Approval workflow (--with-approval)
-When using `--with-approval`, the generator creates:
-- **Backend**: `domain/service/approval.go` (Submit/Cancel), `domain/service/callback.go` (OnApproved/OnRejected), `api/handler/approval.go`
-- **Frontend**: `components/ApprovalActions.tsx` with status tags and action buttons
-- **Model updates**: Adds `draft/pending/approved/rejected` statuses and `ApprovalInstanceID` field
-- **I18n**: Approval-related translations in both languages
-- **Routes**: `POST /:id/submit` and `POST /:id/cancel` endpoints
-
-After generation, register the approval callback in `module.go`:
-```go
-func (m *Module) RegisterApprovalCallback(reg *approval.CallbackRegistry) error {
-    return reg.Register(service.ApprovalBusinessType, service.New{Pascal}ApprovalCallback(m.repo))
-}
-```
-
-## Frontend checklist (apps/web)
-- Add module at `apps/web/src/modules/<module>`.
-- In `index.ts`, call `loadModuleLocales` and `registerModule`.
-- In `routes.tsx`, set `handle.menu`, `handle.permission`, `handle.helpKey`, and use `labelKey`/`breadcrumbKey` for i18n.
-- Add help docs under `apps/web/src/modules/<module>/help/**` and keep `helpKey` aligned.
-- Add locale files in `apps/web/src/modules/<module>/locales/zh-CN/*.json` and `en-US/*.json`.
-
-## Backend checklist (apps/server)
-- Add module at `apps/server/internal/modules/<module>`.
-- Implement the Module interface in `module.go` and keep DDD layering (`api/`, `domain/`, `infra/`, `bootstrap/`).
-- Register permissions with `CreateMenuI18n`/`CreateActionI18n` using `{module}:{resource}:{action}`.
-- Register i18n in `RegisterI18n()` and provide `i18n/keys.go` + `i18n/locales/*.json`.
-- Register the module in `apps/server/internal/modules/manifest.go`.
-- Enable the module in `apps/server/config.yaml` (scaffold apps).
-
-## Testing development
-- Backend: add unit tests in package folders (`*_test.go`) or in `tests/unit`/`tests/integration`/`tests/perf`.
-- Frontend: add component or page tests alongside modules (e.g. `*.test.tsx`).
-- Cover critical paths first (permissions, validation, and data mutations).
-
-## Contracts and API types
-- Add or update OpenAPI specs under `contracts/NNN-<name>/`.
-- Update `CONTRACT_MAPPING` in `scripts/generate-api-types.mjs` for new contract folders.
-- Run `pnpm contracts:sync` and `pnpm -C packages/keystone-contracts generate` after contract changes.
-
-## Quality gates
-- For scaffold changes: `pnpm -C packages/create-keystone-app/template test`.
-- For contracts: `pnpm contracts:check` and `pnpm -C packages/keystone-contracts typecheck`.
-- For backend changes: `go test ./...`.
-
-## Key references
-- `packages/create-keystone-app/template/docs/CONVENTIONS.md`
-- `packages/create-keystone-app/template/docs/CODE_STYLE.md`
-- `packages/create-keystone-app/template/docs/I18N.md`
-- `packages/create-keystone-app/template/apps/web/src/modules/example`
-- `packages/create-keystone-app/template/apps/server/internal/modules/example`
-
-## Advanced templates (in `references/`)
-- `TEMPLATES.md` - 基础 CRUD + 高级业务模板（多实体、审批流、导入导出、前端高级组件）
-- `ADVANCED_PATTERNS.md` - 高级开发模式（跨模块依赖、状态机、缓存、并发控制、任务编排）
-- `PATTERNS.md` - 后端开发模式（分页、事务、批量、软删除、预加载、审批集成）
-- `CHECKLIST.md` - 模块开发完整自检清单
-- `GOTCHAS.md` - 常见陷阱与解决方案
-- `CAPABILITIES.md` - 平台完整能力清单
-- `TESTING.md` - 测试开发指南