golem15/summercms
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(01): research kernel planning

Browse Source
This commit is contained in:
Jakub Zych
2026-09-16 12:09:13 +02:00
parent 56c342de0b
commit de01194c75
5 changed files with 197 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
.planning/research/ARCHITECTURE.md
View File

@@ -1,5 +1,7 @@
# Architecture Research
**Phase 1 correction (2026-09-16):** The canonical Go module is `git.golem15.com/golem15/summercms`; the framework tool lives in this repository, while generated app `main.go` and `plugins.gen.go` live in each app. Phase 1 CONTEXT.md D-01, D-02 and D-04 supersede older `github.com/golem15/summercms` and app-owned `cmd/summer` sketches below.
**Domain:** Go CMF (WinterCMS/Laravel-shaped), headless-first, compiled-plugin model, v1 = Płytarium port
**Researched:** 2026-09-16
**Confidence:** HIGH for plugin-registration mechanics (verified against Caddy/xcaddy and PocketBase current docs) and for request-lifecycle mapping (grounded directly in the real `fonoteka` `Plugin.php`/`routes.php`); MEDIUM for the cross-plugin schema-extension pattern and the framework/app repo split (design recommendation, not yet validated by a build)

2
.planning/research/STACK.md
View File

@@ -1,5 +1,7 @@
# Stack Research
**Phase 1 correction (2026-09-16):** Plugin config uses bare IDs such as `golem15.fonoteka.*` (not `plugins.<name>.*`), and `summer dev` uses built-in `fsnotify` watching (not an external air install). Phase 1 CONTEXT.md D-06 and D-16 supersede the earlier sketches below.
**Domain:** Go 1.27 backend framework (WinterCMS/Laravel-shaped CMF), headless-first, compiled plugins, porting a PHP backend (Płytarium) to Go
**Researched:** 2026-09-16
**Confidence:** HIGH for versions and maintenance status (checked via pkg.go.dev, GitHub, official docs this session); MEDIUM for architectural recommendations that require judgment calls (migration tool choice, OpenAPI approach, config format)

2
.planning/research/go-ecosystem.md
View File

@@ -6,6 +6,8 @@ source: Research pass during the opening exploration session. Stars and last-pus
# Go ecosystem viability report (WinterCMS -> Go)
**Phase 1 correction (2026-09-16):** The watch loop is built into `summer dev` with `fsnotify`; the external air/reflex suggestion below is superseded by Phase 1 CONTEXT.md D-16.
Verdict: the "Go is closer to PHP's richness" bet holds for every concern except the plugin model, and that has a proven answer (section 2).
## 1. Ecosystem coverage