How to use this admin

Getting started

• Open Login and sign in with an admin account. You need a valid JWT; the app stores it for API calls.
• After login you land on the Dashboard for a high-level snapshot.
• Use the left sidebar to jump between Devotionals, Books, Tags, Users, and this guide.

API & media URLs

• The admin talks to your backend using NEXT_PUBLIC_API_URL (for example http://localhost:3002/api).
• Cover images, thumbnails, book PDFs, and devotional files are often returned as paths like /uploads/books/…. The app resolves those against the API host so previews open from the server, not from the Next.js port.
• Optional: set NEXT_PUBLIC_MEDIA_ORIGIN if static files are served from a different base URL than the API.

Dashboard

Shows summary stats from the admin API when available. Use it as a landing spot; detailed work happens in each content area.

Tags

• Tags: create, edit, and delete tags used to label books and devotionals.
• When editing books or devotionals, pick tags from the tag selector; those IDs are sent to the API.

Books

1. Go to Books and use Add New Book or click a card to edit (load full book + quiz where supported).
2. Fill Main details (title, author, description, status, ages, tags).
3. Copyright: optional copyright line is sent as copyrightContent on create (multipart) and persisted on update (JSON patch after save when needed).
4. Media: upload cover, thumbnail, and book PDF. If a PDF already exists when editing, use View current book PDF (opens from the API host).
5. Quiz: add questions with 2–4 options and exactly one correct answer; quiz is saved to the book quiz API after the book is created or updated.

Devotionals

1. Open Devotionals, then create or edit a plan.
2. Each day must have a title (required) and body content.
3. Optional files: devotional PDF, cover, thumbnail; day-level PDFs and puzzle/quiz sections follow the form layout.
4. Puzzle word lists: if you enter fill-in-the-blank words, you need at least five words for that list. Other puzzle lists are not enforced by the same rule in this UI.
5. Day quiz (admin): when viewing or editing per-day quizzes, the app uses the admin quiz endpoint where available so you can see which option is marked correct (the public GET may hide that).

Users

Lists users from the admin API and lets you change roles where the backend allows. Destructive actions use confirmation dialogs.