Skip to content
pskclubPublic

About

A Go backend framework — A clean-break rewrite over Echo, GORM, go-redis, resty, koanf, slog, and friends.

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Latest commit

 

History

153 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mine-core

CI Integration Security Go Reference Release License: MIT

A batteries-included Go framework for backend services — HTTP, SQL, MongoDB, cache, queues, jobs, storage, mail, push, AI and observability behind one consistent context, with an in-memory implementation of every capability, so tests need no mocks.

go get github.com/pskclub/mine-core/v2

Quick start

env, _ := core.NewEnv()
db, _ := core.NewDatabase(env)
redis, _ := core.NewCache(env)

app, _ := core.NewApp(env,
    core.WithSQL("default", db),
    core.WithCache("default", redis),
)
defer app.Shutdown(context.Background())

e := core.NewHTTPServer(app, &core.HTTPOptions{AllowOrigins: []string{"*"}})
e.POST("/users", controller.CreateUser)
core.StartHTTPServer(e, env)

The full walkthrough, with a validated controller, is in Getting started.

Starting a new service? mine-core-template is a complete one to copy — modules, api/worker roles, Prisma migrations, tests and CI — ready for gonew:

go run golang.org/x/tools/cmd/gonew@latest github.com/pskclub/mine-core-template github.com/acme/orders

What's inside

Capability Built on
HTTP server, routing, binding, validation Echo v5
SQL repositories GORM — Postgres, MySQL, SQL Server, Oracle, SQLite
MongoDB repositories and aggregation mongo-driver v2
Cache, distributed locks, counters go-redis v9, or in-memory
Message queue RabbitMQ (amqp091)
Pub/sub Redis, or in-memory
Jobs, cron, durable job store gocron v2
Object storage, presigned URLs AWS SDK v2 — S3, MinIO — or in-memory
Mail and push notifications go-mail, Firebase
AI — text, typed output, tools, streaming, embeddings multi-provider, or in-memory
Errors, logging, tracing slog, Sentry
Health probes, graceful shutdown, dev tools built in
Postman and OpenAPI generation go tool postmangen

Documentation

The framework documentation lives in v2/docs/ and is written in Thai. Good places to start:

The complete index is in v2/README.md. API reference: pkg.go.dev.

Versions

Module Import path Status
v2 github.com/pskclub/mine-core/v2 ✅ Active — all new development
v1 github.com/pskclub/mine-core ⚠️ Maintenance — critical fixes only; deprecated in favour of v2

Both modules live in this repository: v2 under v2/, v1 at the root. They are versioned and released independently. If you are on v1, the migration guide walks through the move.

Contributing

Contributions are welcome — bug reports, docs fixes and code alike.

make help     # list the development targets
make check    # run what the required CI checks run

License

MIT

About

A Go backend framework — A clean-break rewrite over Echo, GORM, go-redis, resty, koanf, slog, and friends.

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages

⌂ 换网址