convez.ai
MCP Server
hideyukiMORI

nene-records

hideyukiMORI/nene-records

Ver no GitHub
InicialPluginScore · de 0 a 100

Headless CMS on NENE2 — typed entities, React admin, OpenAPI 3.1, 60+ MCP tools, multi-tenant JWT. M9 complete.

Instalação

$npx convez-ai hideyukiMORI/nene-records

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 1 semana
Versão
v0.5.4
Issues abertas
39
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

NeNe Records

Backend CI Frontend CI PHP 8.4 License: MIT OpenAPI

API-first flexible entity platform built on NENE2.

NeNe Records lets you define entity types and typed fields from the admin frontend, persist them through a thin JSON API, and expose the same operations to humans, SPAs, and AI agents via OpenAPI and MCP.

Goals

  • Lighter than WordPress: no monolithic PHP runtime, no untyped post meta chaos
  • Readable: explicit schema registry, typed value tables, OpenAPI contracts
  • Secure: auth and validation at the API boundary; MCP tools never touch the database directly
  • Replaceable layers: swap the API runtime, admin UI, or consumer views independently
  • AI-native: 60+ MCP tools expose every API operation to AI clients
  • Multi-tenant: organization-scoped data with superadmin / admin / editor roles and JWT org_id enforcement

Quick Start

git clone https://github.com/hideyukiMORI/nene-records.git
cd nene-records
cp .env.example .env
docker compose up --build -d
# Admin UI → http://localhost:8080

Default credentials (local only):

  • Admin: admin@nene-records.local / nene1234
  • Editor: editor@nene-records.local / nene1234

See docs/development/docker.md for full setup details.

Architecture

Admin frontend (React)  ──┐
Consumer views          ──┼──→  NeNe Records API (NENE2)  ──→  MySQL / SQLite
AI clients (MCP)        ──┘
  • Backend: PHP 8.4, NENE2 framework, Clean Architecture (Use Cases / Repositories)
  • Frontend: React 19, TypeScript, Vite, TailwindCSS v4, React Query
  • API contract: OpenAPI 3.1 (docs/openapi/openapi.yaml)
  • MCP: 60+ tools auto-generated from OpenAPI
  • Multi-tenancy: organization-scoped data isolation; OrgResolverMiddleware + JWT org_id claim

Current Status

All milestones M1 – M9 are complete. See docs/todo/current.md and docs/roadmap.md for future direction.

AreaState
Entity modelentity_types, entities, 6 typed field tables, relations, tags, revisions, archive
Admin UIentity types, field defs, records, tags, SEO, navigation, media library, comments, users
AuthJWT Bearer — superadmin / admin / editor roles, capability checks, org-scoped JWT
Multi-tenancyorganizations CRUD, org resolver middleware, per-table org isolation, superadmin UI
User managementinvite flow, password reset, role management, org membership (1 user = 1 org)
Publish workflowdraft / published / archived / scheduled + published_at
Mediaupload, library list/delete, image + file field types
Commentssubmission, moderation API, public comment UI, admin comment management
Public consumer/view/{type}/{slug}, Markdown body, site settings, navigation
OpenAPI3.1 contract, validated on every CI run
MCP tools60+ tools auto-generated from OpenAPI
CIBackend (545 PHPUnit tests / PHPStan level 8 / CS-Fixer / OpenAPI / MCP) + Frontend (ESLint / TypeScript / Vitest) + Playwright 157 E2E tests

Contributing

NeNe Records inherits NENE2 engineering discipline:

TopicDocument
Product visiondocs/explanation/product-vision.md
Start here (agents)AGENTS.md
NENE2 inheritance mapdocs/inheritance-from-nene2.md
Workflowdocs/workflow.md
Commit conventionsdocs/development/commit-conventions.md
Coding standardsdocs/development/coding-standards.md
Docker developmentdocs/development/docker.md
Full contributing guidedocs/CONTRIBUTING.md

Rules in brief: GitHub Issue-driven work, type/issue-number-summary branches, Conventional Commits (Japanese description, English type), PR with verification and self-review checklist, no direct commits to main.

Related

  • NENE2 — PHP micro-framework (HTTP runtime, OpenAPI, MCP)
  • NENE2-FT — field trials and reference implementations

License

MIT

Ver o original no GitHub

Bom para

Relacionados