Rende operativi news, runbook e routing contatti vetrina #7
@ -7,10 +7,7 @@ CONTACT_FORM_MODE=dev
|
|||||||
CONTACT_FORM_RESEND_API_KEY=
|
CONTACT_FORM_RESEND_API_KEY=
|
||||||
CONTACT_FORM_FROM_EMAIL=no-reply@nexstudio.com
|
CONTACT_FORM_FROM_EMAIL=no-reply@nexstudio.com
|
||||||
CONTACT_FORM_TO_EMAIL=info@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_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=
|
CONTACT_TURNSTILE_SECRET_KEY=
|
||||||
|
|||||||
183
README.md
183
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`
|
- Build command: `npm run build`
|
||||||
- Deploy command: `npm run deploy:cf`
|
- 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`
|
- `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.
|
||||||
|
|||||||
@ -30,7 +30,7 @@ export const cta = {
|
|||||||
nameLabel: 'Nome',
|
nameLabel: 'Nome',
|
||||||
companyLabel: 'Azienda (opzionale)',
|
companyLabel: 'Azienda (opzionale)',
|
||||||
countryLabel: 'Paese',
|
countryLabel: 'Paese',
|
||||||
departmentLabel: 'Reparto',
|
departmentLabel: 'Area',
|
||||||
emailLabel: 'Email',
|
emailLabel: 'Email',
|
||||||
messageLabel: 'Scrivi qui il tuo messaggio',
|
messageLabel: 'Scrivi qui il tuo messaggio',
|
||||||
submitLabel: 'Invia messaggio',
|
submitLabel: 'Invia messaggio',
|
||||||
@ -54,13 +54,9 @@ export const cta = {
|
|||||||
fieldEmail: 'email',
|
fieldEmail: 'email',
|
||||||
fieldMessage: 'message',
|
fieldMessage: 'message',
|
||||||
departmentOptions: [
|
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;
|
} as const;
|
||||||
|
|||||||
@ -82,12 +82,9 @@ async function sendWithResend(apiKey: string, fromEmail: string, toEmail: string
|
|||||||
function resolveDepartmentRecipient(runtimeEnv: RuntimeEnv, defaultRecipient: string, department: string): string {
|
function resolveDepartmentRecipient(runtimeEnv: RuntimeEnv, defaultRecipient: string, department: string): string {
|
||||||
const normalized = department.trim().toLowerCase();
|
const normalized = department.trim().toLowerCase();
|
||||||
const map: Record<string, string> = {
|
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),
|
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;
|
return map[normalized] || defaultRecipient;
|
||||||
}
|
}
|
||||||
@ -111,7 +108,7 @@ export const POST: APIRoute = async ({ request, locals, url }) => {
|
|||||||
const company = required(form.get('company'));
|
const company = required(form.get('company'));
|
||||||
const email = required(form.get('email'));
|
const email = required(form.get('email'));
|
||||||
const country = required(form.get('country'));
|
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'));
|
const message = required(form.get('message'));
|
||||||
|
|
||||||
if (!name || !email || !country || !message) {
|
if (!name || !email || !country || !message) {
|
||||||
|
|||||||
@ -6,13 +6,32 @@ import SubpageLayout from '../layouts/SubpageLayout.astro';
|
|||||||
title="Novità — NexStudio"
|
title="Novità — NexStudio"
|
||||||
description="Novità, release e articoli da NexStudio."
|
description="Novità, release e articoli da NexStudio."
|
||||||
heading="Novità"
|
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>
|
</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>
|
<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>
|
</SubpageLayout>
|
||||||
|
|||||||
Reference in New Issue
Block a user