@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/hi-IN/template-analytics.md

@@ -0,0 +1,259 @@
+---
+title: "एनालिटिक्स"
+description: "एनालिटिक्स प्रश्न सादे अंग्रेजी में पूछें, चार्ट और डैशबोर्ड वापस प्राप्त करें। एम्प्लीट्यूड, मिक्सपैनल और लुकर के लिए एक ओपन-सोर्स प्रतिस्थापन।"
+---
+
+# एनालिटिक्स
+
+साधारण अंग्रेजी में एनालिटिक्स प्रश्न पूछें, चार्ट और डैशबोर्ड वापस प्राप्त करें। एजेंट BigQuery, GA4, एम्प्लिट्यूड, अंतर्निहित प्रथम-पक्ष ईवेंट कलेक्टर, HubSpot, जीरा और एक दर्जन अन्य स्रोतों से जुड़ता है, आपके लिए क्वेरी लिखता है, इसे मान्य करता है, और उत्तर को चार्ट, तालिका या सहेजे गए डैशबोर्ड पैनल के रूप में प्रस्तुत करता है।
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:500px;box-sizing:border-box'><h1 style='margin:0'>Agent-Native Templates</h1><p class='wf-muted' style='margin:0'>Adoption and engagement across the last 12 weeks.</p><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:12px'><div class='wf-card'><small class='wf-muted'>Weekly active users</small><br/><strong>24,318</strong><br/><span class='wf-pill accent'>+12.4%</span></div><div class='wf-card'><small class='wf-muted'>New signups</small><br/><strong>1,842</strong><br/><span class='wf-pill accent'>+8.7%</span></div><div class='wf-card'><small class='wf-muted'>Revenue MRR</small><br/><strong>$48,210</strong><br/><span class='wf-pill accent'>+21.3%</span></div></div><div style='display:grid;grid-template-columns:1fr 1fr;gap:12px;flex:1'><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Weekly active users</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:38%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:44%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:58%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:74%;flex:1;background:var(--wf-accent-soft)'></div></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Revenue over time</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:32%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:48%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:63%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:80%;flex:1;background:var(--wf-accent-soft)'></div></div></div></div><div class='wf-card'><strong>Signups by source</strong><br/><small class='wf-muted'>Lower chart begins below the main charts.</small></div></div>"
+}
+```
+
+यह एम्प्लिट्यूड, मिक्सपैनल और लुकर के लिए एक ओपन-सोर्स प्रतिस्थापन है - उन टीमों के लिए जो कोड, क्वेरी और डेटा का मालिक बनना चाहते हैं।
+
+```an-diagram title="Question to chart" summary="The agent consults the data dictionary, writes SQL, validates it against the warehouse, then renders a chart or saves a panel."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-node\">Plain-English<br>question</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads data dictionary</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Writes SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">Dry-run validate</div><small class=\"diagram-muted\">BigQuery / source</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Chart, table, or<br>saved panel</div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:6px;align-items:center}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## आप इसके साथ क्या कर सकते हैं
+
+- **साधारण अंग्रेजी में डेटा प्रश्न पूछें।** "पिछले महीने कितने प्रतिशत साइनअप भुगतान में परिवर्तित हो गए?" या "मुझे पिछले 6 महीनों के साप्ताहिक सक्रिय उपयोगकर्ता दिखाएँ।" एजेंट सही स्रोत चुनता है, SQL लिखता है, और चार्ट प्रस्तुत करता है।
+- **फ़िल्टर, सहेजे गए दृश्य और पैरामीट्रिक क्वेरी के साथ पुन: प्रयोज्य SQL डैशबोर्ड बनाएं**।
+- **तदर्थ विश्लेषण चलाएं** जो कई डेटा स्रोतों को क्रॉस-रेफरेंस करता है - मूल प्रश्न, निर्देशों और निष्कर्षों के साथ पुन: चलाने योग्य जांच के रूप में सहेजा गया है।
+- **मेट्रिक्स, तालिकाओं और SQL व्यंजनों का एक जीवंत डेटा शब्दकोश बनाए रखें** ताकि एजेंट हर बार सही कॉलम नामों का उपयोग कर सके (जब यह वास्तव में `hs_is_closed` है तो `is_closed` का अनुमान नहीं लगाया जाता है)।
+- **अपनी टीम के साथ डैशबोर्ड साझा करें** - डिफ़ॉल्ट रूप से निजी, प्रति-उपयोगकर्ता या दर्शक/संपादक/व्यवस्थापक भूमिकाओं के साथ प्रति-संगठन साझा करने योग्य।
+- **कई स्रोतों से कनेक्ट करें** बॉक्स से बाहर: BigQuery, GA4, Mixpanel, Amplitude, PostHog, HubSpot, जीरा, अपोलो, पाइलॉन, गोंग, कॉमन रूम, ट्विटर, साथ ही ऐप-विशिष्ट SEO स्रोत।
+- **कार्यस्थान एकीकरण का पुन: उपयोग करें** जब कोई कार्यक्षेत्र पहले ही कनेक्ट हो चुका हो और
+  एनालिटिक्स को एक प्रदाता प्रदान किया गया। साझा एकीकरण स्टोर प्रदाता
+  पहचान और क्रेडेंशियल संदर्भ; एनालिटिक्स ऐप-विशिष्ट स्रोत चयन रखता है,
+  डेटा शब्दकोश प्रविष्टियाँ, डैशबोर्ड SQL, और विश्लेषण इतिहास।
+
+## आरंभ करना
+
+लाइव डेमो: [analytics.agent-native.com](https://analytics.agent-native.com).
+
+जब आप पहली बार ऐप खोलते हैं:
+
+1. Google के साथ साइन इन करें।
+2. साइडबार से **डेटा स्रोत** पृष्ठ खोलें।
+3. प्रत्येक स्रोत के पास एक पूर्वाभ्यास है - जो आपको चाहिए उसे कनेक्ट करें (किसी एक से शुरू करें, जैसे BigQuery, GA4, एम्प्लिट्यूड, या प्रथम-पक्ष ट्रैकिंग)।
+4. एजेंट के साथ एक नई चैट खोलें और एक प्रश्न पूछें: "पिछले सप्ताह हमें कितने साइनअप मिले?"
+
+पहला प्रश्न यह पुष्टि करने के लिए पर्याप्त है कि कनेक्शन काम कर रहा है। वहां से, एजेंट से "इसे डैशबोर्ड के रूप में सहेजने" या "हमारे प्रमुख मेट्रिक्स के लिए 4-पैनल अवलोकन डैशबोर्ड बनाने" के लिए कहें।
+
+### उपयोगी संकेत
+
+- "पिछले 6 महीनों के साप्ताहिक सक्रिय उपयोगकर्ताओं को दिखाने वाला एक डैशबोर्ड बनाएं।"
+- "पिछले महीने कितने प्रतिशत साइनअप भुगतान में परिवर्तित हो गए?"
+- "इस डैशबोर्ड पर योजना के अनुसार राजस्व की तुलना करने वाला एक चार्ट जोड़ें।"
+- "इस डैशबोर्ड पर पैनलों को पुन: व्यवस्थित करें ताकि MRR मीट्रिक पहले आए।"
+- "Q1 से हमारे बंद-खोए सौदों का विश्लेषण करें और विश्लेषण को सहेजें।"
+- "इस महीने के डेटा के साथ मंथन विश्लेषण फिर से चलाएँ।"
+- "इस मीट्रिक को डेटा डिक्शनरी में दस्तावेज़ित करें।"
+
+एजेंट हमेशा जानता है कि आप क्या देख रहे हैं - वर्तमान डैशबोर्ड, फ़िल्टर, दृश्य - इसलिए आप स्पष्ट हुए बिना "यह डैशबोर्ड" या "वह पैनल" कह सकते हैं।
+
+## जानने योग्य तीन बातें
+
+ऐप में तीन प्राथमिक सतहें हैं जिन पर आप समय व्यतीत करेंगे:
+
+- **SQL डैशबोर्ड** - फ़िल्टर और सहेजे गए दृश्यों के साथ पुन: प्रयोज्य पैनल। उन मेट्रिक्स के लिए सर्वश्रेष्ठ जिन्हें आप नियमित रूप से जांचते हैं।
+- **तदर्थ विश्लेषण** - लंबी अवधि की जांच जो कई स्रोतों से ली जाती है, साथ में पुन: चलाने के निर्देश भी सहेजे जाते हैं। उन एकमुश्त प्रश्नों के लिए सर्वश्रेष्ठ, जिन पर आप दोबारा गौर करना चाहेंगे।
+- **डेटा डिक्शनरी** - मेट्रिक्स, टेबल, कॉलम और SQL व्यंजनों की कैनोनिकल कैटलॉग। एजेंट किसी भी SQL को लिखने से पहले इसकी सलाह लेता है, इसलिए यह वास्तविक वेयरहाउस कॉलम नामों का उपयोग करता है और "आंतरिक ईमेल को छोड़कर" जैसी चेतावनियों के बारे में जानता है।
+
+शब्दकोश को एजेंट से पूछकर तैयार किया जाता है: "हमारी डीबीटी परिभाषाएँ आयात करें" या "हमारे Notion हैंडबुक से मेट्रिक्स खींचें" और यह काम करता है।
+
+## डेवलपर्स के लिए
+
+इस दस्तावेज़ का शेष भाग एनालिटिक्स टेम्प्लेट की खोज करने वाले या उसका विस्तार करने वाले किसी भी व्यक्ति के लिए है।
+
+### त्वरित शुरुआत
+
+CLI से एक नया एनालिटिक्स ऐप बनाएं:
+
+```bash
+npx @agent-native/core@latest create my-analytics --standalone --template analytics
+```
+
+स्थानीय देव:
+
+```bash
+cd my-analytics
+pnpm install
+pnpm dev
+```
+
+CLI स्थानीय डेव URL प्रिंट करता है। Google के साथ साइन इन करें, फिर BigQuery, GA4, प्रथम-पक्ष ट्रैकिंग, HubSpot, जीरा और बाकी को कनेक्ट करने के लिए **डेटा स्रोत** पृष्ठ खोलें।
+
+### मुख्य विशेषताएं
+
+**प्रश्न पूछें, चार्ट प्राप्त करें।** एजेंट एक डेटा स्रोत चुनता है, SQL लिखता है और सत्यापित करता है, फिर एक चार्ट, तालिका, मीट्रिक, या सहेजा गया पैनल प्रस्तुत करता है।
+
+**डैशबोर्ड और जांच।** पुन: प्रयोज्य डैशबोर्ड SQL पैनल, फ़िल्टर, सहेजे गए दृश्य और साझाकरण रखते हैं; तदर्थ विश्लेषण पुन: चलाने के निर्देशों के साथ लंबे निष्कर्षों को सहेजते हैं।
+
+**जीवित डेटा शब्दकोश।** मीट्रिक परिभाषाएँ, स्वामी, स्रोत तालिकाएँ और ज्ञात चेतावनियाँ एजेंट को प्रश्न लिखने से पहले वास्तविक वेयरहाउस शब्दावली प्रदान करती हैं।
+
+**व्यापक कनेक्टर सतह।** BigQuery, GA4, उत्पाद विश्लेषण, CRM, समर्थन, समुदाय, GitHub/Jira, SEO, और प्रथम-पक्ष `/track` इवेंट सभी actions के माध्यम से आते हैं जिन्हें एजेंट कॉल कर सकता है।
+
+### एजेंट के साथ काम करना
+
+एजेंट को हमेशा पता होता है कि आप क्या देख रहे हैं। वर्तमान स्क्रीन स्थिति को प्रत्येक संदेश में `<current-screen>` ब्लॉक के रूप में इंजेक्ट किया जाता है - इसमें सक्रिय दृश्य, खुला डैशबोर्ड या विश्लेषण और कोई भी चयनित फ़िल्टर शामिल होता है।
+
+एजेंट के सिस्टम प्रॉम्प्ट को सक्रिय संगठन के लिए अनुमोदित मीट्रिक प्रविष्टियों के साथ एक इंजेक्टेड `<data-dictionary>` ब्लॉक मिलता है। जब आप डैशबोर्ड मांगते हैं, तो एजेंट पहले शब्दकोश की जांच करता है और प्रलेखित `table` / `columns` / `queryTemplate` शब्दशः का उपयोग करता है - यह कॉलम नामों का अनुमान नहीं लगाता है।
+
+**संदर्भ यह स्वचालित रूप से है:**
+
+- **वर्तमान दृश्य** - `overview`, `adhoc` (`dashboardId` के साथ), `analyses` (`analysisId` के साथ), `data-dictionary`, `data-sources`, या `settings`।
+- **सक्रिय संगठन** - सभी प्रश्नों का दायरा रखता है और लिखता है।
+- **स्वीकृत शब्दकोश प्रविष्टियाँ** — सक्रिय कार्यक्षेत्र के लिए।
+
+**डैशबोर्ड संपादन।** एजेंट डैशबोर्ड को संपादित करने के लिए `update-dashboard` क्रिया का उपयोग करता है। यह दो मोड का समर्थन करता है:
+
+- `ops` - सर्जिकल संपादन के लिए JSON-पॉइंटर पैच (एक पैनल को स्थानांतरित करें, एक SQL स्ट्रिंग को बदलें, एक फ़िल्टर हटाएं)।
+- `config` - डैशबोर्ड कॉन्फ़िगरेशन का पूर्ण प्रतिस्थापन।
+
+डैशबोर्ड सेव होने से पहले प्रत्येक BigQuery पैनल के SQL को वेयरहाउस के विरुद्ध ड्राई-रन किया जाता है। यदि कोई कॉलम गलत है, तो सेव को BigQuery त्रुटि के साथ अस्वीकार कर दिया जाता है - एजेंट SQL को ठीक करता है और टूटे हुए पैनल को बनाए रखने के बजाय पुनः प्रयास करता है।
+
+### डेटा स्रोतों को कनेक्ट करना
+
+प्रदाताओं को जोड़ने के लिए **डेटा स्रोत** पृष्ठ (`/data-sources`) खोलें। प्रत्येक
+स्रोत एक एनवी-कुंजी सूची, एक वॉकथ्रू और एक **टेस्ट कनेक्शन** बटन को उजागर करता है।
+जब Analytics किसी कार्यक्षेत्र में चल रहा होता है, तो `data-source-status` भी रिपोर्ट करता है
+`appId=analytics` के लिए पुन: प्रयोज्य कार्यक्षेत्र कनेक्शन प्रदान किया गया ताकि एजेंट ऐसा कर सके
+उसी प्रदाता कुंजी की दूसरी प्रति के बजाय ऐप अनुदान मांगें।
+Slack, HubSpot, Notion, और GitHub जैसे पुन: प्रयोज्य प्रदाताओं के लिए, डेटा
+स्रोत UI सीधे साझा एकीकरण स्थिति दिखाता है: कार्यक्षेत्र के माध्यम से तैयार,
+अनुदान की आवश्यकता है, प्रमाण-पत्रों की आवश्यकता है, या स्थानीय प्रमाण-पत्रों की आवश्यकता है।
+
+पुन: प्रयोज्य कार्यक्षेत्र एकीकरण साझा प्रदाताओं के लिए रनटाइम दिशा है:
+फ्रेमवर्क प्रदाता की पहचान, खाता मेटाडेटा, क्रेडेंशियल संदर्भ और
+प्रति-ऐप अनुदान एक बार; एनालिटिक्स डेटा-स्रोत व्याख्या,
+सत्य विकल्प, मीट्रिक परिभाषाएँ, डैशबोर्ड और विश्लेषण।
+
+क्रेडेंशियल्स को फ्रेमवर्क की सेटिंग्स/एनवी परत के माध्यम से संग्रहीत किया जाता है - गिट में कोई रहस्य नहीं है। उत्पादन के लिए आवश्यक है:
+
+| वेरिएबल                                  | उद्देश्य                                           |
+| ---------------------------------------- | -------------------------------------------------- |
+| `DATABASE_URL`                           | लगातार SQL कनेक्शन URL                             |
+| `BETTER_AUTH_SECRET` / `BETTER_AUTH_URL` | प्रामाणिक                                          |
+| `GOOGLE_SIGN_IN_CLIENT_ID` / `_SECRET`   | पसंदीदा Google साइन-इन क्लाइंट (OAuth 2.0)         |
+| `GOOGLE_CLIENT_ID` / `_SECRET`           | विरासत साइन-इन फ़ॉलबैक / Google API एकीकरण क्लाइंट |
+| `BIGQUERY_PROJECT_ID`                    | बिगक्वेरी प्रोजेक्ट                                |
+| `GOOGLE_APPLICATION_CREDENTIALS_JSON`    | BigQuery सेवा-खाता JSON                            |
+| `ANTHROPIC_API_KEY`                      | एजेंट चैट                                          |
+
+प्रदाता-विशिष्ट कुंजियाँ (HubSpot, जिरा, गोंग, पाइलॉन, आदि) डेटा स्रोत पृष्ठ पर प्रत्येक स्रोत के वॉकथ्रू में प्रलेखित हैं। यदि आप कोई नई क्रिया जोड़ते हैं जिसके लिए API कुंजी की आवश्यकता होती है, तो यह टेम्पलेट के ऑनबोर्डिंग पंजीकरण के माध्यम से उस पृष्ठ पर एक नए स्रोत के रूप में दिखाई देता है।
+
+ध्यान दें: Google साइन-इन के लिए BigQuery OAuth क्रेडेंशियल **अलग** है
+BigQuery सेवा खाते JSON से क्रेडेंशियल।
+GCP कंसोल → APIs और सेवाएँ → क्रेडेंशियल्स → OAuth क्लाइंट आईडी, और पसंद करें
+`GOOGLE_SIGN_IN_CLIENT_ID` / `GOOGLE_SIGN_IN_CLIENT_SECRET` env नाम तो यह
+कम-स्कोप लॉगिन क्लाइंट Google API एकीकरण क्लाइंट से अलग रहता है।
+
+### डेटा मॉडल
+
+कोर टेबल (`templates/analytics/server/db/schema.ts` देखें):
+
+```an-schema title="Analytics data model" summary="Dashboards and analyses are the resources; views, shares, and a query cache hang off them. Org tables come from @agent-native/core/org."
+{
+  "entities": [
+    {
+      "id": "dashboards",
+      "name": "dashboards",
+      "note": "Explorer and SQL dashboards",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "kind", "type": "text", "note": "\"explorer\" or \"sql\"" },
+        { "name": "config", "type": "text", "note": "JSON matching SqlDashboardConfig" }
+      ]
+    },
+    {
+      "id": "dashboard_views",
+      "name": "dashboard_views",
+      "note": "Saved filter presets per dashboard",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "dashboard_id", "type": "text", "fk": "dashboards.id" }
+      ]
+    },
+    {
+      "id": "analyses",
+      "name": "analyses",
+      "note": "Re-runnable ad-hoc investigations",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "question", "type": "text" },
+        { "name": "instructions", "type": "text", "note": "Re-run steps" },
+        { "name": "dataSources", "type": "text", "note": "Sources touched" },
+        { "name": "resultMarkdown", "type": "text" },
+        { "name": "resultData", "type": "text", "nullable": true }
+      ]
+    },
+    {
+      "id": "bigquery_cache",
+      "name": "bigquery_cache",
+      "note": "Result cache keyed by SQL hash",
+      "fields": [
+        { "name": "sql_hash", "type": "text", "pk": true },
+        { "name": "bytes_processed", "type": "integer" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "dashboards", "to": "dashboard_views", "kind": "1-n", "label": "saved views" }
+  ]
+}
+```
+
+साथ ही `@agent-native/core/org` द्वारा प्रदान की गई प्रति-संसाधन शेयर टेबल (`dashboard_shares`, `analysis_shares`) और ऑर्ग टेबल (`organizations`, `org_members`, `org_invitations`)। डेटा डिक्शनरी फ्रेमवर्क की `settings` तालिका में स्कोप्ड कुंजियों के अंतर्गत रहती है।
+
+- **`dashboards`** - एक्सप्लोरर और SQL दोनों डैशबोर्ड। `kind` `"explorer"` या `"sql"` है; `config` एक JSON ब्लॉब है जो `SqlDashboardConfig` से मेल खाता है।
+- **`dashboard_shares`** - प्रति-संसाधन शेयर अनुदान (मूलधन, भूमिका)।
+- **`dashboard_views`** - प्रति डैशबोर्ड सहेजे गए फ़िल्टर प्रीसेट।
+- **`analyses`** - `question`, `instructions`, `dataSources`, `resultMarkdown` और वैकल्पिक `resultData` के साथ तदर्थ जांच।
+- **`analysis_shares`** - विश्लेषण के लिए प्रति-संसाधन शेयर अनुदान।
+- **`bigquery_cache`** - बाइट्स-संसाधित लेखांकन के साथ SQL हैश द्वारा कुंजीबद्ध क्वेरी परिणाम कैश।
+
+साथ ही `@agent-native/core/org` द्वारा प्रदान की गई ऑर्ग टेबल (`organizations`, `org_members`, `org_invitations`)।
+
+डेटा डिक्शनरी फ्रेमवर्क की `settings` तालिका में स्कोप्ड कुंजियों के अंतर्गत रहती है; पूर्ण आकार के लिए `list-data-dictionary` और `save-data-dictionary-entry` actions देखें।
+
+### इसे अनुकूलित करना
+
+एनालिटिक्स टेम्प्लेट का उद्देश्य फोर्क और विस्तारित करना है। सब कुछ `templates/analytics/` में रहता है:
+
+- **`AGENTS.md`** - एजेंट की शीर्ष-स्तरीय मार्गदर्शिका। दस्तावेज़ दृश्य, actions, और वर्कफ़्लो।
+- **`actions/`** - प्रत्येक एजेंट-कॉल करने योग्य ऑपरेशन। नई क्रिया जोड़ने के लिए एक नई फ़ाइल जोड़ें। उल्लेखनीय:
+  - `update-dashboard.ts` — डैशबोर्ड संपादन (ऑप्स + पूर्ण-प्रतिस्थापन)
+  - `save-analysis.ts` / `list-analyses.ts` — तदर्थ विश्लेषण
+  - `save-data-dictionary-entry.ts` / `list-data-dictionary.ts` — शब्दकोश
+  - `bigquery.ts` - कच्चा BigQuery निष्पादन
+  - `view-screen.ts` / `navigate.ts` — संदर्भ जागरूकता
+- **`app/routes/`** — फ़ाइल-आधारित मार्ग। प्रत्येक मार्ग `app/pages/` में एक पृष्ठ के चारों ओर एक पतला आवरण है।
+- **`app/pages/adhoc/sql-dashboard/`** - SQL डैशबोर्ड रेंडरर, पैनल संपादक, फ़िल्टर बार, सहेजे गए दृश्य।
+- **`app/pages/analyses/`** - सूची और विवरण दृश्य का विश्लेषण करता है।
+- **`app/pages/DataSources.tsx`** — डेटा-स्रोत ऑनबोर्डिंग UI।
+- **`app/pages/DataDictionary.tsx`** — शब्दकोश ब्राउज़र और संपादक।
+- **`.agents/skills/`** - पैटर्न गाइड एजेंट मांग पर पढ़ता है:
+  - `dashboard-management` - भंडारण, स्कोप रिज़ॉल्यूशन, डैशबोर्ड कॉन्फ़िगरेशन आकार
+  - `data-querying` - किस स्क्रिप्ट तक पहुंचना है, फ़िल्टरिंग पैटर्न
+  - `adhoc-analysis` - क्रॉस-सोर्स जांच के लिए वर्कफ़्लो
+  - `data-querying`, `real-time-sync`, `frontend-design`, `storing-data`, `self-modifying-code`
+- **`.builder/skills/<provider>/SKILL.md`** - प्रदाता-विशिष्ट गोचास (बिगक्वेरी, HubSpot, जीरा, GA4, आदि)। पूछताछ करने से पहले पढ़ें; जब आप कुछ नया सीखें तो अपडेट करें।
+- **`server/db/schema.ts`** - डैशबोर्ड, शेयर, व्यू, विश्लेषण, BigQuery कैश के लिए Drizzle स्कीमा।
+- **`server/lib/dashboards-store.ts`** - डैशबोर्ड स्कोप रेजोल्यूशन और लीगेसी केवी माइग्रेशन के साथ पढ़ता/लिखता है।
+- **`server/lib/bigquery.ts`** - BigQuery क्लाइंट, ड्राई-रन वैलिडेटर, कैश लॉजिक।
+
+नया डेटा स्रोत जोड़ने के लिए, `actions/` में एक स्क्रिप्ट छोड़ें जो प्रदाता को कॉल करती है और `output()` सहायक के माध्यम से परिणाम लौटाती है। यह एजेंट के लिए तुरंत उपलब्ध हो जाता है और इसका उपयोग डैशबोर्ड पैनल के अंदर किया जा सकता है (यदि आप सर्वर हैंडलर के माध्यम से परिणाम प्रदर्शित करते हैं)।
+
+नया चार्ट प्रकार जोड़ने के लिए, `app/pages/adhoc/sql-dashboard/types.ts` में `ChartType` यूनियन का विस्तार करें, इसे `SqlChartCard.tsx` में संभालें, और एजेंट इसे किसी भी पैनल में उपयोग कर सकता है।
+
+विस्तारित टेम्पलेट्स पर व्यापक पैटर्न के लिए, [Skills guide](/docs/skills-guide) और [Actions](/docs/actions) देखें।