Arquitectura Go estilo Alizia-BE (Educabot). Clean Architecture híbrida KISS, DI manual, entities/providers/usecases/entrypoints/repositories. Multi-tenant OrgID scope.
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
Arquitectura canónica backends Go Educabot. KISS + Clean by layers, DI manual, separación estricta.
| Usar | NO usar |
|---|---|
| API backend nueva con lógica no trivial | CLI simple / tool interno |
| Multi-tenant con OrgID scope | Prototipo throwaway |
| Necesitás testabilidad por capa | Worker de una sola función |
cmd/ — no wire/fx/dig. Verbosidad es featurecmd/ ← Entry point + DI manual
main.go, app.go, repositories.go, usecases.go, handlers.go, routes.go
src/core/ ← DOMINIO PURO (sin imports infra)
entities/ ← Structs planos (sin tags GORM/JSON)
providers/ ← Interfaces (contratos) + errors.go
usecases/{domain}/ ← Business logic, un archivo por usecase
src/entrypoints/rest/ ← HTTP handlers (sin lógica de negocio)
src/repositories/{domain}/ ← GORM impl (tags GORM acá, no en entities)
src/mocks/ ← Un mock por provider
config/ ← Env vars
db/migrations/ ← SQL up/down (golang-migrate)
entrypoints → usecases → providers (interfaces) ← repositories
core/providers/ (consumer side, Go idiom)| Capa | Responsabilidad | Reglas |
|---|---|---|
| Entities | Structs del dominio | Sin tags GORM/JSON, sin lógica de persistencia |
| Providers | Interfaces + errores sentinel | ErrValidation, ErrNotFound, ErrForbidden, etc. |
| Usecases | Request.Validate() + Execute() | Validate siempre primera línea. Validar OrgID siempre |
| Entrypoints | HTTP ↔ Request translation | Sin lógica de negocio. Mapea sentinel → HTTP code |
| Repositories | GORM impl de providers | Row structs con tags GORM acá. Traducen row ↔ entity |
CreateXxxRequest con Validate() error — wrappea con providers.ErrValidationCreateXxx con Execute(ctx, req) (result, error)createXxxImpl con deps como providersNewCreateXxx(deps) CreateXxxOrgID en cada Request de usecase, Validate() chequea OrgID != uuid.Nilorganization_id. RLS en Postgres como última barreracmd/repositories.go: buildRepositories(db) → struct con todos los reposcmd/usecases.go: buildUseCases(repos) → struct con todos los usecasescmd/handlers.go: buildHandlers(ucs) → struct con todos los handlers| Capa | Tipo | Herramientas |
|---|---|---|
| Usecases | Unit con mocks | testify + mocks por provider |
| Repositories | Integration | Postgres real (testcontainers) |
| Handlers | HTTP con usecase mockeado | httptest + testify |
→ Read references/anti-patterns.md for common architecture violations
→ Read references/checklist.md for 11-item architecture compliance checklist
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Plan, design, and implement A/B tests and experiments with statistical rigor. Covers hypothesis frameworks, sample sizing, metrics, and result analysis.
The English summary is being prepared. Showing the original description.
Web/mobile accessibility decision guide: WCAG 2.2 AA, ARIA, keyboard nav, focus management, contrast, testing. Use for: a11y, accessibility, wcag, aria, screen reader, keyboard, contrast.
The English summary is being prepared. Showing the original description.
Generate, iterate, and scale ad creative for paid advertising across Google, Meta, LinkedIn, and X. Covers platform specs, creative frameworks, and quality validation.
The English summary is being prepared. Showing the original description.
Musica interactiva para juegos: layering vertical, re-secuenciacion horizontal, stingers, reglas de transicion con sync points, y mapeo de estados de gameplay a musica. Usar para: musica adaptativa, sistema de musica dinamica, transiciones musicales, combat music.
The English summary is being prepared. Showing the original description.
Design multi-agent systems, create agent architectures, define communication patterns, and build autonomous agent workflows with structured evaluation frameworks.
The English summary is being prepared. Showing the original description.
Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, response formats, and quality loops.
The English summary is being prepared. Showing the original description.