Riduce il routing del contact form pubblico a info, privacy e careers.

Allinea backend, configurazione env e documentazione al nuovo modello vetrina con destinatari meno granulari.

Made-with: Cursor

.env.example

@@ -7,10 +7,7 @@ CONTACT_FORM_MODE=dev
 CONTACT_FORM_RESEND_API_KEY=
 CONTACT_FORM_FROM_EMAIL=no-reply@nexstudio.com
 CONTACT_FORM_TO_EMAIL=info@nexstudio.com
-CONTACT_FORM_TO_EMAIL_SUPPORT=support@nexstudio.com
+CONTACT_FORM_TO_EMAIL_INFO=info@nexstudio.com
 CONTACT_FORM_TO_EMAIL_PRIVACY=
-CONTACT_FORM_TO_EMAIL_SECURITY=
+CONTACT_FORM_TO_EMAIL_CAREERS=
-CONTACT_FORM_TO_EMAIL_ETHICS=
-CONTACT_FORM_TO_EMAIL_LEGAL=
-CONTACT_FORM_TO_EMAIL_HR=
 CONTACT_TURNSTILE_SECRET_KEY=

README.md

@@ -1,104 +1,123 @@
-# Astro Starter Kit: Minimal
+# NexStudio Website Runbook
 
-```sh
+Sito istituzionale NexStudio basato su Astro, con deploy su Cloudflare e form contatti protetto da Turnstile.
-npm create astro@latest -- --template minimal
-```
 
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+## Obiettivo del repository
 
-## 🚀 Project Structure
+- Presentazione aziendale e servizi (homepage e pagine legali).
+- Entry point unico per richieste commerciali e supporto.
+- Base pronta per contenuti multilingua IT/EN/TH.
+- Pipeline di deploy stabile su Cloudflare.
 
-Inside of your Astro project, you'll see the following folders and files:
+## Stack tecnico
 
-```text
+- Astro + Tailwind CSS
-/
+- Adapter Cloudflare (`@astrojs/cloudflare`)
-├── public/
+- Sitemap (`@astrojs/sitemap`)
-├── src/
+- Form backend su endpoint `/api/contact`
-│   └── pages/
+- Turnstile + Resend per anti-spam e invio email
-│       └── index.astro
-└── package.json
-```
 
-Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+## Struttura essenziale
 
-There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+- `src/pages/`: pagine pubbliche e route API (`src/pages/api/contact.ts`)
+- `src/components/`: componenti UI condivisi
+- `src/data/`: contenuti testuali e configurazioni pagine
+- `public/`: asset statici (loghi, immagini, robots)
+- `.env.example`: variabili locali di riferimento
 
-Any static assets, like images, can be placed in the `public/` directory.
+## Prerequisiti
 
-## 🧞 Commands
+- Node.js 20+
+- npm 10+
+- Account Cloudflare (Pages/Workers + Turnstile)
+- Account Resend (API key + sender verificato)
 
-All commands are run from the root of the project, from a terminal:
+## Avvio locale
 
-| Command                   | Action                                           |
+1. Installazione dipendenze:
-| :------------------------ | :----------------------------------------------- |
+   - `npm install`
-| `npm install`             | Installs dependencies                            |
+2. Copia variabili di ambiente:
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+   - copia `.env.example` in `.env`
-| `npm run build`           | Build your production site to `./dist/`          |
+3. Avvio sviluppo:
-| `npm run preview`         | Preview your build locally, before deploying     |
+   - `npm run dev`
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+4. Se Vite resta in cache incoerente:
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+   - `npm run dev:fresh`
 
-## 👀 Want to learn more?
+## Comandi utili
 
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+- `npm run dev`: sviluppo locale
+- `npm run dev:fresh`: reset cache `.vite` e `.astro` + avvio dev server
+- `npm run build`: build produzione
+- `npm run preview`: preview locale della build
+- `npm run deploy:cf`: build + deploy con wrangler su output Astro
 
-## Cloudflare deploy notes
+## Configurazione contatti
 
-If you deploy with Wrangler in CI/Cloudflare, build first and deploy using Astro's generated Worker config:
+Variabili pubbliche (frontend):
+
+- `PUBLIC_CONTACT_FORM_ACTION_URL` (default consigliato: `/api/contact`)
+- `PUBLIC_CONTACT_FORM_SUCCESS_REDIRECT` (URL assoluto della pagina post-submit)
+- `PUBLIC_CONTACT_FORM_MAILTO` (fallback se action URL non disponibile)
+- `PUBLIC_CONTACT_TURNSTILE_SITE_KEY`
+
+Variabili server (Cloudflare/local):
+
+- `CONTACT_FORM_MODE` (`dev` oppure `live`)
+- `CONTACT_FORM_RESEND_API_KEY`
+- `CONTACT_FORM_FROM_EMAIL` (consigliato: `no-reply@nexstudio.ai`)
+- `CONTACT_FORM_TO_EMAIL` (default destinatario, es. `info@nexstudio.ai`)
+- `CONTACT_FORM_TO_EMAIL_INFO` (opzionale, override esplicito per area "info")
+- `CONTACT_FORM_TO_EMAIL_PRIVACY`
+- `CONTACT_FORM_TO_EMAIL_CAREERS`
+- `CONTACT_TURNSTILE_SECRET_KEY`
+
+Comportamento:
+
+- `dev`: accetta submit e scrive payload nei log (senza invio reale)
+- `live`: valida Turnstile e invia email via Resend
+
+Routing pubblico consigliato (portale vetrina):
+
+- `info`: informazioni generali/commerciali
+- `privacy`: richieste privacy e diritti interessato
+- `careers`: candidature e collaborazioni
+
+Indirizzi consigliati portale:
+
+- `info@nexstudio.ai`
+- `privacy@nexstudio.ai`
+- `careers@nexstudio.ai`
+- `no-reply@nexstudio.ai` (solo invio comunicazioni/newsletter, non destinazione inbound)
+
+## Deploy Cloudflare
+
+Impostazioni consigliate:
 
 - Build command: `npm run build`
 - Deploy command: `npm run deploy:cf`
 
-This avoids entrypoint errors like `@astrojs/cloudflare/entrypoints/server` not found.
+Questa configurazione evita errori tipo:
+`The entry-point file at "@astrojs/cloudflare/entrypoints/server" was not found.`
 
-## Contact form configuration
+## Dominio e sicurezza
 
-Set these variables for the website contact form.
+- Dominio ufficiale: `https://nexstudio.ai`
-
+- Hostname Turnstile da mantenere allineati:
-Public (frontend):
-
-- `PUBLIC_CONTACT_FORM_ACTION_URL` (default `/api/contact`)
-- `PUBLIC_CONTACT_FORM_SUCCESS_REDIRECT` (absolute URL for `_next`)
-- `PUBLIC_CONTACT_FORM_MAILTO` (fallback only if `ACTION_URL` is empty)
-- `PUBLIC_CONTACT_TURNSTILE_SITE_KEY`
-
-Server-side (Cloudflare runtime / local `.env`):
-
-- `CONTACT_FORM_MODE` (`dev` or `live`)
-- `CONTACT_FORM_RESEND_API_KEY`
-- `CONTACT_FORM_FROM_EMAIL` (verified sender in Resend, recommended `no-reply@nexstudio.com`)
-- `CONTACT_FORM_TO_EMAIL` (default recipient inbox or alias, recommended `info@nexstudio.com`)
-- `CONTACT_FORM_TO_EMAIL_SUPPORT`
-- `CONTACT_FORM_TO_EMAIL_PRIVACY`
-- `CONTACT_FORM_TO_EMAIL_SECURITY`
-- `CONTACT_FORM_TO_EMAIL_ETHICS`
-- `CONTACT_FORM_TO_EMAIL_LEGAL`
-- `CONTACT_FORM_TO_EMAIL_HR`
-- `CONTACT_TURNSTILE_SECRET_KEY`
-
-Mode behavior:
-
-- `dev`: accepts form and logs payload server-side (no real email send)
-- `live`: verifies Turnstile (if secret configured) and sends via Resend API
-
-Department routing:
-
-- the contact form includes a department selector
-- if a department-specific env is set, the email is routed to that recipient
-- otherwise it falls back to `CONTACT_FORM_TO_EMAIL`
-
-Suggested operational use:
-
-- `info@...` for prospects and generic clarifications (non-clients)
-- `support@...` for existing customers
-- `no-reply@...` as sender for newsletters and automated communications
-
-Copy `.env.example` to `.env` for local development and configure the same keys in Cloudflare Pages/Workers for production.
-
-## Production domain
-
-- Official domain: `https://nexstudio.ai`
-- Keep Turnstile widget hostnames aligned with:
   - `nexstudio.ai`
-  - `www.nexstudio.ai` (if used)
+  - `www.nexstudio.ai` (se usato)
-  - `localhost` (for local testing)
+  - `localhost` (test locale)
+- Accesso pre-go-live gestito con Cloudflare Zero Trust Access
+
+## Stato operativo attuale
+
+- Issue #1 (contact form live): implementata
+- Issue #2 (anti-spam Turnstile): implementata
+- Issue #3 (SEO base): implementata (sitemap, robots, canonical/OG/Twitter)
+- Issue #4: in avanzamento (contenuti non placeholder)
+- Issue #5: da completare (localizzazione reale IT/EN/TH)
+
+## Note operative
+
+- Per modifiche non minori usare branch dedicato (`feat/*`, `fix/*`) e merge su `main` dopo verifica.
+- Evitare commit su `main` per attivita complesse.
+- Rigenerare eventuali API key esposte e aggiornare subito i secret su Cloudflare.

src/data/home/cta.ts

@@ -30,7 +30,7 @@ export const cta = {
     nameLabel: 'Nome',
     companyLabel: 'Azienda (opzionale)',
     countryLabel: 'Paese',
-    departmentLabel: 'Reparto',
+    departmentLabel: 'Area',
     emailLabel: 'Email',
     messageLabel: 'Scrivi qui il tuo messaggio',
     submitLabel: 'Invia messaggio',
@@ -54,13 +54,9 @@ export const cta = {
     fieldEmail: 'email',
     fieldMessage: 'message',
     departmentOptions: [
-      { value: 'general', label: 'Generale' },
+      { value: 'info', label: 'Informazioni generali e commerciali' },
-      { value: 'support', label: 'Support' },
+      { value: 'privacy', label: 'Privacy' },
-      { value: 'privacy', label: 'Privacy / DPO' },
+      { value: 'careers', label: 'Careers / Collaborazioni' },
-      { value: 'security', label: 'Security / Incident Response' },
-      { value: 'ethics', label: 'Segnalazioni confidenziali (Ethics)' },
-      { value: 'legal', label: 'Legal' },
-      { value: 'hr', label: 'HR' },
     ],
   },
 } as const;

src/pages/api/contact.ts

@@ -82,12 +82,9 @@ async function sendWithResend(apiKey: string, fromEmail: string, toEmail: string
 function resolveDepartmentRecipient(runtimeEnv: RuntimeEnv, defaultRecipient: string, department: string): string {
   const normalized = department.trim().toLowerCase();
   const map: Record<string, string> = {
-    support: readEnv('CONTACT_FORM_TO_EMAIL_SUPPORT', runtimeEnv),
+    info: readEnv('CONTACT_FORM_TO_EMAIL_INFO', runtimeEnv) || defaultRecipient,
     privacy: readEnv('CONTACT_FORM_TO_EMAIL_PRIVACY', runtimeEnv),
-    security: readEnv('CONTACT_FORM_TO_EMAIL_SECURITY', runtimeEnv),
+    careers: readEnv('CONTACT_FORM_TO_EMAIL_CAREERS', runtimeEnv),
-    ethics: readEnv('CONTACT_FORM_TO_EMAIL_ETHICS', runtimeEnv),
-    legal: readEnv('CONTACT_FORM_TO_EMAIL_LEGAL', runtimeEnv),
-    hr: readEnv('CONTACT_FORM_TO_EMAIL_HR', runtimeEnv),
   };
   return map[normalized] || defaultRecipient;
 }
@@ -111,7 +108,7 @@ export const POST: APIRoute = async ({ request, locals, url }) => {
   const company = required(form.get('company'));
   const email = required(form.get('email'));
   const country = required(form.get('country'));
-  const department = required(form.get('department')) || 'general';
+  const department = required(form.get('department')) || 'info';
   const message = required(form.get('message'));
 
   if (!name || !email || !country || !message) {

src/pages/news.astro

@@ -6,13 +6,32 @@ import SubpageLayout from '../layouts/SubpageLayout.astro';
   title="Novità — NexStudio"
   description="Novità, release e articoli da NexStudio."
   heading="Novità"
-  lead="Hub comunicazioni: collegate qui il vostro blog CMS, oppure elencate manualmente le notizie."
+  lead="Aggiornamenti ufficiali su piattaforma, compliance, infrastruttura e contenuti editoriali."
 >
-  <p>
+  <p class="rounded-xl border border-emerald-500/30 bg-emerald-500/10 px-4 py-3 text-emerald-100">
-    Quando avrete contenuti da pubblicare (release di prodotto, note di
+    Stato editoriale: canale attivo. Le prossime pubblicazioni verranno aggiornate su questa pagina con frequenza periodica.
-    conformità, eventi), potete sostituire questa pagina con una raccolta
-    articoli Astro, un redirect verso Medium/Substack, o un headless CMS.
   </p>
+
+  <h2>Programma editoriale</h2>
+  <ul>
+    <li><strong>Release tecniche:</strong> aggiornamenti su funzionalita, integrazioni e miglioramenti di stabilita.</li>
+    <li><strong>Compliance:</strong> novita su policy, sicurezza applicativa e adempimenti normativi.</li>
+    <li><strong>Case e risultati:</strong> note operative su adozione, scalabilita e impatti di business.</li>
+  </ul>
+
+  <h2>Canali di distribuzione</h2>
+  <ul>
+    <li>Questa pagina resta il punto di riferimento ufficiale per annunci e changelog sintetici.</li>
+    <li>La newsletter verra attivata appena disponibile il canale comunicazioni dedicato.</li>
+    <li>I contenuti long-form potranno essere pubblicati anche su canali esterni, con rimando qui.</li>
+  </ul>
+
   <h2>Archivio</h2>
-  <p class="text-nx-muted">Nessuna news pubblicata per il momento.</p>
+  <p class="text-nx-muted">
+    In questa fase il sito e in pre-lancio operativo. Il primo blocco di news verra pubblicato con il go-live ufficiale.
+  </p>
+  <p>
+    Per richieste stampa, partnership o approfondimenti tecnici e possibile usare il form nella sezione
+    <a href="/#contatti" class="text-sky-300 hover:text-sky-200">Contatti</a>.
+  </p>
 </SubpageLayout>