nene-records
hideyukiMORI/nene-records
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-records1 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
README
A tradução para o português deste README ainda está na fila.
NeNe Records
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.mdfor 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+ JWTorg_idclaim
Current Status
All milestones M1 – M9 are complete. See docs/todo/current.md and docs/roadmap.md for future direction.
| Area | State |
|---|---|
| Entity model | entity_types, entities, 6 typed field tables, relations, tags, revisions, archive |
| Admin UI | entity types, field defs, records, tags, SEO, navigation, media library, comments, users |
| Auth | JWT Bearer — superadmin / admin / editor roles, capability checks, org-scoped JWT |
| Multi-tenancy | organizations CRUD, org resolver middleware, per-table org isolation, superadmin UI |
| User management | invite flow, password reset, role management, org membership (1 user = 1 org) |
| Publish workflow | draft / published / archived / scheduled + published_at |
| Media | upload, library list/delete, image + file field types |
| Comments | submission, moderation API, public comment UI, admin comment management |
| Public consumer | /view/{type}/{slug}, Markdown body, site settings, navigation |
| OpenAPI | 3.1 contract, validated on every CI run |
| MCP tools | 60+ tools auto-generated from OpenAPI |
| CI | Backend (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:
| Topic | Document |
|---|---|
| Product vision | docs/explanation/product-vision.md |
| Start here (agents) | AGENTS.md |
| NENE2 inheritance map | docs/inheritance-from-nene2.md |
| Workflow | docs/workflow.md |
| Commit conventions | docs/development/commit-conventions.md |
| Coding standards | docs/development/coding-standards.md |
| Docker development | docs/development/docker.md |
| Full contributing guide | docs/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