anclax-develop-feature

分类: 数据库与数据存储 | 上传者: cloudcarver | 下载: 0 | 版本: v1.0（最新）

Develop, review, or refactor Go services built with Anclax, including OpenAPI specs, handlers, service/business logic, database/sqlc changes, async tasks, and Wire dependency injection.

更新日志: Source: GitHub https://github.com/cloudcarver/anclax

目录结构

当前层级: skills/anclax-develop-feature/

📄 anclax-config.md 941 B
📄 app-config.md 1.2 KB
📄 async-tasks.md 6.6 KB
📄 business-logic.md 714 B
📄 crud.md 3.1 KB
📄 database.md 1.1 KB
📄 dependency-injestion.md 727 B
📄 openapi-spec.md 893 B
📄 SKILL.md 1.7 KB

SKILL.md

---
name: anclax-develop-feature
description: Develop, review, or refactor Go services built with Anclax, including OpenAPI specs, handlers, service/business logic, database/sqlc changes, async tasks, and Wire dependency injection.
---

# Anclax Development Workflow

Use Anclax generated types as the contract between layers and keep specs/SQL as the source of truth.

## Design principles

- Singleton services with dependency injection.
- High cohesion, low coupling.

## Core flow

1. Inspect `anclax.yaml` to learn generation paths and enabled generators.
2. Update sources first:
   - OpenAPI: `api/v1.yaml`
   - Tasks: `api/tasks.yaml`
   - DB schema: `sql/migrations`
   - Queries: `sql/queries`
3. Run `anclax gen` after any spec/SQL/Wire changes.
4. Implement code against generated interfaces and types.
5. Add unit tests for service logic with mocks.

## Layering rules

- Handler: parse HTTP, call service, map errors to HTTP responses.
- Service: implement business logic, accept and return `apigen` types.
- Model: use `pkg/zcore/model` and sqlc-generated queries.
- Async tasks: define in `api/tasks.yaml`, implement `taskgen.ExecutorInterface`, enqueue via `taskgen.TaskRunner`.

## References and Examples
  - [Config](./anclax-config.md): How to use `anclax.yaml` for generator inputs/outputs.
  - [CRUD operations](./crud.md): End-to-end CRUD flow and mapping examples.
  - [OpenAPI Spec](./openapi-spec.md): Conventions for OpenAPI specs in Anclax.
  - [Business Logic](./business-logic.md): Service-layer rules and error handling.
  - [Database](./database.md): SQL/schema rules and transaction helpers.
  - [Dependency Injection](./dependency-injestion.md): Wire DI conventions.
  - [Async Tasks](./async-tasks.md): Task definitions, execution, retries, and hooks.

登录后下载/点赞/收藏 ❤ 12 | ★ 0

anclax-develop-feature

目录结构

SKILL.md

举报内容

提示