mirror of
https://codeberg.org/PostERG/xamxam.git
synced 2026-09-25 01:53:03 +02:00
Pontoporeia
25c5133086
The contenus page loaded both lookup tables in full via HTMX on page load: 760 tag rows + 216 language rows, ~2.4MB of HTML including ~1960 inline SVG icons and per-row CSRF forms. The DB queries were already fast (~6ms); the cost was pure client-side payload and DOM. - Add paged lookups: getTagsPage/getLanguagesPage + countTagsWithCount/ countLanguagesWithCount, and optional limit/offset on the existing unpaged variants (backward compatible). - Fragments serve 25 rows per request. A sentinel <tr> with hx-trigger="intersect once root:#<wrap>" appends the next page when it scrolls into the table's own scroll container (htmx 'revealed' only checks the window viewport, not nested scrollers). - Search forms still swap the whole wrapper and reset to offset 0. - Style the load-more row; add PagedLanguagesTagsTest coverage. Initial DOM for the page drops from ~2.4MB to ~160KB; scrolling reaches the full totals (736 tags, 216 languages) and stops cleanly.
Admin Panel Structure
This directory and app/templates/admin/ contain the admin panel for managing
the XAMXAM TFE database.
Entry points (app/public/admin/)
| File | Purpose |
|---|---|
index.php |
List all theses (main page; hosts the inline CSV import + tabs for list/trash) |
add.php |
Add new thesis form |
edit.php |
Existing thesis form |
recapitulatif.php |
Post-submission recap |
cleanup.php |
Cleanup page (Corbeille — restore/delete trashed files) |
system.php |
System dashboard (logs, SMTP/PeerTube status) |
contenus.php |
Editable content (pages, contacts) |
contenus-edit.php |
Edit a content page |
acces.php |
Share-link management |
file-access.php |
Restricted-file access requests |
media.php |
Admin file viewer — opens files of 'Interdit' (access_type_id=3) theses; session-gated (AdminAuth::requireLogin), delegates to MediaController::handle(adminBypass: true) |
media-viewer.php |
HTML wrapper that opens a thesis file with a reliable tab title (original file name); embeds the file via media.php in a full-viewport iframe |
account.php |
Admin account / password |
login.php |
Login (session) |
import.php |
Redirects to /admin/ (CSV import is inline in index.php) |
status.php, markdown-cheatsheet-fragment.php, *fragment.php |
HTMX fragments / helpers |
Backend actions (app/public/admin/actions/)
Process forms and redirect (no HTML output):
formulaire.php— thesis create submission (ThesisCreateController::submit())edit.php— thesis edit submission (ThesisEditController::save())export-csv.php,export-db.php,export-files.php— seedocs/export.mdfilepond/— FilePond async upload endpoints- many others:
publish,delete,corbeille(trash),draft,visibility,tag,language,form-help*,page,apropos,smtp-test,peertube-*,maintenance,settings,account,access-request,acces-etudiante,cleanup-*
Templates
View templates live under app/templates/admin/ (not in public/):
app/templates/admin/*.php— page layoutsapp/templates/admin/partials/— shared fragments (toasts, dialogs, toc, …)
The public/partage and form partials live in app/templates/partials/ and
app/templates/partage/.
Auth
- PHP session auth (
src/AdminAuth.php) viaAdminAuth::requireLogin()is the only authentication layer. The old nginxauth_basiclayer has been removed — seedocs/security.mdandnginx/docs/PHP_AUTH_LAYER.md. - All forms include a CSRF token from
$_SESSION['csrf_token']. - Inputs use PDO prepared statements; uploads validated and stored outside the
webroot (
app/storage/).
Bootstrap / routing
Entry pages bootstrap the app and set up the environment:
require_once __DIR__ . '/../../bootstrap.php'; // defines APP_ROOT, autoload, config
require_once APP_ROOT . '/src/AdminAuth.php';
AdminAuth::requireLogin();
APP_ROOT is the app/ directory. Database access is via
app/src/Database.php; form logic lives in app/src/Controllers/ and
app/src/Form/.
URL structure
/admin/— list theses (index.php)/admin/add.php— add thesis/admin/edit.php?id=N— edit thesis/admin/cleanup.php,/admin/system.php,/admin/acces.php, etc./admin/actions/…— backend processors
Development guide
Add a page: create app/templates/admin/yourpage.php, add a thin
app/public/admin/yourpage.php entry that bootstraps + requires the template,
and add navigation in app/templates/admin/partials/admin-toc.php.
Add an action: create app/public/admin/actions/youraction.php that
bootstraps, requires login, verifies the CSRF token, performs the work, and
redirects back to the referring admin page.
See docs/development.md for the general workflow (dev server, builds,
tests, linting).