Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Web20 specs

Specifications for Web20 projects, written in OpenSpec format. The code lives in the repositories each change names; this repository holds only what the code is supposed to do.

What is being specified

A single page CRUD for Symfony: make:crud generates a CRUD that runs its list, create, show, edit and delete flows in one document, with the form validated in the browser by SvarohJsFormValidatorBundle from the constraints the entity already declares, and with every action still working when JavaScript does not run.

Layout

openspec/
├── config.yaml   the schema, and the context every change is planned under
├── specs/        the source of truth, written when a change is archived
└── changes/      the changes being worked on, each with its own folder

Each change folder holds proposal.md (why and what), design.md (how, and what was decided against), tasks.md (the checklist), and specs/ with the requirements it adds to or modifies, as ## ADDED Requirements / ## MODIFIED Requirements / ## REMOVED Requirements. Nothing is in openspec/specs/ yet: a change moves its requirements there when it is archived.

The changes

Change Repository the work lands in State
add-jsfv-spa-lifecycle Svaroh/JsFormValidatorBundle, through Web20/JsFormValidatorBundle pull requests #23, #24 and #26 merged; waiting on a release
fix-unique-entity-on-edit the same pull request #25 merged; waiting on a release
add-single-page-crud-maker Web20/maker-bundle proposed; everything it depends on is merged

add-single-page-crud-maker is the CRUD itself. The other two are what the validator bundle needs before that CRUD can use it: a form injected after the initial page load was never initialized and a registration could never be taken back, and the uniqueness check reported the record being edited as a duplicate of itself, which blocked every edit.

The design of add-single-page-crud-maker was checked by writing the CRUD it describes by hand into a Symfony 8.1 application and driving it in a browser. What running it showed records what held and what it corrected.

Reading it

The Markdown is the specification; nothing has to be installed to read it. To work with it through the OpenSpec CLI:

npx openspec@latest list
npx openspec@latest validate --strict

About

OpenSpec specifications for Web20 projects

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors