/ Vulcan

{
  "artifact": "View Layer Prompt",
  "stack": ["Blade", "Tailwind", "Alpine.js", "Mini sparklines"],
  "layout": {
    "regions": ["Headline KPIs", "Ticker Grid", "Alert Drawer", "News Panel"],
    "responsive_notes": "Two-column >= md, stacked accordion on mobile",
    "theme": "Light/dark toggle persisted to user preference"
  },
  "components": [
    {"id": "ticker-card", "fields": ["symbol", "score", "delta", "sparkline", "classification"]},
    {"id": "alert-pill", "states": ["neutral", "watch", "action"]},
    {"id": "sentiment-feed", "content": "Top headlines with source + timestamp"}
  ],
  "flows": [
    "Expand ticker to reveal 7-day history + rationale",
    "Filter cards by positive/negative/neutral cohorts",
    "Theme toggle updates DB + rehydrates UI"
  ],
  "accessibility": [
    "aria-labels on icon buttons",
    "visible keyboard focus on chips/cards",
    "respect prefers-reduced-motion for sparkline animations"
  ]
}

{
  "artifact": "Model Layer Prompt",
  "core_models": [
    {"name": "Ticker", "responsibilities": ["Store symbol metadata", "Expose latest score"], "relations": {"hasMany": ["SentimentSnapshot"], "hasOne": ["TickerAlertRule"]}},
    {"name": "SentimentSnapshot", "responsibilities": ["Persist normalized API result", "Emit classification + delta"], "relations": {"belongsTo": ["Ticker"]}},
    {"name": "UserPreference", "responsibilities": ["Theme + digest settings"], "relations": {"belongsTo": ["User"]}}
  ],
  "services": [
    {"class": "App\\Services\\SentimentIngestor", "steps": ["Fetch API data", "Normalize payloads", "Dispatch StoreSentimentSnapshot jobs"], "retries": "exponential backoff, alert after 3 failures"},
    {"class": "App\\Services\\AlertComposer", "steps": ["Compare score vs trailing average", "Craft copy + include source links"]}
  ],
  "queues": ["StoreSentimentSnapshot", "SendDailyDigestEmail", "SyncUserPreferenceCache"],
  "testing": ["Factories for each entity", "Service tests for success/error paths", "Contract test vs vendor schema"]
}

{
  "artifact": "Database Layer Prompt",
  "total_tables": 5,
  "tables": [
    {"name": "tickers", "columns": ["symbol", "company_name", "watch_status", "sector_tag"]},
    {"name": "sentiment_snapshots", "columns": ["ticker_id", "composite_score", "source_breakdown json", "captured_at", "ingest_run_id uuid"]},
    {"name": "ticker_alert_rules", "columns": ["ticker_id", "upper_bound", "lower_bound", "notification_channel", "cooldown_minutes"]},
    {"name": "user_preferences", "columns": ["user_id", "theme", "digest_window", "alert_threshold", "notifications_enabled"]},
    {"name": "ingest_logs", "columns": ["run_identifier", "status", "duration_ms", "error_payload json", "started_at", "finished_at"]}
  ],
  "indexing": [
    "sentiment_snapshots composite index (ticker_id, captured_at desc)",
    "ingest_logs partial index on failed status",
    "unique index on ticker_alert_rules ticker_id"
  ],
  "schema_prompt": "Generate Laravel migrations for the 5 tables above with foreign keys, timestamps, soft deletes where relevant, and referential integrity. Use the total table count to ensure consistent naming conventions."
}

{
  "artifact": "Overall Architecture Prompt",
  "layers": [
    "Presentation: Blade controllers with cached assets and CDN delivery.",
    "Application: Scheduled command + queues + observers enforcing invariants.",
    "Infrastructure: Forge-managed server, Redis for cache/queues, Horizon + Logtail."
  ],
  "pipelines": [
    "07:00 ET `sentiment:ingest` -> SentimentIngestor -> queue -> persistence + alerts.",
    "17:30 ET digest -> compile metrics -> email/push summary.",
    "Webhook publisher fires when score shift > ±0.25."
  ],
  "security": {
    "auth": "Magic links + optional 2FA",
    "secrets": "Vault integration, rotate API tokens quarterly",
    "logging": "Structured logs tagged with ingest run id"
  },
  "deployment": {
    "platform": "Laravel Forge / PHP 8.3 / MySQL 8 / Redis 7",
    "ci_cd": "GitHub Actions (phpunit + pint + npm build) before deploy",
    "monitoring": "Horizon alerts + Slack notifications + uptime pings"
  },
  "runbooks": [
    "If ingest fails 3x, pause alerts and rerun manually",
    "If quota hit, fallback to cached score + notify admin",
    "If queue latency > 2m, scale workers and inspect stuck jobs"
  ],
  "scalability": [
    "Cache aggregates refreshed after each ingest",
    "Partition sentiment_snapshots monthly once >10M rows",
    "Allow future dynamic watchlists via config"
  ]
}