Acecore Schools

Acecore Schools の公開案内を担当する Astro アプリケーションです。 acecore.net 本体に Schools runtime を載せず、別 repo / 別 Cloudflare Pages project として管理します。

現在の正式な申込導線は LINE または Acecore の問い合わせフォームからの無料相談です。 予約、会員ポータル、外部カレンダー連携、Schools 用 Stripe は将来計画であり、現行の公開機能ではありません。

Service Boundary

Area	Current responsibility
acecore.net	Schools への外部導線、旧 /schools/ リダイレクト、問い合わせ導線
acecore-schools	Schools 紹介ページ、ページ別 SEO、無料相談 CTA、公開情報の検索 API、Pages Functions の health
Acecore Accounts	将来の共通ログイン基盤。現行サイトでは未使用

acecore.net は予約 DB、Schools の Stripe webhook、会員 session、ICS token を持ちません。 将来、予約機能を実装する場合は、予約作成・変更・キャンセルをこの app の portal/API に集約します。 Outlook などの外部カレンダー連携は read-only ICS feed に限定する計画です。

Deployment

• Platform: Cloudflare Pages
• Project name: acecore-schools
• Production domain: schools.acecore.net
• Build command: npm run build
• Build output: dist
• Runtime functions: functions/
• Production deployment: GitHub repository integration

deploy:preview は開発時の確認用です。Direct Upload を本番完了条件にせず、GitHub の push deploy と custom domain の状態を確認します。

意味検索は OpenAI Embeddings API、Vectorize、検索回数制御と匿名の時間集計専用の D1 を使用します。 Pages PreviewではVectorizeをbindせず、SEARCH_ENABLED=falseで静的ページと既存ナビゲーションを 利用します。ProductionはOpenAI用1536次元indexへmainの7件を同期し、1536 dimensions / cosine、 vector件数、ja namespaceの照合を完了しています。ProductionのSEARCH_ENABLED=trueと healthに連動した検索UIは維持します。 client keyはCloudflare Pagesの暗号化secretでHMAC化し、期限切れD1行は検索処理と毎時の maintenance Workerで削除します。 構成、同期手順、監視、費用の上限試算、rollbackは docs/vectorize-search.mdを参照してください。

予約用のSCHOOLS_DBはまだ作成していません。検索専用のSEARCH_RATE_LIMIT_DBと、将来の 予約データベースは責務を分離します。

Planned Runtime

D1

Planned binding: SCHOOLS_DB

想定テーブル:

• guardians
• students
• instructors
• courses
• availability_slots
• bookings
• booking_events
• calendar_feeds
• stripe_events

Secrets

Cloudflare Pages の preview / production に分けて設定します。

• CLERK_SECRET_KEY
• PUBLIC_CLERK_PUBLISHABLE_KEY
• CLERK_WEBHOOK_SECRET
• STRIPE_SECRET_KEY
• STRIPE_WEBHOOK_SECRET
• RESEND_API_KEY
• SCHOOLS_ICS_TOKEN_PEPPER
• SEARCH_RATE_LIMIT_SECRET（意味検索で使用中）

Vars

wrangler.jsonc で管理します。

• ACECORE_NET_URL
• PUBLIC_APP_URL
• ALLOWED_ORIGINS
• SEARCH_ENABLED
• SEARCH_MIN_SCORE

Development

必要な環境:

• Node.js 24.18.0 以上（.node-version を参照）
• npm
• Astro v7

npm install
npm run dev
npm run build

Routes:

/
/learning/
/how-it-works/
/pricing/
/about/
/faq/
/activities/2023-summer-robot-workshop/
/api/health
/api/search

References

• acecore-systems/acecore-net#11
• acecore-systems/acecore-net#122
• acecore-systems/acecore-net#113