Files
go-micro/model/model_test.go
T
Asim AslamandClaude 76bfeae456 Claude/update docs roadmap f zd2 j (#2880)
* docs: update all four documentation guides and mark Q2 complete

- ai-native-services: add WithMCP one-liner, standalone gateway,
  WebSocket client example, and OpenTelemetry observability section
- mcp-security: add OTel distributed tracing, WebSocket authentication
  (connection-level and per-message), DeniedReason audit field
- tool-descriptions: add manual overrides with WithEndpointDocs and
  export formats section
- agent-patterns: add LangChain/LlamaIndex SDK pattern and standalone
  gateway production pattern with Docker example
- Update roadmap: mark Q2 documentation as complete, Q2 at 100%
- Update status: reflect all recent completions, shift priorities

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* feat: add agent demo example and blog post

Add examples/agent-demo with a multi-service project management app
(projects, tasks, team) that demonstrates AI agents interacting with
Go Micro services through MCP. Includes seed data and example prompts.

Add blog post 4 "Agents Meet Microservices: A Hands-On Demo" walking
through the example code and showing cross-service agent workflows.

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* feat: enable multiple services in a single binary

Remove global state mutations from service and cmd option functions so
that configuring one service no longer overwrites another's settings.

Key changes:
- service/options.go: remove all DefaultXxx global writes from option
  functions; newOptions() now creates fresh Server, Client, Store, and
  Cache per service while sharing Registry, Broker, and Transport
- cmd/cmd.go: newCmd() uses local copies instead of pointers to package
  globals; Before() no longer mutates DefaultXxx vars
- cmd/options.go: remove global mutations from all option functions
- service/service.go: export ServiceImpl type for cross-package use
- service/group.go: new Group type for multi-service lifecycle
- micro.go: add Start/Stop to Service interface, expose Group and
  NewGroup convenience function
- examples/multi-service: working example with two services

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* docs: highlight multi-service binary support

Add multi-service section to README with code example, update features
list, add to examples index, and note in status summary.

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* feat: unify service API and clean up developer experience

- Unified service creation: micro.New("name", opts...) as canonical API
- Clean handler registration: service.Handle(handler, opts...) accepts
  server.HandlerOption args directly, no need to reach through Server()
- Unexported serviceImpl: users interact through Service interface only
- Service groups use Service interface (not concrete type)
- Fixed Stop() to properly propagate BeforeStop/AfterStop errors
- Fixed store init: error-level log instead of fatal on init failure
- Updated all examples to use consistent patterns
- Updated README, getting-started, MCP docs, and guides
- Added blog post about the DX cleanup

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* fix: add blog post 5 to blog index

Blog post 5 (Developer Experience Cleanup) existed as a file but was
missing from the blog index page.

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* feat: make micro new generate MCP-enabled services by default

- main.go template includes mcp.WithMCP(":3001") by default
- Handler template has agent-friendly doc comments with @example tags
- Proto template has descriptive field comments
- README includes MCP usage, Claude Code config, and tool description tips
- Makefile adds mcp-tools, mcp-test, mcp-serve targets
- go.mod updated to Go 1.22
- Added --no-mcp flag to opt out of MCP integration
- Post-create output shows MCP endpoint URLs

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* docs: add MCP migration guide and troubleshooting guide

- Migration guide: 3 approaches to add MCP to existing services
  (WithMCP one-liner, standalone gateway, CLI)
- Troubleshooting guide: common issues with agents, WebSocket,
  Claude Code, auth, rate limiting, and performance

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* refactor: rename model/ package to ai/ for AI model providers

The model/ package name conflicted with the conventional use of "model"
for data models. Renamed to ai/ which better describes the package's
purpose (AI provider abstraction for Anthropic, OpenAI, etc.) and frees
up model/ for future data model layer use.

- Rename model/ → ai/ with package name change
- Update all Go imports from go-micro.dev/v5/model to go-micro.dev/v5/ai
- Update cmd/micro/server/server.go references (model.X → ai.X)
- Update all documentation and roadmap references
- All tests pass, CLI builds successfully

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* feat: add model package for typed data access with CRUD and queries

New model/ package provides a typed data model layer using Go generics.
Supports structured CRUD operations, WHERE filters, ordering, pagination,
and automatic schema creation from struct tags.

Three backends:
- memory: in-memory for development and testing
- sqlite: embedded SQL for dev and single-node production
- postgres: full PostgreSQL for production deployments

Key features:
- Generic Model[T] with Create/Read/Update/Delete/List/Count
- Query builder: Where(), WhereOp(), OrderAsc/Desc(), Limit(), Offset()
- Struct tags: model:"key" for primary key, model:"index" for indexes
- Auto table creation from struct schema
- 19 tests passing across memory and sqlite backends

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* feat: add model code generation to protoc-gen-micro

Extend the micro plugin to generate model structs from proto messages
annotated with // @model. Generated alongside client/server code in
the same .pb.micro.go file.

For a proto message like:
  // @model
  message User { string id = 1; string name = 2; }

Generates:
- UserModel struct with model:"key" and json tags
- NewUserModel(db) factory returning *model.Model[UserModel]
- UserModelFromProto(*User) *UserModel converter
- (*UserModel).ToProto() *User converter

Supports @model(table=custom_table, key=custom_field) options.
Adds GetComments() to generator for plugin comment inspection.

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

* feat: add Model() to Service interface for Client/Server/Model trifecta

Every service now exposes Client(), Server(), and Model() — call services,
handle requests, and save/query data from the same interface. Includes
README docs, blog post, and a full model guide on the docs site.

https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-03-04 13:13:34 +00:00

141 lines
3.2 KiB
Go

package model
import (
"reflect"
"testing"
)
type TestUser struct {
ID string `json:"id" model:"key"`
Name string `json:"name" model:"index"`
Email string `json:"email"`
Age int `json:"age"`
}
func TestBuildSchema(t *testing.T) {
schema := buildSchema(reflect.TypeOf(TestUser{}))
if schema.Table != "testusers" {
t.Errorf("expected table 'testusers', got %q", schema.Table)
}
if schema.Key != "id" {
t.Errorf("expected key 'id', got %q", schema.Key)
}
if len(schema.Fields) != 4 {
t.Fatalf("expected 4 fields, got %d", len(schema.Fields))
}
// Check key field
var keyField Field
var indexField Field
for _, f := range schema.Fields {
if f.IsKey {
keyField = f
}
if f.Index {
indexField = f
}
}
if keyField.Column != "id" {
t.Errorf("expected key column 'id', got %q", keyField.Column)
}
if indexField.Column != "name" {
t.Errorf("expected index column 'name', got %q", indexField.Column)
}
}
func TestBuildSchema_DefaultKey(t *testing.T) {
type Item struct {
ID string `json:"id"`
Name string `json:"name"`
}
schema := buildSchema(reflect.TypeOf(Item{}))
if schema.Key != "id" {
t.Errorf("expected default key 'id', got %q", schema.Key)
}
}
func TestBuildSchema_WithTable(t *testing.T) {
schema := buildSchema(reflect.TypeOf(TestUser{}))
WithTable("my_users")(schema)
if schema.Table != "my_users" {
t.Errorf("expected table 'my_users', got %q", schema.Table)
}
}
func TestStructToMap(t *testing.T) {
schema := buildSchema(reflect.TypeOf(TestUser{}))
u := &TestUser{ID: "1", Name: "Alice", Email: "alice@example.com", Age: 30}
m := structToMap(schema, u)
if m["id"] != "1" {
t.Errorf("expected id '1', got %v", m["id"])
}
if m["name"] != "Alice" {
t.Errorf("expected name 'Alice', got %v", m["name"])
}
if m["email"] != "alice@example.com" {
t.Errorf("expected email 'alice@example.com', got %v", m["email"])
}
if m["age"] != 30 {
t.Errorf("expected age 30, got %v", m["age"])
}
}
func TestMapToStruct(t *testing.T) {
schema := buildSchema(reflect.TypeOf(TestUser{}))
m := map[string]any{
"id": "1",
"name": "Bob",
"email": "bob@example.com",
"age": 25,
}
u := mapToStruct[TestUser](schema, m)
if u.ID != "1" {
t.Errorf("expected ID '1', got %q", u.ID)
}
if u.Name != "Bob" {
t.Errorf("expected Name 'Bob', got %q", u.Name)
}
if u.Email != "bob@example.com" {
t.Errorf("expected Email 'bob@example.com', got %q", u.Email)
}
if u.Age != 25 {
t.Errorf("expected Age 25, got %d", u.Age)
}
}
func TestApplyQueryOptions(t *testing.T) {
q := ApplyQueryOptions(
Where("name", "Alice"),
WhereOp("age", ">", 20),
OrderDesc("name"),
Limit(10),
Offset(5),
)
if len(q.Filters) != 2 {
t.Fatalf("expected 2 filters, got %d", len(q.Filters))
}
if q.Filters[0].Field != "name" || q.Filters[0].Op != "=" || q.Filters[0].Value != "Alice" {
t.Errorf("unexpected filter 0: %+v", q.Filters[0])
}
if q.Filters[1].Field != "age" || q.Filters[1].Op != ">" {
t.Errorf("unexpected filter 1: %+v", q.Filters[1])
}
if q.OrderBy != "name" || !q.Desc {
t.Errorf("expected order by name desc, got %q desc=%v", q.OrderBy, q.Desc)
}
if q.Limit != 10 {
t.Errorf("expected limit 10, got %d", q.Limit)
}
if q.Offset != 5 {
t.Errorf("expected offset 5, got %d", q.Offset)
}
}