xamxam/docs/RESTRUCTURE_PLAN.md

Repository Restructure Plan

Current Structure

posterg-website/
├── apps/
│   ├── public/       # Public website
│   └── admin/        # Admin panel
├── shared/           # Shared PHP libraries
├── database/         # Database files
├── nginx/            # Server config
└── docs/             # Documentation

Proposed Structure (Idiomatic PHP)

posterg-website/
├── index.php         # Public website root
├── memoire.php
├── search.php
├── apropos.php
├── contact.php
├── licences.php
├── assets/           # Static files (CSS, JS, images)
│   ├── posterg.css
│   ├── normalize.css
│   └── fonts/
├── inc/              # Page templates/partials
│   ├── header.php
│   └── footer.php
├── lib/              # Shared libraries (renamed from shared/)
│   ├── Database.php
│   ├── RateLimit.php
│   ├── config.php
│   └── cache/
├── admin/            # Admin panel (from apps/admin/)
│   ├── index.php
│   ├── list.php
│   ├── edit.php
│   └── ...
├── database/         # Database files & schema
│   ├── schema.sql
│   ├── test.db
│   └── ...
├── vendor/           # Third-party dependencies (gitignored)
│   └── php-live-reload/  # Local dev only
├── nginx/            # Server configuration
├── docs/             # Documentation
├── tests/            # Tests (future)
└── .gitignore        # Updated

Benefits

✅ Standard PHP structure - Follows common conventions ✅ Flatter hierarchy - Easier to navigate ✅ Clear separation - lib/ for code, inc/ for templates, assets/ for static files ✅ Simpler paths - Less ../../ in require statements ✅ Vendor folder - Standard for third-party code

Migration Steps

1. Move public to root

mv apps/public/* .

2. Move admin

mv apps/admin admin/
rm -rf apps/

3. Rename shared to lib

mv shared lib/

4. Update all require paths

• require_once __DIR__ . '/shared/Database.php' → require_once __DIR__ . '/lib/Database.php'
• require_once __DIR__ . '/../shared/Database.php' → require_once __DIR__ . '/../lib/Database.php'

5. Setup vendor for local dev

mkdir -p vendor/
echo "vendor/" >> .gitignore

Path Changes Summary

Old Path	New Path
apps/public/index.php	index.php
apps/public/inc/header.php	inc/header.php
apps/public/assets/posterg.css	assets/posterg.css
apps/admin/index.php	admin/index.php
shared/Database.php	lib/Database.php
shared/config.php	lib/config.php
shared/cache/	lib/cache/

Deployment Changes

Before

rsync apps/public/ posterg:/var/www/html/
rsync apps/admin/ posterg:/var/www/html/formulaire/
rsync shared/ posterg:/var/www/html/shared/

After

rsync --exclude 'vendor' --exclude 'tests' . posterg:/var/www/html/

Much simpler!

PHP Live Reload Setup

For Local Development Only

1. Clone to vendor/php-live-reload/ (gitignored)
2. Include in local dev server
3. Auto-refresh browser on file changes
4. Never deployed to production

Usage

# Setup (one time)
just setup-dev

# Start dev server with live reload
just serve-public  # or serve-admin