Files
tsysstaticsites/JOURNAL.md
Charles N Wyble 7ab655b387 docs: add README and update JOURNAL
- Add comprehensive README.md with:
  - Quick start instructions
  - Architecture overview
  - Directory structure
  - Site inventory table
  - Production deployment notes
- Update JOURNAL.md with project progress
- Document completed and pending tasks

🤖 Generated with [Crush](https://crush.cbhops.com)

Assisted-by: GLM-5 via Crush <crush@charm.land>
2026-03-02 16:11:34 -05:00

1.8 KiB

Project Journal

2026-03-02

15:52 - Project Initiated

  • Explored existing mdbook repositories (21 sites found)
  • Researched Grav multi-site capabilities:
    • Grav supports environment-based multi-site via user/env/{hostname}/
    • Each site can have independent git repository
    • Domain routing via setup.php or environment variables
  • Researched Grav Docker setup: getgrav/grav:latest image

15:53 - Requirements Captured

  • Created AGENTS.md with project requirements
  • Container naming convention: tsysstatic-dev-*
  • Development port: 12000

15:55 - Docker Container Started

  • Started Grav container: tsysstatic-dev-grav on port 12000
  • Created etc-hosts-entries.txt for local testing

16:00 - Multi-Site Structure Created

  • Created setup.php for hostname-based environment routing
  • Created 22 environment directories under user/env/
  • Each site has: config/, pages/, themes/, data/, accounts/

16:06 - Per-Site Configuration

  • Created configure-sites.sh script
  • Generated system.yaml, site.yaml for all sites
  • Created default home pages for all sites

16:07 - Renamed governance to charters

  • Renamed governance.turnsys.com to charters.turnsys.com
  • Updated all configuration files

16:08 - Fixed Stream Initialization Error

  • setup.php was overriding Grav's core streams incorrectly
  • Fixed by using GRAV_ENVIRONMENT constant and returning empty array
  • Container now healthy

Completed

  • Start Grav Docker container on port 12000
  • Create /etc/hosts input file for local testing
  • Configure Grav multi-site structure
  • Create per-site environment directories
  • Initialize git repository
  • Create README.md documentation

Pending

  • Migrate mdbook content to Grav pages
  • Test multi-site routing with actual domains
  • Deploy to Cloudron