Initial scaffold: CLAUDE.md, docs, and MCP config

- CLAUDE.md with project structure, DB access, and environment info
- docs/ with placeholder files for modular system, hooks/API, and builder fields
- .claude/settings.json with Playwright and Fetch MCP servers

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Jordan
2026-03-09 18:37:15 +00:00
commit 8f76455c96
5 changed files with 223 additions and 0 deletions

32
docs/builder-fields.md Normal file
View File

@@ -0,0 +1,32 @@
# Builder Fields & Attributes
## Field Types (`data-field-type`)
The builder uses `data-field-type` attributes to define editable areas in module templates.
<!-- TODO: Document available field types (text, image, richtext, link, repeater, etc.) -->
## Conditional Attributes
### `c-if`
<!-- TODO: Document c-if syntax and usage for conditional rendering -->
### `c-for`
<!-- TODO: Document c-for syntax for repeating elements -->
### `c-class`
<!-- TODO: Document c-class for conditional CSS classes -->
## Forms (`c-form`)
<!-- TODO: Document c-form usage for builder-integrated forms -->
## Builder Variables Access
<!-- TODO: Document how to access and use builder variables in templates -->

44
docs/hooks-and-api.md Normal file
View File

@@ -0,0 +1,44 @@
# Hooks & Server-Side API
## Hooks
Hooks are PHP files in the `hooks/` directory that execute server-side logic at specific lifecycle points.
### Hook Types
<!-- TODO: Document hook types (before_page, after_page, on_form, on_api, cron, etc.) -->
### Hook File Naming
<!-- TODO: Document naming conventions and how the CMS discovers hooks -->
### Hook Examples
<!-- TODO: Add practical examples of common hooks -->
## CmsApi
The `CmsApi` class provides methods to interact with the CMS from hooks.
<!-- TODO: Document main CmsApi methods (getPage, getRecord, createRecord, updateRecord, etc.) -->
## CocoDB
`CocoDB` is the database abstraction layer for Acai.
<!-- TODO: Document CocoDB usage (query, insert, update, delete, transactions) -->
## Database Operations
### Direct Queries
<!-- TODO: Document how to run raw SQL queries from hooks -->
### Table Schemas
Table schemas are stored as JSON files in `cms/data/schema/`. Each file defines the fields, types, and configuration of a CMS table.
<!-- TODO: Document schema format and how to create/modify tables -->

54
docs/modular-system.md Normal file
View File

@@ -0,0 +1,54 @@
# Acai Modular System
## Modules
Modules are the visual building blocks of Acai websites. Each module lives in `template/estandar/modulos/<module-id>/`.
### File structure
```
<module-id>/
├── index-base.tpl # Source Twig template (EDIT THIS)
├── index.tpl # Compiled output (auto-generated, do NOT edit)
├── style.css # Module-scoped styles
└── script.js # Module JavaScript
```
### Twig Templates
<!-- TODO: Document Twig syntax, variable access, builder vars -->
### Custom Twig Filters
<!-- TODO: Document custom filters available in Acai (e.g., |translate, |slugify, etc.) -->
### Builder Variables
<!-- TODO: Document how builder vars work, how to access them in templates -->
### Calling Modules from Other Modules
<!-- TODO: Document how to include/call modules from other modules or general sections -->
## General Sections
General sections are reusable layout blocks (headers, footers, sidebars) shared across pages.
<!-- TODO: Document how general sections differ from modules, where they live, how to create/edit them -->
## CSS & JavaScript
### Module Styles (`style.css`)
<!-- TODO: Document scoping rules, CSS conventions -->
### Module Scripts (`script.js`)
<!-- TODO: Document JS conventions, lifecycle, event handling -->
## Builder Field Types
<!-- TODO: Document data-field-type usage, c-form, c-if, c-for, c-class attributes -->