Files
sass-mohfarawati/docs/PROJECT_OVERVIEW.md
T
MohFarawati d48497b992
CI / quality (push) Waiting to run
refactor: drop toast + over-engineered extras, add inline admin feedback
Phase 1 cleanup of the personal-site revamp. Backend/architecture untouched;
changes are limited to removing unused complexity and restoring feedback.

Removals
- Toast system: delete react-hot-toast, Toaster, QueryToastBridge, lib/toast,
  the toggle/easter-egg calls, related i18n keys and the dependency.
- Contact protection: remove Turnstile + per-IP rate limiting
  (lib/contact-guard, lib/contact-protection, admin screen, form widget,
  app-config wiring, nav entry, test).
- Speculative specs: delete orders, products, downloads, project-inquiry.

Inline feedback (replaces toast, no new deps)
- Add lib/admin-feedback (withFlash/readFlash) and components/admin/admin-flash,
  rendered centrally by AdminDashboardShell.
- Emit success/error messages for media, site-settings, portfolio, smtp,
  marquee and maintenance actions; pages read them via searchParams.
- Contact form shows validation/delivery errors inline; success still
  redirects to /success.

Docs
- Fix stale paths in frontend-system-* (components/root -> components/admin,
  lib/root-navigation -> lib/admin-navigation, drop phantom src/) and remove
  contact-protection references from docs and CLAUDE.md.
- Add docs/PHASE0_DIAGNOSIS.md (diagnosis report).

Note: proxy.ts self-fetch kept intentionally; it also drives maintenance mode.
2026-07-14 21:03:51 +02:00

138 lines
1.6 KiB
Markdown

# Project Overview
## Summary
This project is a multilingual
`Next.js`
portfolio website with an authenticated
`admin`
workspace.
The current implementation centers on:
- Public marketing pages
- Portfolio listing and portfolio detail pages
- Contact form submission by email
- Global site configuration stored in
`AppConfig`
- Media library management
- Portfolio content management
- Maintenance mode
## Current Implementation
### Public site
- Localized routes for
`de`
,
`en`
,
`ar`
- Main pages:
`/`
,
`/about`
,
`/portfolio`
,
`/portfolio/category/[slug]`
,
`/portfolio/[slug]`
,
`/contact`
,
`/success`
,
`/coming-soon`
- Header includes a disabled
`/products`
navigation item marked as
`Soon`
### Admin workspace
- Login protected by Basic Auth at middleware level and password session inside the app
- Dedicated sections for:
- Overview
- Maintenance
- UI Kit
- Media Library
- Site Settings
- Marquee Settings
- SMTP Settings
- Portfolio management
### Data model
Current persistent entities in
`prisma/schema.prisma`
:
- `AppConfig`
- `Category`
- `PortfolioProject`
- `PortfolioSection`
- `PortfolioAsset`
- `MediaAsset`
- `MediaUsage`
No current models exist for:
- `Product`
- `Order`
- `Download`
- `ProjectInquiry`
## Recommended Improvements
- Replace the placeholder
`README.md`
with project-specific onboarding
- Add explicit domain documentation for current
`portfolio`
versus planned future commerce features
- Add persistent storage for inbound contact and inquiry submissions if auditability is required
- Add role separation if the
`admin`
area will be used by more than one operator