contiai / docs /deploy.html
aliroya's picture
Group on the column, not on an expression holding a literal (part 3)
ed75fab verified
Raw History Blame Contribute Delete
51.9 kB
<!doctype html> <html lang="ar" dir="rtl"> <head> <meta charset="utf-8" /> <title>ู†ุดุฑ ContiAI โ€” ุงู„ุฏู„ูŠู„ ุงู„ูƒุงู…ู„</title> <meta name="viewport" content="width=device-width, initial-scale=1" /> <style> /* ContiAI's own tokens. Ultramarine and gold, blue-tinted neutrals, the brand's radius ladder. Nothing invented that the product does not use. */ :root { --brand-50: #eef1fe; --brand-100: #dfe4fd; --brand-200: #c4cdfb; --brand-600: #3538d9; --brand-700: #2b29bc; --brand-950: #16164a; --gold-50: #fef8ec; --gold-200: #f9da8e; --gold-600: #c2680d; --gold-800: #843a13; --ink-0: #ffffff; --ink-50: #f7f8fc; --ink-100: #eff1f7; --ink-200: #e1e5ee; --ink-300: #cbd1e0; --ink-400: #9ba3ba; --ink-500: #6f7893; --ink-600: #525b75; --ink-800: #2c3244; --ink-900: #1c2130; --ink-950: #11141e; --page: var(--ink-50); --surface: var(--ink-0); --surface-2: var(--ink-100); --line: var(--ink-200); --line-soft: var(--ink-100); --text: var(--ink-900); --text-body: var(--ink-800); --muted: var(--ink-500); --accent: var(--brand-700); --accent-sm: var(--brand-50); --accent-ln: var(--brand-200); --warn: var(--gold-800); --warn-bg: var(--gold-50); --warn-ln: var(--gold-200); --code-bg: var(--ink-950); --code-fg: #e6e9f5; --code-dim: #8d94ad; --r-sm: 9px; --r-md: 11px; --r-lg: 14px; --r-xl: 20px; --sans: "Segoe UI", "Noto Kufi Arabic", "Dubai", Tahoma, system-ui, sans-serif; --mono: "Cascadia Mono", Consolas, ui-monospace, monospace; color-scheme: light dark; } /* Flat, not nested: the un-stamped document is what most readers see, and it must resolve without relying on CSS nesting support. */ @media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) { --page: #0c0e17; --surface: var(--ink-950); --surface-2: #171b28; --line: #262b3b; --line-soft: #1d2230; --text: #eef0f7; --text-body: #d3d8e6; --muted: var(--ink-400); --accent: #9dacf7; --accent-sm: #171a3a; --accent-ln: #2f3563; --warn: #f5c053; --warn-bg: #2a1f0e; --warn-ln: #4d3a15; --code-bg: #05070d; --code-fg: #e6e9f5; --code-dim: #7b829b; } } :root[data-theme="dark"] { --page: #0c0e17; --surface: var(--ink-950); --surface-2: #171b28; --line: #262b3b; --line-soft: #1d2230; --text: #eef0f7; --text-body: #d3d8e6; --muted: var(--ink-400); --accent: #9dacf7; --accent-sm: #171a3a; --accent-ln: #2f3563; --warn: #f5c053; --warn-bg: #2a1f0e; --warn-ln: #4d3a15; --code-bg: #05070d; --code-fg: #e6e9f5; --code-dim: #7b829b; } *, *::before, *::after { box-sizing: border-box; } body { margin: 0; background: var(--page); color: var(--text-body); font-family: var(--sans); font-size: 16px; line-height: 1.75; direction: rtl; text-align: right; -webkit-font-smoothing: antialiased; } .wrap { max-width: 1180px; margin-inline: auto; padding: 0 20px 96px; display: grid; grid-template-columns: 244px minmax(0, 1fr); gap: 48px; align-items: start; } @media (max-width: 900px) { .wrap { grid-template-columns: 1fr; gap: 0; } } /* โ”€โ”€ masthead โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ */ header.top { grid-column: 1 / -1; padding: 56px 0 36px; border-bottom: 1px solid var(--line); margin-bottom: 40px; } .eyebrow { font-size: 12px; font-weight: 700; letter-spacing: .14em; text-transform: uppercase; color: var(--accent); margin: 0 0 10px; } h1 { font-size: clamp(30px, 4.4vw, 44px); font-weight: 800; line-height: 1.18; letter-spacing: -.02em; color: var(--text); margin: 0 0 14px; text-wrap: balance; } .lede { font-size: 17px; color: var(--muted); margin: 0; max-width: 62ch; } .stack { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 24px; } .chip { font-size: 12.5px; font-weight: 600; padding: 5px 11px; border: 1px solid var(--line); border-radius: 999px; background: var(--surface); color: var(--muted); } .chip b { color: var(--text); font-weight: 700; } /* โ”€โ”€ contents โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ */ nav.toc { position: sticky; top: 24px; } @media (max-width: 900px) { nav.toc { position: static; margin-bottom: 40px; padding: 18px 20px; background: var(--surface); border: 1px solid var(--line); border-radius: var(--r-lg); } } nav.toc h2 { font-size: 11.5px; font-weight: 700; letter-spacing: .13em; text-transform: uppercase; color: var(--muted); margin: 0 0 12px; } nav.toc ol { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 1px; } nav.toc a { display: flex; gap: 10px; align-items: baseline; padding: 7px 10px; border-radius: var(--r-sm); color: var(--text-body); text-decoration: none; font-size: 14.5px; transition: background .12s, color .12s; } nav.toc a:hover { background: var(--accent-sm); color: var(--accent); } nav.toc a .n { font-family: var(--mono); font-size: 11.5px; color: var(--muted); font-variant-numeric: tabular-nums; min-width: 14px; } nav.toc a:hover .n { color: var(--accent); } /* โ”€โ”€ phases โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ */ main { min-width: 0; display: flex; flex-direction: column; gap: 56px; } section.phase { scroll-margin-top: 24px; } .phase-head { display: flex; gap: 14px; align-items: baseline; margin-bottom: 6px; } .phase-num { font-family: var(--mono); font-size: 13px; font-weight: 700; color: var(--accent); background: var(--accent-sm); border: 1px solid var(--accent-ln); border-radius: var(--r-sm); padding: 2px 9px; font-variant-numeric: tabular-nums; flex: none; } h2.phase-title { font-size: clamp(21px, 2.6vw, 26px); font-weight: 800; letter-spacing: -.015em; color: var(--text); margin: 0; text-wrap: balance; } .phase-note { color: var(--muted); font-size: 15px; margin: 0 0 22px; max-width: 66ch; } h3 { font-size: 17px; font-weight: 700; color: var(--text); margin: 32px 0 10px; text-wrap: balance; } h3:first-of-type { margin-top: 20px; } p { margin: 0 0 14px; max-width: 68ch; } ol.steps { margin: 0 0 8px; padding-inline-start: 22px; display: flex; flex-direction: column; gap: 10px; } ol.steps > li { max-width: 66ch; padding-inline-start: 4px; } ul.plain { margin: 0 0 14px; padding-inline-start: 22px; display: flex; flex-direction: column; gap: 7px; } ul.plain > li { max-width: 66ch; } code:not(pre code) { font-family: var(--mono); font-size: .875em; background: var(--surface-2); border: 1px solid var(--line-soft); border-radius: 6px; padding: 1px 6px; color: var(--text); direction: ltr; display: inline-block; unicode-bidi: bidi-override; } /* โ”€โ”€ command blocks โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ */ .cmd { position: relative; margin: 14px 0 18px; background: var(--code-bg); border-radius: var(--r-md); border: 1px solid transparent; overflow: hidden; } .cmd-bar { display: flex; justify-content: space-between; align-items: center; padding: 8px 14px; border-bottom: 1px solid #ffffff14; } .cmd-label { font-family: var(--mono); font-size: 11.5px; color: var(--code-dim); letter-spacing: .06em; direction: ltr; } .cmd pre { margin: 0; padding: 14px 16px; overflow-x: auto; direction: ltr; text-align: left; } .cmd code { font-family: var(--mono); font-size: 13.5px; line-height: 1.75; color: var(--code-fg); white-space: pre; } .cmd .c { color: var(--code-dim); } button.copy { font: inherit; font-size: 11.5px; font-weight: 600; font-family: var(--sans); background: #ffffff14; color: #cfd4e6; border: 1px solid #ffffff1f; border-radius: 7px; padding: 3px 11px; cursor: pointer; transition: background .12s; } button.copy:hover { background: #ffffff24; } button.copy:focus-visible { outline: 2px solid var(--brand-200); outline-offset: 2px; } button.copy[data-done="1"] { background: #1d6b4a; border-color: #2b8f66; color: #d9f5e7; } /* โ”€โ”€ tables โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ */ .tw { overflow-x: auto; margin: 16px 0 20px; border: 1px solid var(--line); border-radius: var(--r-lg); } table { border-collapse: collapse; width: 100%; font-size: 14.5px; } th, td { padding: 10px 14px; text-align: right; border-bottom: 1px solid var(--line-soft); vertical-align: top; } thead th { background: var(--surface-2); color: var(--text); font-size: 12.5px; font-weight: 700; letter-spacing: .04em; white-space: nowrap; } tbody tr:last-child td { border-bottom: 0; } td:first-child { white-space: nowrap; } td code { white-space: nowrap; } table { background: var(--surface); } /* โ”€โ”€ callouts โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ */ .note, .warn { border-radius: var(--r-md); padding: 14px 18px; margin: 18px 0; font-size: 15px; max-width: 70ch; } .note { background: var(--accent-sm); border: 1px solid var(--accent-ln); } .warn { background: var(--warn-bg); border: 1px solid var(--warn-ln); color: var(--warn); } .note b, .warn b { display: block; margin-bottom: 4px; color: inherit; } .note { color: var(--text-body); } .note b { color: var(--accent); } .note p:last-child, .warn p:last-child { margin-bottom: 0; } /* โ”€โ”€ checklist โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ */ .check { display: flex; flex-direction: column; gap: 0; border: 1px solid var(--line); border-radius: var(--r-lg); background: var(--surface); overflow: hidden; } .check label { display: flex; gap: 12px; align-items: flex-start; cursor: pointer; padding: 12px 16px; border-bottom: 1px solid var(--line-soft); font-size: 15px; transition: background .12s; } .check label:last-child { border-bottom: 0; } .check label:hover { background: var(--surface-2); } .check input { margin: 6px 0 0; accent-color: var(--brand-600); flex: none; width: 15px; height: 15px; } .check input:checked + span { color: var(--muted); text-decoration: line-through; } .check span { color: var(--text-body); } footer { grid-column: 1 / -1; margin-top: 72px; padding-top: 24px; border-top: 1px solid var(--line); color: var(--muted); font-size: 14px; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; animation: none !important; } } </style> </head> <body> <div class="wrap"> <header class="top"> <p class="eyebrow">ContiAI ยท ุฏู„ูŠู„ ุงู„ู†ุดุฑ</p> <h1>ู…ู† ุงู„ุฌู‡ุงุฒ ุฅู„ู‰ ุงู„ุฅู†ุชุฑู†ุช โ€” ุฎุทูˆุฉ ุจุฎุทูˆุฉ</h1> <p class="lede"> ูƒู„ ู…ุง ูŠู„ุฒู… ู„ุชุดุบูŠู„ ุงู„ู…ู†ุตุฉ ุนู„ู‰ ู†ุทุงู‚ูƒ ุงู„ุฎุงุต: ู‚ุงุนุฏุฉ ุงู„ุจูŠุงู†ุงุช ูˆุงู„ู‡ูˆูŠุฉุŒ ุซู… ุงู„ุฎุงุฏู… ูˆุงู„ุนุงู…ู„ ุงู„ุฎู„ููŠุŒ ุซู… ุงู„ูˆุงุฌู‡ุฉุŒ ุซู… ุฑุจุท ุงู„ุฏูˆู…ูŠู†. ุงุชุจุน ุงู„ู…ุฑุงุญู„ ุจุงู„ุชุฑุชูŠุจ โ€” ูƒู„ ู…ุฑุญู„ุฉ ุชุญุชุงุฌ ู…ุฎุฑุฌุงุช ุงู„ุชูŠ ู‚ุจู„ู‡ุง. </p> <div class="stack"> <span class="chip"><b>GitHub</b> ุงู„ู…ุณุชูˆุฏุน</span> <span class="chip"><b>Supabase</b> ุงู„ู‡ูˆูŠุฉ ูˆู‚ุงุนุฏุฉ ุงู„ุจูŠุงู†ุงุช</span> <span class="chip"><b>Qdrant</b> ูู‡ุฑุณ ุงู„ู…ุชุฌู‡ุงุช</span> <span class="chip"><b>Render</b> ุงู„ู€ API ูˆุงู„ุนุงู…ู„ ูˆุงู„ุทุงุจูˆุฑ</span> <span class="chip"><b>Vercel</b> ุงู„ูˆุงุฌู‡ุฉ</span> <span class="chip"><b>Namecheap</b> ุงู„ุฏูˆู…ูŠู†</span> </div> </header> <nav class="toc" aria-label="ู…ุญุชูˆูŠุงุช"> <h2>ุงู„ู…ุฑุงุญู„</h2> <ol> <li><a href="#p0"><span class="n">ู </span><span>ู‚ุจู„ ุฃู† ุชุจุฏุฃ</span></a></li> <li><a href="#p1"><span class="n">ูก</span><span>GitHub</span></a></li> <li><a href="#p2"><span class="n">ูข</span><span>Supabase</span></a></li> <li><a href="#p3"><span class="n">ูฃ</span><span>Qdrant</span></a></li> <li><a href="#p4"><span class="n">ูค</span><span>Render โ€” ุงู„ุฎุงุฏู…</span></a></li> <li><a href="#p5"><span class="n">ูฅ</span><span>Vercel โ€” ุงู„ูˆุงุฌู‡ุฉ</span></a></li> <li><a href="#p6"><span class="n">ูฆ</span><span>ุฑุจุท ุงู„ุทุฑููŠู†</span></a></li> <li><a href="#p7"><span class="n">ูง</span><span>ุงู„ุฏูˆู…ูŠู†</span></a></li> <li><a href="#p8"><span class="n">ูจ</span><span>ุงู„ุชุญู‚ู‚ ุงู„ู†ู‡ุงุฆูŠ</span></a></li> <li><a href="#p9"><span class="n">ูฉ</span><span>ุฅุฐุง ุชุนุทู‘ู„ ุดูŠุก</span></a></li> <li><a href="#p10"><span class="n">ูกู </span><span>ุงู„ุชูƒู„ูุฉ ูˆุงู„ุชุดุบูŠู„</span></a></li> </ol> </nav> <main> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 0 --> <section class="phase" id="p0"> <div class="phase-head"> <span class="phase-num">ู ู </span> <h2 class="phase-title">ู‚ุจู„ ุฃู† ุชุจุฏุฃ</h2> </div> <p class="phase-note"> ุฎู…ุณุฉ ุญุณุงุจุงุช ูˆุจุทุงู‚ุฉ ูˆุงุญุฏุฉ. ู„ุง ุชุจุฏุฃ ู‚ุจู„ ุฃู† ุชูƒูˆู† ูƒู„ู‡ุง ุฌุงู‡ุฒุฉุŒ ู„ุฃู† ูƒู„ ู…ุฑุญู„ุฉ ุชูู†ุชุฌ ู‚ูŠู…ุฉ ุชุญุชุงุฌู‡ุง ุงู„ู…ุฑุญู„ุฉ ุงู„ุชุงู„ูŠุฉ. </p> <h3>ุงู„ุญุณุงุจุงุช</h3> <ul class="plain"> <li><b>GitHub</b> โ€” ู…ุฌุงู†ูŠ. ุงู„ู…ุณุชูˆุฏุน ุงู„ุฐูŠ ูŠู‚ุฑุฃ ู…ู†ู‡ Render ูˆ Vercel.</li> <li><b>Supabase</b> โ€” ุงู„ุฎุทุฉ ุงู„ู…ุฌุงู†ูŠุฉ ุชูƒููŠ ู„ู„ุจุฏุงูŠุฉ.</li> <li><b>Qdrant Cloud</b> โ€” ุนู†ู‚ูˆุฏ ู…ุฌุงู†ูŠ ุจุณุนุฉ ูก ุฌูŠุฌุงุจุงูŠุช.</li> <li><b>Render</b> โ€” ูŠุญุชุงุฌ ุจุทุงู‚ุฉ. ุงู„ุฎุงุฏู… ูˆุงู„ุนุงู…ู„ ุนู„ู‰ ุฎุทุฉ Starter ุจู€ ูง ุฏูˆู„ุงุฑุงุช ู„ูƒู„ ู…ู†ู‡ู…ุง.</li> <li><b>Vercel</b> โ€” ุฎุทุฉ Hobby ู…ุฌุงู†ูŠุฉ.</li> </ul> <h3>ู…ูุงุชูŠุญ ู…ุฒูˆู‘ุฏูŠ ุงู„ู†ู…ุงุฐุฌ</h3> <ul class="plain"> <li><b>OpenRouter</b> โ€” ู…ูุชุงุญ ูˆุงุญุฏุŒ ูˆุงุฑูุน ุญุฏู‘ู‡ ุฅู„ู‰ ูขูฅ ุฏูˆู„ุงุฑู‹ุง ุนู„ู‰ ุงู„ุฃู‚ู„.</li> <li><b>Serper</b> โ€” ู…ูุชุงุญ ุฃูˆ ุฃูƒุซุฑ ู„ู„ุจุญุซ. ุงู„ู†ุธุงู… ูŠุชู†ู‚ู‘ู„ ุจูŠู†ู‡ุง ุนู†ุฏ ุจู„ูˆุบ ุงู„ุญุฏ.</li> <li><b>Mistral</b> โ€” ู„ุงุณุชุฎุฑุงุฌ ุงู„ู†ุตูˆุต ู…ู† ู…ู„ูุงุช PDF.</li> </ul> <div class="warn"> <b>ุงู„ู…ูุงุชูŠุญ ู„ุง ุชููƒุชุจ ููŠ ุฃูŠ ู…ู„ู ูŠูุฑูุน</b> <p> ู…ูƒุงู†ู‡ุง ุงู„ูˆุญูŠุฏ ู‡ูˆ ู…ุชุบูŠู‘ุฑุงุช ุงู„ุจูŠุฆุฉ ุฏุงุฎู„ Render ูˆ Vercel. ุงู„ู…ุณุชูˆุฏุน ููŠู‡ <code>.gitignore</code> ูŠู…ู†ุน ุฐู„ูƒุŒ ูˆูุญุต ููŠ CI ูŠุฑูุถ ุงู„ุฏูุนุฉ ุฅู† ุชุณู„ู‘ู„ ู…ูุชุงุญ. ูˆุฅู† ุณูุฑู‘ุจ ู…ูุชุงุญ ูŠูˆู…ู‹ุง ูุงู„ุฎุทูˆุฉ ุงู„ุฃูˆู„ู‰ ุฅุจุทุงู„ู‡ ู…ู† ู„ูˆุญุฉ ุงู„ู…ุฒูˆู‘ุฏุŒ ู„ุง ุญุฐูู‡ ู…ู† ุงู„ู…ู„ู. </p> </div> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 1 --> <section class="phase" id="p1"> <div class="phase-head"> <span class="phase-num">ู ูก</span> <h2 class="phase-title">GitHub โ€” ุฑูุน ุงู„ู…ุณุชูˆุฏุน</h2> </div> <p class="phase-note"> ุฌุฐุฑ ุงู„ู…ุณุชูˆุฏุน ู‡ูˆ ู…ุฌู„ุฏ <code>platform</code> ู†ูุณู‡ุŒ ู„ุง ุงู„ู…ุฌู„ุฏ ุงู„ุฐูŠ ูŠุญูˆูŠู‡. Render ูŠู‚ุฑุฃ <code>render.yaml</code> ู…ู† ุงู„ุฌุฐุฑุŒ ูˆ Vercel ูŠุญุชุงุฌ <code>apps/web</code> ูƒู…ุฌู„ุฏ ุฌุฐุฑ ู„ู„ู…ุดุฑูˆุน. </p> <h3>ุฃู†ุดุฆ ุงู„ู…ุณุชูˆุฏุน</h3> <ol class="steps"> <li>ุงูุชุญ <code>github.com/new</code>.</li> <li>ุงู„ุงุณู… <code>contiai</code>ุŒ ูˆุงุฌุนู„ู‡ <b>Private</b>.</li> <li>ู„ุง ุชุถู README ูˆู„ุง .gitignore โ€” ู…ูˆุฌูˆุฏุงู† ุจุงู„ูุนู„.</li> </ol> <h3>ุงุฑูุน ุงู„ู…ู„ูุงุช</h3> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">terminal</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>cd C:\conti_ai\platform git init git branch -M main git add -A git commit -m "ContiAI platform" <span class="c"># ุงุณุชุจุฏู„ ALIEMAD ุจุงุณู… ุญุณุงุจูƒ</span> git remote add origin https://github.com/ALIEMAD/contiai.git git push -u origin main</code></pre> </div> <h3>ุงูุญุต ู‚ุจู„ ุฃู† ุชุฏูุน</h3> <p> ุฃู…ุฑ ูˆุงุญุฏ ูŠุดุบู‘ู„ ูƒู„ ู…ุง ุณูŠูุญุตู‡ CI: ุจุญุซ ุนู† ุงู„ู…ูุงุชูŠุญุŒ ูˆุญุฌู… ุงู„ุดุฌุฑุฉุŒ ูˆูˆุฌูˆุฏ ู…ู„ูุงุช ุงู„ู†ุดุฑุŒ ุซู… <code>ruff</code> ูˆ<code>pytest</code> ูˆุจู†ุงุก ุงู„ูˆุงุฌู‡ุฉ. </p> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">terminal</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>cd C:\conti_ai\platform apps\api\.venv\Scripts\python.exe scripts\preflight.py</code></pre> </div> <p> ูŠู†ุชู‡ูŠ ุจู€ <code>ready to push</code> ุฃูˆ ุจู‚ุงุฆู…ุฉ ู…ุง ูŠู†ู‚ุต. ุงู„ุนุฏุฏ ุงู„ู…ุชูˆู‚ุน ุญูˆุงู„ูŠ ูคูฅู  ู…ู„ูู‹ุง ุจุญุฌู… ูฅ ู…ูŠุฌุงุจุงูŠุช โ€” ู„ูˆ ุธู‡ุฑ ุฑู‚ู… ุจุงู„ุขู„ุงู ูุงู„ุฃุฑุฌุญ ุฃู† <code>node_modules</code> ุฃูˆ <code>.venv</code> ุชุณู„ู‘ู„ุŒ ูุฑุงุฌุน <code>.gitignore</code> ู‚ุจู„ ุฃู† ุชูƒู…ู„. </p> <p> ุดุบู‘ู„ู‡ ู‚ุจู„ ูƒู„ ุฏูุนุฉ ู„ุงุญู‚ุฉ ุฃูŠุถู‹ุง. CI ูŠูุญุต ู†ูุณ ุงู„ุฃุดูŠุงุกุŒ ู„ูƒู†ู‡ ูŠูุญุตู‡ุง <em>ุจุนุฏ</em> ุงู„ุฏูุน โ€” ูˆุนู„ู‰ ู‡ุฐุง ุงู„ู…ุณุชูˆุฏุน ุงู„ุฏูุนุฉ ู†ุดุฑูŒ ุฅู„ู‰ ู…ุฒูˆู‘ุฏูŽูŠู†. </p> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 2 --> <section class="phase" id="p2"> <div class="phase-head"> <span class="phase-num">ู ูข</span> <h2 class="phase-title">Supabase โ€” ุงู„ู‡ูˆูŠุฉ ูˆู‚ุงุนุฏุฉ ุงู„ุจูŠุงู†ุงุช</h2> </div> <p class="phase-note"> Supabase ูŠุคุฏูŠ ุฏูˆุฑูŠู†: ู‚ุงุนุฏุฉ ุจูŠุงู†ุงุช Postgres ูŠูƒุชุจ ููŠู‡ุง ุงู„ู†ุธุงู… ูƒู„ ู…ุดุฑูˆุน ูˆุชุดุบูŠู„ุฉ ูˆุฎุทูˆุฉุŒ ูˆู…ุฒูˆู‘ุฏ ู‡ูˆูŠุฉ ูŠุตุฏุฑ ุฑู…ูˆุฒ ุงู„ุฏุฎูˆู„ ุงู„ุชูŠ ูŠุชุญู‚ู‚ ู…ู†ู‡ุง ุงู„ุฎุงุฏู…. </p> <h3>ุฃู†ุดุฆ ุงู„ู…ุดุฑูˆุน</h3> <ol class="steps"> <li>ู…ู† <code>supabase.com/dashboard</code> ุงุถุบุท <b>New project</b>.</li> <li>ุงู„ุงุณู… <code>contiai</code>ุŒ ูˆุงู„ู…ู†ุทู‚ุฉ <b>Frankfurt (eu-central-1)</b> โ€” ู†ูุณ ู…ู†ุทู‚ุฉ RenderุŒ ููƒู„ ู…ู„ู„ูŠ ุซุงู†ูŠุฉ ุจูŠู† ุงู„ุงุซู†ูŠู† ุชุชูƒุฑุฑ ููŠ ูƒู„ ุงุณุชุนู„ุงู….</li> <li>ูˆู„ู‘ุฏ ูƒู„ู…ุฉ ู…ุฑูˆุฑ ู‚ุงุนุฏุฉ ุงู„ุจูŠุงู†ุงุช ูˆ<b>ุงุญูุธู‡ุง ุงู„ุขู†</b>. ู„ู† ุชูุนุฑุถ ู…ุฑุฉ ุฃุฎุฑู‰ุŒ ูˆุณุชุญุชุงุฌู‡ุง ุจุนุฏ ุฏู‚ุงุฆู‚.</li> </ol> <h3>ุงุฌู…ุน ุงู„ู‚ูŠู… ุงู„ุฃุฑุจุน</h3> <div class="tw"> <table> <thead><tr><th>ุงู„ู‚ูŠู…ุฉ</th><th>ู…ู† ุฃูŠู†</th><th>ุชูุณุชุฎุฏู… ููŠ</th></tr></thead> <tbody> <tr><td><code>SUPABASE_URL</code></td> <td>Settings โ† Data API โ† Project URL</td> <td>Render ูˆ Vercel</td></tr> <tr><td><code>SUPABASE_ANON_KEY</code></td> <td>Settings โ† API Keys โ† anon / publishable</td> <td>Render ูˆ Vercel</td></tr> <tr><td><code>SUPABASE_SERVICE_ROLE_KEY</code></td> <td>Settings โ† API Keys โ† service_role</td> <td><b>Render ูˆุญุฏู‡</b></td></tr> <tr><td><code>SUPABASE_JWT_SECRET</code></td> <td>Settings โ† API Keys โ† JWT Keys โ† Legacy secret</td> <td>Render ูˆุญุฏู‡</td></tr> </tbody> </table> </div> <div class="warn"> <b>ู…ูุชุงุญุงู† ู…ุฎุชู„ูุงู† ุชู…ุงู…ู‹ุง</b> <p> ู…ูุชุงุญ <code>anon</code> ุนุงู… ูˆูŠูุฏูู† ุฏุงุฎู„ ุฌุงูุงุณูƒุฑุจุช ุงู„ูˆุงุฌู‡ุฉ โ€” ู‡ุฐุง ุทุจูŠุนูŠ. ูˆู…ูุชุงุญ <code>service_role</code> ูŠุชุฌุงูˆุฒ ูƒู„ ุณูŠุงุณุงุช ุงู„ุญู…ุงูŠุฉุ› ู„ูˆ ูˆุตู„ ุฅู„ู‰ ุงู„ูˆุงุฌู‡ุฉ ูู‚ุฏ ูุชุญุช ู‚ุงุนุฏุฉ ุจูŠุงู†ุงุชูƒ ู„ู„ุฌู…ูŠุน. ู„ุง ุชุถุนู‡ ููŠ ุฃูŠ ู…ุชุบูŠู‘ุฑ ูŠุจุฏุฃ ุจู€ <code>VITE_</code> ุฃุจุฏู‹ุง. </p> </div> <div class="note"> <b>ู…ู„ุงุญุธุฉ ุนู„ู‰ ุตูŠุบุฉ ุงู„ู…ูุงุชูŠุญ</b> <p> ู‡ุฐุง ุงู„ู…ุดุฑูˆุน ู…ุง ุฒุงู„ ูŠุณุชุนู…ู„ ู…ูุงุชูŠุญ JWT ุงู„ู‚ุฏูŠู…ุฉ. ุงู„ุตูŠุบุฉ ุงู„ุฌุฏูŠุฏุฉ <code>sb_secret_โ€ฆ</code> ูŠุฑูุถู‡ุง ุงู„ู€ Data API ุจุฑุณุงู„ุฉ <code>UNAUTHORIZED_INVALID_API_KEY_TYPE</code>ุŒ ูุงู„ู…ุทู„ูˆุจ ู‡ูˆ ู…ูุชุงุญ <code>service_role</code> ุจุตูŠุบุฉ JWT ุงู„ุทูˆูŠู„ุฉ ุงู„ุชูŠ ุชุจุฏุฃ ุจู€ <code>eyJ</code>. </p> </div> <h3>ุฑุงุจุท ู‚ุงุนุฏุฉ ุงู„ุจูŠุงู†ุงุช</h3> <p> ู…ู† <b>Connect</b> ููŠ ุฃุนู„ู‰ ุงู„ู„ูˆุญุฉุŒ ุงุฎุชุฑ <b>Connection pooling</b> ุซู… <b>Transaction</b>. ุงู„ุฑุงุจุท ูŠุดุจู‡: </p> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">ู…ู† Supabase</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>postgresql://postgres.abcdefghijkl:PASSWORD@aws-0-eu-central-1.pooler.supabase.com:6543/postgres</code></pre> </div> <p>ุญูˆู‘ู„ู‡ ุฅู„ู‰ ุงู„ุตูŠุบุฉ ุงู„ุชูŠ ูŠู‚ุจู„ู‡ุง ุงู„ุฎุงุฏู… โ€” ุฃุถู <code>+asyncpg</code> ูˆุงุญุฐู ุฃูŠ <code>?pgbouncer=true</code>:</p> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">DATABASE_URL ู„ู€ Render</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>postgresql+asyncpg://postgres.abcdefghijkl:PASSWORD@aws-0-eu-central-1.pooler.supabase.com:6543/postgres</code></pre> </div> <div class="warn"> <b>ุงู„ู…ู†ูุฐ ูฆูฅูคูฃ ู„ุง ูฅูคูฃูข</b> <p> ุงู„ุงุชุตุงู„ ุงู„ู…ุจุงุดุฑ ุนู„ู‰ ูฅูคูฃูข ู…ุญุฏูˆุฏ ุงู„ุนุฏุฏุŒ ูˆุฎุงุฏู… ูˆุงุญุฏ ุนู„ู‰ Render ูŠุณุชู†ูุฏู‡ ุซู… ูŠุจุฏุฃ ุจุฑูุถ ุงู„ุทู„ุจุงุช ุจุฑุณุงู„ุฉ <code>too many connections</code>. ุงู„ู…ูุฌู…ูู‘ุน ุนู„ู‰ ูฆูฅูคูฃ ู‡ูˆ ุงู„ู…ู‚ุตูˆุฏ. ูˆุฅู† ูƒุงู†ุช ูƒู„ู…ุฉ ุงู„ู…ุฑูˆุฑ ุชุญูˆูŠ ุฑู…ุฒู‹ุง ู…ุซู„ <code>@</code> ุฃูˆ <code>#</code> ูุฑู…ู‘ุฒู‡ุง ุจุชุฑู…ูŠุฒ ุงู„ู†ุณุจุฉ ุงู„ู…ุฆูˆูŠุฉ. </p> </div> <h3>ุฅุนุฏุงุฏุงุช ุงู„ู…ุตุงุฏู‚ุฉ</h3> <ol class="steps"> <li>Authentication โ† Providers โ† <b>Email</b>: ูุนู‘ู„ู‡. ูˆุฅู† ุฃุฑุฏุช ุชุฌุฑุจุฉ ุณุฑูŠุนุฉ ุจู„ุง ุจุฑูŠุฏ ุชุฃูƒูŠุฏุŒ ุฃุทูุฆ <b>Confirm email</b> ู…ุคู‚ุชู‹ุง.</li> <li>Authentication โ† URL Configuration โ† <b>Site URL</b>: ุถุน ุฑุงุจุท Vercel ุฃูˆ ุฏูˆู…ูŠู†ูƒ ุงู„ู†ู‡ุงุฆูŠ.</li> <li>ููŠ <b>Redirect URLs</b> ุฃุถู ู†ุทุงู‚ูƒ ูˆ <code>http://localhost:5173</code> ู„ู„ุชุทูˆูŠุฑ.</li> <li>ู„ุชูุนูŠู„ ุงู„ุฏุฎูˆู„ ุจุฌูˆุฌู„: Providers โ† GoogleุŒ ูˆุถุน Client ID ูˆ Secret ู…ู† Google Cloud ConsoleุŒ ุซู… ุงู†ุณุฎ ุฑุงุจุท ุงู„ุงุณุชุฏุนุงุก ุงู„ุฐูŠ ูŠุนุฑุถู‡ Supabase ุฅู„ู‰ ุฅุนุฏุงุฏุงุช ุฌูˆุฌู„.</li> </ol> <h3>ู…ู„ูู‘ุง SQL โ€” ุจุนุฏ ุฃูˆู„ ู†ุดุฑ ู†ุงุฌุญ</h3> <p> <code>alembic upgrade head</code> ูŠุนู…ู„ ูˆุญุฏู‡ ุนู†ุฏ ุฅู‚ู„ุงุน ุฎุงุฏู… Render ูˆูŠู†ุดุฆ ุฌุฏุงูˆู„ ุงู„ู…ู†ุตุฉ ูƒู„ู‡ุง. ูŠุจู‚ู‰ ู…ู„ูุงู† ูŠูุดุบูŽู‘ู„ุงู† ุจูŠุฏูƒ ููŠ <b>SQL Editor</b>ุŒ <b>ูˆุจู‡ุฐุง ุงู„ุชุฑุชูŠุจ</b>ุŒ ูˆุจุนุฏ ุฃู† ูŠู†ุฌุญ ุงู„ู†ุดุฑ ุงู„ุฃูˆู„ โ€” ู„ุฃู† ุงู„ุซุงู†ูŠ ูŠุจู†ูŠ ุนู„ู‰ ุฌุฏุงูˆู„ ู„ุง ุชูˆุฌุฏ ู‚ุจู„ู‡: </p> <ol> <li> <code>infra/sql/001_rag_documents.sql</code> โ€” ุงู„ุฌุฏุงูˆู„ ุงู„ุซู„ุงุซุฉ ุงู„ุชูŠ ูŠูƒุชุจ ููŠู‡ุง ูƒูˆุฏ ุงู„ุงุณุชุฑุฌุงุน ุงู„ู…ู†ู‚ูˆู„: <code>documents_raw</code> ูˆ<code>documents_metadata</code> ูˆ<code>chunks</code>. ู‡ุฐู‡ ู„ุง ูŠู†ุดุฆู‡ุง alembic ู„ุฃู† ุฐู„ูƒ ุงู„ูƒูˆุฏ ู„ุง ูŠู…ุฑู‘ ุจู€ SQLAlchemy ุฃุตู„ู‹ุงุ› ูŠูƒู„ู‘ู… Supabase ู…ุจุงุดุฑุฉ. ูƒุงู†ุช ู…ูˆุฌูˆุฏุฉ ููŠ ุงู„ู…ุดุฑูˆุน ุงู„ู‚ุฏูŠู… ู„ุฃู† ุฃุญุฏู‡ู… ุฃู†ุดุฃู‡ุง ุจูŠุฏู‡ุŒ ูˆุนู„ู‰ ู…ุดุฑูˆุน ุฌุฏูŠุฏ <b>ูŠูุดู„ ุฃูˆู„ ุงุณุชูŠุนุงุจ ู„ุฃูˆู„ ูƒุชุงุจ</b> ุจู€ <code>relation "documents_raw" does not exist</code> โ€” ุจุนุฏ ุฃู† ุชูƒูˆู† ู‚ุฏ ุฏูุนุช ุซู…ู† ุงู„ุจุญุซ ูˆุงู„ุชู†ุฒูŠู„. </li> <li> <code>infra/sql/002_rls.sql</code> โ€” ุณูŠุงุณุงุช ุงู„ุญู…ุงูŠุฉ. ุทุจู‚ุฉ ุซุงู†ูŠุฉ: ุงู„ุฎุงุฏู… ูŠู‚ูŠู‘ุฏ ูƒู„ ุงุณุชุนู„ุงู… ุจุงู„ู…ุงู„ูƒ ุฃุตู„ู‹ุงุŒ ูˆู‡ุฐู‡ ุชุฌุนู„ ู‚ุงุนุฏุฉ ุงู„ุจูŠุงู†ุงุช ุชุฑูุถ ุจู†ูุณู‡ุง ู„ูˆ ุฃูู„ุช ุงุณุชุนู„ุงู… ุบูŠุฑ ู…ู‚ูŠูŽู‘ุฏ. </li> <li> <code>infra/sql/003_rls_remainder.sql</code> โ€” ุงู„ุฌุฏุงูˆู„ ุงู„ุชูŠ ูƒูุชุจ ุงู„ู…ู„ู ุงู„ุซุงู†ูŠ ู‚ุจู„ ูˆุฌูˆุฏู‡ุง. ู…ู†ู‡ุง <code>uploads</code> ูˆ<code>profiles</code>ุŒ ูˆู„ูƒู„ูู‘ ู…ู†ู‡ู…ุง ู…ุงู„ูƒ โ€” ุฃูŠ ุฃู†ู‡ู…ุง ูƒุงู†ุง ุจู„ุง ุฃูŠ ุญู…ุงูŠุฉ ุจูŠู†ู…ุง ุงู„ู…ูุชุงุญ ุงู„ู…ู†ุดูˆุฑ ููŠ ู…ุชุตูู‘ุญ ูƒู„ ุฒุงุฆุฑ. </li> </ol> <p> ูƒู„ุงู‡ู…ุง ูŠูุดุบูŽู‘ู„ ู…ุฑุชูŠู† ุจู„ุง ุถุฑุฑ. </p> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 3 --> <section class="phase" id="p3"> <div class="phase-head"> <span class="phase-num">ู ูฃ</span> <h2 class="phase-title">Qdrant โ€” ูู‡ุฑุณ ุงู„ู…ุชุฌู‡ุงุช</h2> </div> <p class="phase-note"> ู‡ู†ุง ุชูุฎุฒูŽู‘ู† ู…ู‚ุงุทุน ุงู„ู…ุตุงุฏุฑ ุจุนุฏ ุชู‚ุทูŠุนู‡ุงุŒ ูˆู…ู†ู‡ุง ูŠุณุชุฑุฌุน ุงู„ูƒุงุชุจ ุงู„ุฃุฏู„ุฉ ุงู„ุชูŠ ูŠุจู†ูŠ ุนู„ูŠู‡ุง ูƒู„ ู…ุญูˆุฑ. </p> <ol class="steps"> <li>ู…ู† <code>cloud.qdrant.io</code> ุฃู†ุดุฆ ุนู†ู‚ูˆุฏู‹ุง ู…ุฌุงู†ูŠู‹ุง ููŠ <b>Frankfurt</b>.</li> <li>ุงู†ุณุฎ ุฑุงุจุท ุงู„ุนู†ู‚ูˆุฏ. <b>ู„ุง ุจุฏ ุฃู† ูŠู†ุชู‡ูŠ ุจุงู„ู…ู†ูุฐ <code>:6333</code></b> โ€” ูˆุงุฌู‡ุฉ REST ุชุณุชู…ุน ู‡ู†ุงูƒุŒ ูˆู…ู† ุฏูˆู†ู‡ ูŠูุดู„ ูƒู„ ุงุณุชุฑุฌุงุน ุจุฎุทุฃ ุงุชุตุงู„ ุบุงู…ุถ.</li> <li>ู…ู† <b>Data Access Control</b> ุฃู†ุดุฆ ู…ูุชุงุญู‹ุง ูˆุงู†ุณุฎู‡ ููˆุฑู‹ุง.</li> </ol> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">ุงู„ู‚ูŠู…ุชุงู†</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>QDRANT_URL=https://xxxxxxxx.eu-central-1-0.aws.cloud.qdrant.io:6333 QDRANT_API_KEY=โ€ฆ</code></pre> </div> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 4 --> <section class="phase" id="p4"> <div class="phase-head"> <span class="phase-num">ู ูค</span> <h2 class="phase-title">Render โ€” ุงู„ุฎุงุฏู… ูˆุงู„ุนุงู…ู„ ูˆุงู„ุทุงุจูˆุฑ</h2> </div> <p class="phase-note"> ุซู„ุงุซ ุฎุฏู…ุงุช ูŠุนุฑู‘ูู‡ุง <code>render.yaml</code> ุฏูุนุฉ ูˆุงุญุฏุฉ: ุงู„ู€ API ุงู„ุฐูŠ ูŠุณุชู‚ุจู„ ุงู„ุทู„ุจุงุชุŒ ูˆุงู„ุนุงู…ู„ ุงู„ุฐูŠ ูŠู†ูู‘ุฐ ุงู„ุชุดุบูŠู„ุงุช ุงู„ุทูˆูŠู„ุฉุŒ ูˆุทุงุจูˆุฑ Redis ุจูŠู†ู‡ู…ุง. </p> <h3>ู„ู…ุงุฐุง ุนุงู…ู„ ู…ู†ูุตู„</h3> <p> ูƒุชุงุจุฉ ูƒุชุงุจ ุชุณุชุบุฑู‚ ุณุงุนุฉ. ู„ุง ูŠูˆุฌุฏ ุทู„ุจ HTTP ูŠุนูŠุด ุณุงุนุฉ. ูุงู„ู€ API ูŠุถุน ุงู„ู…ู‡ู…ุฉ ููŠ ุงู„ุทุงุจูˆุฑ ูˆูŠุฑุฏู‘ ููˆุฑู‹ุงุŒ ูˆุงู„ุนุงู…ู„ ูŠู„ุชู‚ุทู‡ุง ูˆูŠู†ูู‘ุฐู‡ุง ูˆูŠูƒุชุจ ุชู‚ุฏู‘ู…ู‡ ููŠ ู‚ุงุนุฏุฉ ุงู„ุจูŠุงู†ุงุช. ู„ู‡ุฐุง ุฃูŠุถู‹ุง <b>ูŠุฌุจ ุฃู† ูŠูƒูˆู† ุงู„ุนุงู…ู„ ุนู„ู‰ ุฎุทุฉ ู…ุฏููˆุนุฉ</b>: ุงู„ุฎุฏู…ุฉ ุงู„ู…ุฌุงู†ูŠุฉ ุชู†ุงู… ุนู†ุฏ ุงู„ุฎู…ูˆู„ุŒ ูˆุงู„ู†ุงุฆู… ูŠุชุฑูƒ ุงู„ูƒุชุงุจ ููŠ ู…ู†ุชุตูู‡. </p> <h3>ุฃู†ุดุฆ ุงู„ุฎุฏู…ุงุช</h3> <ol class="steps"> <li>ู…ู† ู„ูˆุญุฉ Render: <b>New โ† Blueprint</b>.</li> <li>ุงุฑุจุท ุญุณุงุจ GitHub ูˆุงุฎุชุฑ ู…ุณุชูˆุฏุน <code>contiai</code>.</li> <li>ุณูŠู‚ุฑุฃ <code>render.yaml</code> ูˆูŠุนุฑุถ ุงู„ุฎุฏู…ุงุช ุงู„ุซู„ุงุซ. ุงุถุบุท <b>Apply</b>.</li> <li>ุณูŠุชูˆู‚ู ุนู†ุฏ ุงู„ู…ุชุบูŠู‘ุฑุงุช ุงู„ู…ุนู„ูŽู‘ู…ุฉ <code>sync: false</code> ูˆูŠุทู„ุจู‡ุง ู…ู†ูƒ โ€” ุงู…ู„ุฃู‡ุง ู…ู† ุงู„ุฌุฏูˆู„ ุงู„ุชุงู„ูŠ.</li> </ol> <h3>ู…ุชุบูŠู‘ุฑุงุช ุงู„ุจูŠุฆุฉ</h3> <div class="tw"> <table> <thead><tr><th>ุงู„ู…ุชุบูŠู‘ุฑ</th><th>ุงู„ู‚ูŠู…ุฉ</th></tr></thead> <tbody> <tr><td><code>DATABASE_URL</code></td><td>ุฑุงุจุท ุงู„ู…ูุฌู…ูู‘ุน ู…ู† ุงู„ู…ุฑุญู„ุฉ ูขุŒ ุจุตูŠุบุฉ <code>+asyncpg</code></td></tr> <tr><td><code>CORS_ORIGINS</code></td><td>ุงุชุฑูƒู‡ ู…ุคู‚ุชู‹ุง <code>https://contiai.vercel.app</code> โ€” ุณุชุตุญู‘ุญู‡ ููŠ ุงู„ู…ุฑุญู„ุฉ ูฆ</td></tr> <tr><td><code>SUPABASE_URL</code></td><td>ู…ู† ุงู„ู…ุฑุญู„ุฉ ูข</td></tr> <tr><td><code>SUPABASE_SERVICE_ROLE_KEY</code></td><td>ู…ู† ุงู„ู…ุฑุญู„ุฉ ูข</td></tr> <tr><td><code>SUPABASE_ANON_KEY</code></td><td>ู…ู† ุงู„ู…ุฑุญู„ุฉ ูข</td></tr> <tr><td><code>SUPABASE_JWT_SECRET</code></td><td>ู…ู† ุงู„ู…ุฑุญู„ุฉ ูข</td></tr> <tr><td><code>QDRANT_URL</code></td><td>ู…ู† ุงู„ู…ุฑุญู„ุฉ ูฃ โ€” ุจุงู„ู…ู†ูุฐ ูฆูฃูฃูฃ</td></tr> <tr><td><code>QDRANT_API_KEY</code></td><td>ู…ู† ุงู„ู…ุฑุญู„ุฉ ูฃ</td></tr> <tr><td><code>OPENROUTER_API_KEY</code></td><td>ู…ูุชุงุญูƒ</td></tr> <tr><td><code>MISTRAL_API_KEY</code></td><td>ู…ูุชุงุญูƒ</td></tr> <tr><td><code>SERPER_API_KEYS</code></td><td>ู…ูุชุงุญ ุฃูˆ ุฃูƒุซุฑ ู…ูุตูˆู„ุฉ ุจููˆุงุตู„ โ€” <b>ุชุฃูƒุฏ ู…ู† ุฑุตูŠุฏู‡ุง</b>ุŒ ูุงู„ุจุญุซ ูƒู„ู‡ ูŠุชูˆู‚ู ุจู†ูุงุฏู‡ุง</td></tr> <tr><td><code>BOOTSTRAP_ADMIN_EMAILS</code></td><td><b>ุจุฑูŠุฏูƒ</b> โ€” ุงู‚ุฑุฃ ุงู„ุชุญุฐูŠุฑ ุฃุณูู„ู‡</td></tr> </tbody> </table> </div> <p> ูˆู‡ุฐุงู† ุงุฎุชูŠุงุฑูŠุงู†ุŒ ุงูุชุฑุงุถู‡ู…ุง <code>true</code> ูˆู„ุง ุชุญุชุงุฌ ุถุจุทู‡ู…ุง ุนู†ุฏ ุงู„ู†ุดุฑ ุงู„ุฃูˆู„: <code>BOOK_PLANNING_V2</code> ูˆ<code>BOOK_COHESION_V2</code>. ูˆุฌูˆุฏู‡ู…ุง ู„ุณุจุจ ูˆุงุญุฏ: ูƒุชุงุจ ุจุฏุฃ ุชุดุบูŠู„ู‡ ุนู„ู‰ ู…ุฎุทูู‘ุท ู„ุง ุจุฏ ุฃู† ูŠูู†ู‡ูŠู‡ ุนู„ูŠู‡ุŒ ูุฅู† ุงุญุชุฌุช ุงู„ุนูˆุฏุฉ ุฅู„ู‰ ุงู„ุฌูŠู„ ุงู„ุฃูˆู„ ูุงุถุจุท ุฃุญุฏู‡ู…ุง ุนู„ู‰ <code>false</code> โ€” ูˆู„ุชุดุบูŠู„ุฉ ุฌุงุฑูŠุฉ ูุญุณุจ. </p> <div class="warn"> <b>ุจุฏูˆู† ุจุฑูŠุฏ ุงู„ู…ุณุคูˆู„ ู„ู† ุชุณุชุทูŠุน ุงู„ุฏุฎูˆู„</b> <p> ูƒู„ ุญุณุงุจ ุฌุฏูŠุฏ ูŠูู†ุดุฃ ุจุญุงู„ุฉ ยซู‚ูŠุฏ ุงู„ู…ูˆุงูู‚ุฉยปุŒ ูˆู„ุง ูŠูˆุงูู‚ ุนู„ูŠู‡ ุฅู„ุง ู…ุณุคูˆู„. ูˆููŠ ู†ุธุงู… ุฌุฏูŠุฏ ู„ุง ูŠูˆุฌุฏ ู…ุณุคูˆู„. ุงู„ุนู†ุงูˆูŠู† ุงู„ู…ูƒุชูˆุจุฉ ู‡ู†ุง ุชุตู„ ู…ุนุชู…ูŽุฏุฉ ูˆุจุตู„ุงุญูŠุฉ ู…ุณุคูˆู„ โ€” ูˆู‡ูŠ ุงู„ุทุฑูŠู‚ุฉ ุงู„ูˆุญูŠุฏุฉ ู„ูุชุญ ุงู„ุจุงุจ ุฃูˆู„ ู…ุฑุฉ. </p> </div> <h3>ุชุญู‚ู‘ู‚ ู…ู† ุงู„ู†ุดุฑ</h3> <p> ุฃูˆู„ ุจู†ุงุก ูŠุณุชุบุฑู‚ ู…ู† ูจ ุฅู„ู‰ ูกูฅ ุฏู‚ูŠู‚ุฉ โ€” ุงู„ุญุฒู… ุซู‚ูŠู„ุฉ. ุฑุงู‚ุจ ุณุฌู„ู‘ <code>contiai-api</code> ุญุชู‰ ุชุฌุฏ <code>Uvicorn running</code>ุŒ ุซู…: </p> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">terminal</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>curl https://contiai-api.onrender.com/health <span class="c"># {"status":"ok","env":"production","version":"1.0.0"}</span></code></pre> </div> <p> ูˆุงูุชุญ ุณุฌู„ู‘ <code>contiai-worker</code> ูˆุชุฃูƒุฏ ู…ู† ุธู‡ูˆุฑ <code>arq: Starting worker</code>. ุนุงู…ู„ ุตุงู…ุช ูŠุนู†ูŠ ุฃู† ุงู„ุชุดุบูŠู„ุงุช ุณุชููˆุถุน ููŠ ุงู„ุทุงุจูˆุฑ ูˆู„ุง ูŠู„ุชู‚ุทู‡ุง ุฃุญุฏ. </p> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 5 --> <section class="phase" id="p5"> <div class="phase-head"> <span class="phase-num">ู ูฅ</span> <h2 class="phase-title">Vercel โ€” ุงู„ูˆุงุฌู‡ุฉ</h2> </div> <p class="phase-note"> ุงู„ูˆุงุฌู‡ุฉ ู…ู„ูุงุช ุซุงุจุชุฉ ุชูุจู†ู‰ ู…ุฑุฉ ูˆุชููˆุฒูŽู‘ุน ุนุงู„ู…ูŠู‹ุง. ุงู„ู…ู‡ู… ุฃู† ุชููˆุฌูŽู‘ู‡ ุฅู„ู‰ ุงู„ู…ุฌู„ุฏ ุงู„ุตุญูŠุญ ุฏุงุฎู„ ุงู„ู…ุณุชูˆุฏุน. </p> <ol class="steps"> <li>ู…ู† <code>vercel.com/new</code> ุงุณุชูˆุฑุฏ ู…ุณุชูˆุฏุน <code>contiai</code>.</li> <li><b>Root Directory</b>: ุงุถุบุท Edit ูˆุงุฎุชุฑ <code>apps/web</code>. ู‡ุฐู‡ ุฃูƒุซุฑ ุฎุทูˆุฉ ูŠูุฎุทุฃ ููŠู‡ุง โ€” ุจุฏูˆู†ู‡ุง ูŠุจุญุซ Vercel ุนู† <code>package.json</code> ููŠ ุงู„ุฌุฐุฑ ูˆู„ุง ูŠุฌุฏู‡.</li> <li>Framework ุณูŠููƒุชุดู ุชู„ู‚ุงุฆูŠู‹ุง ูƒู€ <b>Vite</b>ุŒ ูˆุงู„ุจู†ุงุก ูˆุงู„ู…ุฎุฑุฌุงุช ู…ุถุจูˆุทุงู† ููŠ <code>vercel.json</code>.</li> </ol> <h3>ู…ุชุบูŠู‘ุฑุงุช ุงู„ุจูŠุฆุฉ</h3> <div class="tw"> <table> <thead><tr><th>ุงู„ู…ุชุบูŠู‘ุฑ</th><th>ุงู„ู‚ูŠู…ุฉ</th></tr></thead> <tbody> <tr><td><code>VITE_API_URL</code></td><td><code>https://contiai-api.onrender.com</code> โ€” ุจู„ุง ุดุฑุทุฉ ู…ุงุฆู„ุฉ ููŠ ุขุฎุฑู‡</td></tr> <tr><td><code>VITE_SUPABASE_URL</code></td><td>ู…ู† ุงู„ู…ุฑุญู„ุฉ ูข</td></tr> <tr><td><code>VITE_SUPABASE_ANON_KEY</code></td><td>ู…ูุชุงุญ <code>anon</code> ูู‚ุท</td></tr> </tbody> </table> </div> <div class="note"> <b>ุงู„ู…ุชุบูŠู‘ุฑุงุช ุชูุญู‚ู† ูˆู‚ุช ุงู„ุจู†ุงุก</b> <p> Vite ูŠุฏู…ุฌ ู‚ูŠู… <code>VITE_*</code> ุฏุงุฎู„ ุงู„ุฌุงูุงุณูƒุฑุจุช ุงู„ู…ุจู†ูŠ. ุชุบูŠูŠุฑ ุฃูŠูู‘ ู…ู†ู‡ุง ู„ุงุญู‚ู‹ุง ู„ุง ูŠุธู‡ุฑ ุญุชู‰ ุชุนูŠุฏ ุงู„ู†ุดุฑ โ€” ู…ู† Deployments ุงุถุบุท <b>Redeploy</b>. </p> </div> <p>ุงุถุบุท <b>Deploy</b>. ุจุนุฏ ุฏู‚ูŠู‚ุชูŠู† ุณุชุญุตู„ ุนู„ู‰ ุฑุงุจุท ู…ุซู„ <code>contiai.vercel.app</code>.</p> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 6 --> <section class="phase" id="p6"> <div class="phase-head"> <span class="phase-num">ู ูฆ</span> <h2 class="phase-title">ุฑุจุท ุงู„ุทุฑููŠู†</h2> </div> <p class="phase-note"> ุงู„ุขู† ูŠุนุฑู ูƒู„ูŒู‘ ู…ู† ุงู„ุทุฑููŠู† ุนู†ูˆุงู† ุงู„ุขุฎุฑ. ุชุจู‚ู‰ ุฎุทูˆุฉ ูˆุงุญุฏุฉ ูŠุณู‡ู„ ู†ุณูŠุงู†ู‡ุงุŒ ูˆุฃุนุฑุงุถ ู†ุณูŠุงู†ู‡ุง ู…ูุถู„ูู‘ู„ุฉ. </p> <ol class="steps"> <li>ุงู†ุณุฎ ุนู†ูˆุงู† Vercel ุงู„ุญู‚ูŠู‚ูŠ.</li> <li>ููŠ Render โ† <code>contiai-api</code> โ† EnvironmentุŒ ุงุถุจุท <code>CORS_ORIGINS</code> ุนู„ูŠู‡.</li> <li>ุงุญูุธ. Render ุณูŠุนูŠุฏ ุงู„ู†ุดุฑ ุชู„ู‚ุงุฆูŠู‹ุง.</li> </ol> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">CORS_ORIGINS</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>https://contiai.vercel.app,https://contiai.com,https://www.contiai.com</code></pre> </div> <div class="warn"> <b>ุนุฑูŽุถ ู†ุณูŠุงู† ู‡ุฐู‡ ุงู„ุฎุทูˆุฉ</b> <p> ุงู„ู…ูˆู‚ุน ูŠูุชุญุŒ ูˆุดุงุดุฉ ุงู„ุฏุฎูˆู„ ุชุธู‡ุฑุŒ ูˆูƒู„ ุทู„ุจ ูŠูุดู„ ุจุตู…ุช. ููŠ ูˆุญุฏุฉ ุชุญูƒู… ุงู„ู…ุชุตูุญ ุณุชุฌุฏ <code>blocked by CORS policy</code>. ุงู„ุฎุงุฏู… ูŠุนู…ู„ ุชู…ุงู…ู‹ุง โ€” ู‡ูˆ ูู‚ุท ู„ุง ูŠุนุฑู ุฃู† ู‡ุฐุง ุงู„ุฃุตู„ ู…ุณู…ูˆุญ ู„ู‡. </p> </div> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 7 --> <section class="phase" id="p7"> <div class="phase-head"> <span class="phase-num">ู ูง</span> <h2 class="phase-title">ุงู„ุฏูˆู…ูŠู† ู…ู† Namecheap</h2> </div> <p class="phase-note"> ุงู„ูˆุงุฌู‡ุฉ ุนู„ู‰ ุงู„ุฌุฐุฑ ูˆ <code>www</code>ุŒ ูˆุงู„ู€ API ุนู„ู‰ ู†ุทุงู‚ ูุฑุนูŠ <code>api</code>. ุซู„ุงุซุฉ ุณุฌู„ุงุชุŒ ุซู… ุชุตุญูŠุญ ู‚ูŠู…ุชูŠู†. </p> <h3>ุฃูˆู„ู‹ุง: ุณุฌู‘ู„ ุงู„ู†ุทุงู‚ุงุช ุนู†ุฏ ุงู„ู…ุฒูˆู‘ุฏูŠู†</h3> <ol class="steps"> <li>ููŠ Vercel โ† ุงู„ู…ุดุฑูˆุน โ† Settings โ† <b>Domains</b>: ุฃุถู <code>contiai.com</code> ูˆ <code>www.contiai.com</code>.</li> <li>ููŠ Render โ† <code>contiai-api</code> โ† Settings โ† <b>Custom Domains</b>: ุฃุถู <code>api.contiai.com</code>.</li> </ol> <p>ุณูŠุนุฑุถ ูƒู„ูŒู‘ ู…ู†ู‡ู…ุง ุงู„ุณุฌู„ุงุช ุงู„ู…ุทู„ูˆุจุฉ. ุงู„ู‚ูŠู… ุฃุฏู†ุงู‡ ู‡ูŠ ุงู„ู…ุนุชุงุฏุฉุŒ ู„ูƒู† <b>ุงุนุชู…ุฏ ู…ุง ูŠุนุฑุถู‡ ุงู„ู…ุฒูˆู‘ุฏ ู†ูุณู‡</b> ุฅู† ุงุฎุชู„ู.</p> <h3>ุซุงู†ูŠู‹ุง: ููŠ Namecheap</h3> <ol class="steps"> <li>Domain List โ† <b>Manage</b> ุจุฌูˆุงุฑ ู†ุทุงู‚ูƒ.</li> <li>ุชุจูˆูŠุจ <b>Advanced DNS</b>.</li> <li>ุชุฃูƒุฏ ุฃู† <b>Nameservers</b> ููŠ ุงู„ุชุจูˆูŠุจ ุงู„ุฃูˆู„ ู…ุถุจูˆุทุฉ ุนู„ู‰ <b>Namecheap BasicDNS</b> โ€” ูˆุฅู„ุง ูุณุฌู„ุงุชูƒ ู‡ู†ุง ู„ู† ุชูู‚ุฑุฃ ุฃุตู„ู‹ุง.</li> <li>ุงุญุฐู ุณุฌู„ุงุช <code>CNAME</code> ูˆ <code>URL Redirect</code> ุงู„ุงูุชุฑุงุถูŠุฉ ุงู„ุชูŠ ูŠู†ุดุฆู‡ุง Namecheap ู„ู„ู†ุทุงู‚ ุงู„ุฌุฏูŠุฏ.</li> <li>ุฃุถู ุงู„ุซู„ุงุซุฉ ุงู„ุชุงู„ูŠุฉ.</li> </ol> <div class="tw"> <table> <thead><tr><th>Type</th><th>Host</th><th>Value</th><th>TTL</th></tr></thead> <tbody> <tr><td>A Record</td><td><code>@</code></td><td><code>76.76.21.21</code></td><td>Automatic</td></tr> <tr><td>CNAME</td><td><code>www</code></td><td><code>cname.vercel-dns.com</code></td><td>Automatic</td></tr> <tr><td>CNAME</td><td><code>api</code></td><td><code>contiai-api.onrender.com</code></td><td>Automatic</td></tr> </tbody> </table> </div> <div class="note"> <b>ุงู„ุงู†ุชุดุงุฑ</b> <p> ุนุงุฏุฉ ู…ู† ูกู  ุฏู‚ุงุฆู‚ ุฅู„ู‰ ุณุงุนุฉุŒ ูˆู‚ุฏ ูŠู…ุชุฏ ุฅู„ู‰ ูคูจ. ุดู‡ุงุฏุงุช TLS ุชุตุฏุฑ ุชู„ู‚ุงุฆูŠู‹ุง ู…ู† ุงู„ุทุฑููŠู† ุจุนุฏ ุฃู† ูŠุฑูŠุง ุงู„ุณุฌู„. ุชุญู‚ู‘ู‚ ุจู€ <code>nslookup api.contiai.com</code>. </p> </div> <h3>ุซุงู„ุซู‹ุง: ุตุญู‘ุญ ุงู„ู‚ูŠู…ุชูŠู†</h3> <p>ุจุนุฏ ุฃู† ูŠุนู…ู„ ุงู„ู†ุทุงู‚ุŒ ู„ู… ูŠุนุฏ ุฑุงุจุท <code>onrender.com</code> ู‡ูˆ ุงู„ุนู†ูˆุงู† ุงู„ู…ุนู„ู†:</p> <ol class="steps"> <li>Vercel โ† <code>VITE_API_URL</code> โ† <code>https://api.contiai.com</code>ุŒ ุซู… <b>Redeploy</b>.</li> <li>Render โ† <code>CORS_ORIGINS</code> โ† ุฃุถู <code>https://contiai.com</code> ูˆ <code>https://www.contiai.com</code>.</li> <li>Supabase โ† Authentication โ† URL Configuration โ† <b>Site URL</b> ูˆ <b>Redirect URLs</b> โ† ู†ุทุงู‚ูƒ ุงู„ุฌุฏูŠุฏ.</li> </ol> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 8 --> <section class="phase" id="p8"> <div class="phase-head"> <span class="phase-num">ู ูจ</span> <h2 class="phase-title">ุงู„ุชุญู‚ู‚ ุงู„ู†ู‡ุงุฆูŠ</h2> </div> <p class="phase-note"> ุจุงู„ุชุฑุชูŠุจ. ูƒู„ ุจู†ุฏ ูŠุนุชู…ุฏ ุนู„ู‰ ุงู„ุฐูŠ ู‚ุจู„ู‡ุŒ ูุงู„ุชูˆู‚ู ุนู†ุฏ ุฃูˆู„ ูุดู„ ูŠูˆูู‘ุฑ ูˆู‚ุชู‹ุง. </p> <div class="check"> <label><input type="checkbox" /><span><code>/health</code> ูŠุฑุฏู‘ <code>ok</code> ุนู„ู‰ ู†ุทุงู‚ ุงู„ู€ API.</span></label> <label><input type="checkbox" /><span>ุณุฌู„ู‘ ุงู„ุนุงู…ู„ ูŠูุธู‡ุฑ <code>arq: Starting worker</code>.</span></label> <label><input type="checkbox" /><span>ุงู„ู…ูˆู‚ุน ูŠูุชุญ ุนู„ู‰ ู†ุทุงู‚ูƒุŒ ูˆุงู„ุฎุท ุงู„ุนุฑุจูŠ ูŠุธู‡ุฑ ุตุญูŠุญู‹ุง ู…ู† ุงู„ูŠู…ูŠู† ู„ู„ูŠุณุงุฑ.</span></label> <label><input type="checkbox" /><span>ุงู„ุชุณุฌูŠู„ ุจุจุฑูŠุฏ ุฌุฏูŠุฏ ูŠู†ุฌุญุŒ ูˆูŠุตู„ ุฑู…ุฒ ุงู„ุฏุฎูˆู„.</span></label> <label><input type="checkbox" /><span>ุงู„ุฏุฎูˆู„ ุจุจุฑูŠุฏ ุงู„ู…ุณุคูˆู„ ูŠูุชุญ <code>/admin</code>.</span></label> <label><input type="checkbox" /><span>ู„ูˆุญุฉ ุฃู†ูˆุงุน ุงู„ู…ู‡ุงู… ุชุนุฑุถ ูƒู„ ุงู„ุฃู†ูˆุงุน โ€” ุฏู„ูŠู„ ุฃู† ุงู„ูˆุงุฌู‡ุฉ ุชู‚ุฑุฃ ู…ู† ุงู„ู€ API ูุนู„ู‹ุง.</span></label> <label><input type="checkbox" /><span>ู…ุดุฑูˆุน ุชุฌุฑูŠุจูŠ ุตุบูŠุฑ ูŠูู†ุดุฃ ูˆูŠุตู„ ุฅู„ู‰ ุจูˆุงุจุฉ ุงู„ู…ุฑุงุฌุนุฉ.</span></label> <label><input type="checkbox" /><span>ุงู„ุชู‚ุฏู‘ู… ูŠุชุญุฏู‘ุซ ุญูŠู‹ู‘ุง ุจู„ุง ุฅุนุงุฏุฉ ุชุญู…ูŠู„ โ€” ุฏู„ูŠู„ ุฃู† ุงู„ุทุงุจูˆุฑ ูˆุงู„ุจุซู‘ ูŠุนู…ู„ุงู†.</span></label> <label><input type="checkbox" /><span>ุงู„ุชุดุบูŠู„ุฉ ุชูƒุชู…ู„ ูˆูŠูู†ุฒูŽู‘ู„ ุงู„ู…ู„ู.</span></label> <label><input type="checkbox" /><span>ู„ูˆุญุฉ ุงู„ุชุญูƒู… ุชุนุฑุถ ุชูƒู„ูุฉ ุชู„ูƒ ุงู„ุชุดุบูŠู„ุฉ ุจุงู„ุฏูˆู„ุงุฑ.</span></label> <label><input type="checkbox" /><span>ุฌุฏุงูˆู„ <code>001_rag_documents.sql</code> ุฃูู†ุดุฆุช ููŠ SQL Editor.</span></label> <label><input type="checkbox" /><span>ุณูŠุงุณุงุช <code>002_rls.sql</code> ุดูุบู‘ู„ุช ููŠ SQL Editor.</span></label> </div> <div class="note"> <b>ุฃูˆู„ ุชุดุบูŠู„ุฉ ุญู‚ูŠู‚ูŠุฉ</b> <p> ุงุจุฏุฃ ุจุฃุตุบุฑ ู…ูุฏุฎู„ ู…ู…ูƒู† โ€” ุชุตูˆู‘ุฑ ุจูŠูˆู… ูˆุงุญุฏุŒ ุฃูˆ ูƒุชุงุจ ุจูุตู„ูŠู†. ุงู„ู‡ุฏู ุฅุซุจุงุช ุงู„ู…ุณุงุฑ ูƒุงู…ู„ู‹ุง ู„ุง ุฅู†ุชุงุฌ ู…ุงุฏุฉ. ูˆุฑุงู‚ุจ ู„ูˆุญุฉ OpenRouter ุฃุซู†ุงุกู‡ุง ู„ุชุฑู‰ ุงู„ุตุฑู ูŠุชุญุฑูƒ ูุนู„ู‹ุง. </p> </div> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 9 --> <section class="phase" id="p9"> <div class="phase-head"> <span class="phase-num">ู ูฉ</span> <h2 class="phase-title">ุฅุฐุง ุชุนุทู‘ู„ ุดูŠุก</h2> </div> <p class="phase-note"> ุงู„ุฃุนุทุงู„ ุงู„ู…ุชูˆู‚ุนุฉ ูˆุฃุนุฑุงุถู‡ุง. ุงู„ุฑุณุงู„ุฉ ุงู„ู…ุนุฑูˆุถุฉ ู†ุงุฏุฑู‹ุง ู…ุง ุชุดูŠุฑ ุฅู„ู‰ ุงู„ุณุจุจ. </p> <div class="tw"> <table> <thead><tr><th>ุงู„ุนูŽุฑูŽุถ</th><th>ุงู„ุณุจุจ</th><th>ุงู„ุญู„</th></tr></thead> <tbody> <tr> <td>ุงู„ู…ูˆู‚ุน ูŠูุชุญ ูˆูƒู„ ุทู„ุจ ูŠูุดู„</td> <td><code>CORS_ORIGINS</code> ู„ุง ูŠุทุงุจู‚ ุงู„ุฃุตู„ ุญุฑููŠู‹ุง</td> <td>ุงู†ุณุฎ ุงู„ุฃุตู„ ู…ู† ุดุฑูŠุท ุงู„ุนู†ูˆุงู† ุจู„ุง ุดุฑุทุฉ ุฃุฎูŠุฑุฉุŒ ูˆุฃุนุฏ ุงู„ู†ุดุฑ</td> </tr> <tr> <td>ุงู„ู€ API ูŠูุดู„ ุนู†ุฏ ุงู„ุฅู‚ู„ุงุน</td> <td><code>alembic upgrade head</code> ู„ู… ูŠุชุตู„ ุจุงู„ู‚ุงุนุฏุฉ</td> <td>ุฑุงุฌุน <code>DATABASE_URL</code>: ุงู„ู…ู†ูุฐ ูฆูฅูคูฃุŒ ูˆุจุงุฏุฆุฉ <code>+asyncpg</code>ุŒ ูˆูƒู„ู…ุฉ ู…ุฑูˆุฑ ู…ุฑู…ู‘ุฒุฉ</td> </tr> <tr> <td><code>too many connections</code></td> <td>ุงู„ุงุชุตุงู„ ุงู„ู…ุจุงุดุฑ ุนู„ู‰ ูฅูคูฃูข ุจุฏู„ ุงู„ู…ูุฌู…ูู‘ุน</td> <td>ุจุฏู‘ู„ ุฅู„ู‰ ุฑุงุจุท Transaction pooling</td> </tr> <tr> <td>ุชุดุบูŠู„ุงุช ุชุจู‚ู‰ ยซููŠ ุงู„ุงู†ุชุธุงุฑยป</td> <td>ุงู„ุนุงู…ู„ ู†ุงุฆู… ุฃูˆ ู…ุชูˆู‚ู</td> <td>ุชุฃูƒุฏ ุฃู†ู‡ ุนู„ู‰ ุฎุทุฉ Starter ูˆุฃู† <code>REDIS_URL</code> ูˆุตู„ู‡</td> </tr> <tr> <td>ุงู„ุงุณุชุฑุฌุงุน ู„ุง ูŠุฌุฏ ุดูŠุฆู‹ุง</td> <td><code>QDRANT_URL</code> ุจู„ุง ู…ู†ูุฐ ูฆูฃูฃูฃ</td> <td>ุฃุถู <code>:6333</code></td> </tr> <tr> <td>ู„ุง ูŠู…ูƒู† ุงู„ุฏุฎูˆู„ ู„ุฃูŠ ุญุณุงุจ</td> <td>ู„ุง ู…ุณุคูˆู„ ููŠ ุงู„ู†ุธุงู…</td> <td>ุงุถุจุท <code>BOOTSTRAP_ADMIN_EMAILS</code> ูˆุฃุนุฏ ุงู„ู†ุดุฑ ุซู… ุณุฌู‘ู„ ู…ู† ุฌุฏูŠุฏ</td> </tr> <tr> <td>ุฎุทุฃ <code>402</code> ููŠ ู…ู†ุชุตู ุชุดุบูŠู„ุฉ</td> <td>ุฑุตูŠุฏ OpenRouter ู†ูุฏ</td> <td>ุงุดุญู†ุŒ ุซู… ุงุถุบุท ยซุงุณุชุฆู†ุงูยป โ€” ุงู„ุฎุทูˆุงุช ุงู„ู…ูƒุชู…ู„ุฉ ู…ุญููˆุธุฉ</td> </tr> <tr> <td>Vercel: <code>No package.json</code></td> <td>ู…ุฌู„ุฏ ุงู„ุฌุฐุฑ ุบูŠุฑ ู…ุถุจูˆุท</td> <td>Settings โ† General โ† Root Directory โ† <code>apps/web</code></td> </tr> <tr> <td>ุงู„ุฏูˆู…ูŠู† ู„ุง ูŠูุญู„</td> <td>Nameservers ู„ูŠุณุช BasicDNS</td> <td>ุจุฏู‘ู„ู‡ุง ููŠ ุชุจูˆูŠุจ Domain ุซู… ุงู†ุชุธุฑ ุงู„ุงู†ุชุดุงุฑ</td> </tr> <tr> <td>ุชุบูŠูŠุฑ ู…ุชุบูŠู‘ุฑ ููŠ Vercel ุจู„ุง ุฃุซุฑ</td> <td><code>VITE_*</code> ุชูุญู‚ู† ูˆู‚ุช ุงู„ุจู†ุงุก</td> <td>Redeploy</td> </tr> </tbody> </table> </div> <h3>ุฃูŠู† ุชู‚ุฑุฃ</h3> <ul class="plain"> <li><b>Render โ† Logs</b> โ€” ุฃุฎุทุงุก ุงู„ุฎุงุฏู… ูˆุงู„ุนุงู…ู„. ุงุจุฏุฃ ู…ู† ู‡ู†ุง ุฏุงุฆู…ู‹ุง.</li> <li><b>Vercel โ† Deployments โ† Build Logs</b> โ€” ูุดู„ ุงู„ุจู†ุงุก.</li> <li><b>ูˆุญุฏุฉ ุชุญูƒู… ุงู„ู…ุชุตูุญ</b> โ€” ูƒู„ ู…ุง ูŠุฎุต CORS ูˆุงู„ู…ุตุงุฏู‚ุฉ.</li> <li><b>Supabase โ† Logs โ† Auth</b> โ€” ู…ุญุงูˆู„ุงุช ุงู„ุฏุฎูˆู„ ุงู„ู…ุฑููˆุถุฉ.</li> </ul> </section> <!-- โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• 10 --> <section class="phase" id="p10"> <div class="phase-head"> <span class="phase-num">ูกู </span> <h2 class="phase-title">ุงู„ุชูƒู„ูุฉ ูˆุงู„ุชุดุบูŠู„ ุงู„ูŠูˆู…ูŠ</h2> </div> <h3>ุงู„ุงุดุชุฑุงูƒุงุช</h3> <div class="tw"> <table> <thead><tr><th>ุงู„ุฎุฏู…ุฉ</th><th>ุงู„ุฎุทุฉ</th><th>ุดู‡ุฑูŠู‹ุง</th></tr></thead> <tbody> <tr><td>Render โ€” API</td><td>Starter</td><td>$7</td></tr> <tr><td>Render โ€” ุงู„ุนุงู…ู„</td><td>Standard โ€” ูข ุบูŠุบุงุจุงูŠุช</td><td>~$25</td></tr> <tr><td>Render โ€” Redis</td><td>ู…ุฌุงู†ูŠ</td><td>$0</td></tr> <tr><td>Vercel</td><td>Hobby</td><td>$0</td></tr> <tr><td>Supabase</td><td>Free</td><td>$0</td></tr> <tr><td>Qdrant</td><td>Free</td><td>$0</td></tr> <tr><td><b>ุงู„ุฅุฌู…ุงู„ูŠ</b></td><td></td><td><b>~$32</b></td></tr> </tbody> </table> </div> <p>ูŠูุถุงู ุฅู„ูŠู‡ุง ุงุณุชู‡ู„ุงูƒ ุงู„ู†ู…ุงุฐุฌุŒ ูˆู‡ูˆ ุงู„ู…ุชุบูŠู‘ุฑ ุงู„ุญู‚ูŠู‚ูŠ: ูƒุชุงุจ ู…ูƒุชู…ู„ ู†ุญูˆ ุฏูˆู„ุงุฑ ุจุนุฏ ุถุจุท ุงู„ู…ูŠุฒุงู†ูŠุฉุŒ ูˆุญู‚ูŠุจุฉ ุฎู…ุณุฉ ุฃูŠุงู… ุจูŠู† ูฃ ูˆูฅ ุญุณุจ ุนุฏุฏ ุงู„ู…ุญุงูˆุฑ.</p> <div class="warn"> <b>ู„ู…ุงุฐุง ุงู„ุนุงู…ู„ ุนู„ู‰ Standard ู„ุง Starter</b> <p> ุงู„ุนุงู…ู„ ูŠุญู…ู‘ู„ ู†ู…ูˆุฐุฌ ุงู„ุชุถู…ูŠู†ุŒ ูˆุงู„ู†ู…ูˆุฐุฌ ู‡ูˆ ู…ุนุธู…ู‡. ู‚ูŠุงุณ ูุนู„ูŠ ู„ุง ุชู‚ุฏูŠุฑ: ุจุงูŠุซูˆู† ูˆุญุฏู‡ ูกูจ ู…ูŠุฌุงุจุงูŠุชุŒ ูˆู…ุน <code>torch</code> ูกูฉูกุŒ ูˆู…ุน <code>sentence-transformers</code> ูฃูงูจุŒ ูˆุงู„ู†ู…ูˆุฐุฌ ู…ูุญู…ูŽู‘ู„ู‹ุง ูฆูฉูจุŒ ูˆุจุนุฏ ุชุฑู…ูŠุฒ ุฏูุนุฉ <b>ูงูฉูฃ ู…ูŠุฌุงุจุงูŠุช</b>. ูˆStarter ูŠุนุทูŠ ูฅูกูข. </p> <p> ู„ูˆ ุชูุฑูƒ ุนู„ูŠู‡ุง ู„ู‚ูุชู„ ุงู„ุนุงู…ู„ ู„ุญุธุฉ ุชุญู…ูŠู„ ุงู„ู…ูุฑู…ูู‘ุฒ โ€” ุฃูŠ ุนู†ุฏ ุงู„ูู‡ุฑุณุฉุŒ ุจุนุฏ ุฃู† ูŠูƒูˆู† ุงู„ุจุญุซ ูˆุงู„ุชู†ุฒูŠู„ ู‚ุฏ ุฏููุน ุซู…ู†ู‡ู…ุง โ€” ูˆู„ู…ุง ู‚ุงู„ ุงู„ุณุฌู„ ุบูŠุฑ <code>Exited with status 137</code>. </p> <p> ุฃู…ู‘ุง ุงู„ุฎุงุฏู… ููŠุจู‚ู‰ ุนู„ู‰ Starter: ุงุณุชูŠุฑุงุฏุงุช ุงู„ุฃุฌู†ุชุณ ููŠู‡ ู…ุคุฌูŽู‘ู„ุฉ ุฏุงุฎู„ ุงู„ุฏูˆุงู„ ุนู…ุฏู‹ุงุŒ ูˆุงู„ู†ู…ูˆุฐุฌ ู„ุง ูŠูุญู…ูŽู‘ู„ ููŠู‡ ุฃุตู„ู‹ุง. </p> </div> <h3>ุงู„ู†ุดุฑ ุจุนุฏ ุงู„ุชุนุฏูŠู„</h3> <p> ูƒู„ ุฏูุนุฉ ุฅู„ู‰ <code>main</code> ุชูุทู„ู‚ ู†ุดุฑู‹ุง ููŠ Render ูˆ Vercel ู…ุนู‹ุงุŒ ูˆ CI ูŠุดุชุบู„ ู‚ุจู„ู‡ู…ุง. ู„ูˆ ุฑุณุจ ุงู„ุงุฎุชุจุงุฑ ุฃูˆ ุถูุจุท ู…ูุชุงุญ ู…ุณุฑูŽู‘ุจุŒ ุนุงู„ุฌ ุฐู„ูƒ ู‚ุจู„ ุฃู† ุชุฏูุน ู…ุฑุฉ ุฃุฎุฑู‰. </p> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">terminal</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>cd C:\conti_ai\platform git add -A git commit -m "ูˆุตู ุงู„ุชุนุฏูŠู„" git push</code></pre> </div> <h3>ู‚ุจู„ ูƒู„ ุฏูุนุฉ</h3> <div class="cmd"> <div class="cmd-bar"><span class="cmd-label">terminal</span> <button class="copy" type="button">ู†ุณุฎ</button></div> <pre><code>cd C:\conti_ai\platform apps\api\.venv\Scripts\python.exe scripts\preflight.py</code></pre> </div> <h3>ุงู„ุงุญุชูŠุงุทูŠ</h3> <p> Supabase ูŠุฃุฎุฐ ู†ุณุฎุฉ ูŠูˆู…ูŠุฉ ููŠ ุงู„ุฎุทุฉ ุงู„ู…ุฌุงู†ูŠุฉ ูˆูŠุญุชูุธ ุจู‡ุง ุณุจุนุฉ ุฃูŠุงู…. ู‚ุจู„ ุฃูŠ ุชุฑุญูŠู„ ูƒุจูŠุฑ ุฎุฐ ู†ุณุฎุฉ ูŠุฏูˆูŠุฉ ู…ู† Database โ† Backups. ูˆู…ุง ููŠ Qdrant ู‚ุงุจู„ ู„ุฅุนุงุฏุฉ ุงู„ุจู†ุงุก ู…ู† ุงู„ู…ุณุชู†ุฏุงุช ุงู„ู…ุฑููˆุนุฉุŒ ู„ูƒู† ุฅุนุงุฏุชู‡ ุชูƒู„ู‘ู ูˆู‚ุชู‹ุง ูˆุงุณุชุฏุนุงุกุงุช. </p> </section> </main> <footer> <p> ContiAI โ€” ุฏู„ูŠู„ ุงู„ู†ุดุฑ. ุงู„ู…ู„ูุงุช ุงู„ู…ุฐูƒูˆุฑุฉ ูƒู„ู‡ุง ุฏุงุฎู„ ู…ุฌู„ุฏ <code>platform</code>: <code>render.yaml</code> ูˆ <code>apps/api/.env.example</code> ูˆ <code>apps/web/.env.example</code> ูˆ <code>infra/sql/002_rls.sql</code>. </p> </footer> </div> <script> // Copy buttons. The label is the only feedback, so it has to be honest - // it says "ู†ูุณุฎ" only after the clipboard call actually resolves. document.querySelectorAll("button.copy").forEach((button) => { button.addEventListener("click", async () => { const block = button.closest(".cmd").querySelector("code"); // Comment spans carry the leading "# ", which is wanted in the paste. const text = block.innerText.replace(/\u00a0/g, " ").trim(); try { await navigator.clipboard.writeText(text); button.textContent = "ู†ูุณุฎ"; button.dataset.done = "1"; } catch { button.textContent = "ุญุฏู‘ุฏู‡ ูˆุงู†ุณุฎู‡ ูŠุฏูˆูŠู‹ุง"; } setTimeout(() => { button.textContent = "ู†ุณุฎ"; delete button.dataset.done; }, 1800); }); }); </script> </body> </html>
<!doctype html>
<html lang="ar" dir="rtl">
<head>
<meta charset="utf-8" />
<title>ู†ุดุฑ ContiAI โ€” ุงู„ุฏู„ูŠู„ ุงู„ูƒุงู…ู„</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />
<style>
/* ContiAI's own tokens. Ultramarine and gold, blue-tinted neutrals, the
brand's radius ladder. Nothing invented that the product does not use. */
:root {
--brand-50: #eef1fe; --brand-100: #dfe4fd; --brand-200: #c4cdfb;
--brand-600: #3538d9; --brand-700: #2b29bc; --brand-950: #16164a;
--gold-50: #fef8ec; --gold-200: #f9da8e; --gold-600: #c2680d;
--gold-800: #843a13;
--ink-0: #ffffff; --ink-50: #f7f8fc; --ink-100: #eff1f7;
--ink-200: #e1e5ee; --ink-300: #cbd1e0; --ink-400: #9ba3ba;
--ink-500: #6f7893; --ink-600: #525b75; --ink-800: #2c3244;
--ink-900: #1c2130; --ink-950: #11141e;
--page: var(--ink-50);
--surface: var(--ink-0);
--surface-2: var(--ink-100);
--line: var(--ink-200);
--line-soft: var(--ink-100);
--text: var(--ink-900);
--text-body: var(--ink-800);
--muted: var(--ink-500);
--accent: var(--brand-700);
--accent-sm: var(--brand-50);
--accent-ln: var(--brand-200);
--warn: var(--gold-800);
--warn-bg: var(--gold-50);
--warn-ln: var(--gold-200);
--code-bg: var(--ink-950);
--code-fg: #e6e9f5;
--code-dim: #8d94ad;
--r-sm: 9px; --r-md: 11px; --r-lg: 14px; --r-xl: 20px;
--sans: "Segoe UI", "Noto Kufi Arabic", "Dubai", Tahoma, system-ui, sans-serif;
--mono: "Cascadia Mono", Consolas, ui-monospace, monospace;
color-scheme: light dark;
}
/* Flat, not nested: the un-stamped document is what most readers see, and
it must resolve without relying on CSS nesting support. */
@media (prefers-color-scheme: dark) {
:root:not([data-theme="light"]) {
--page: #0c0e17;
--surface: var(--ink-950);
--surface-2: #171b28;
--line: #262b3b;
--line-soft: #1d2230;
--text: #eef0f7;
--text-body: #d3d8e6;
--muted: var(--ink-400);
--accent: #9dacf7;
--accent-sm: #171a3a;
--accent-ln: #2f3563;
--warn: #f5c053;
--warn-bg: #2a1f0e;
--warn-ln: #4d3a15;
--code-bg: #05070d;
--code-fg: #e6e9f5;
--code-dim: #7b829b;
}
}
:root[data-theme="dark"] {
--page: #0c0e17;
--surface: var(--ink-950);
--surface-2: #171b28;
--line: #262b3b;
--line-soft: #1d2230;
--text: #eef0f7;
--text-body: #d3d8e6;
--muted: var(--ink-400);
--accent: #9dacf7;
--accent-sm: #171a3a;
--accent-ln: #2f3563;
--warn: #f5c053;
--warn-bg: #2a1f0e;
--warn-ln: #4d3a15;
--code-bg: #05070d;
--code-fg: #e6e9f5;
--code-dim: #7b829b;
}
*, *::before, *::after { box-sizing: border-box; }
body {
margin: 0;
background: var(--page);
color: var(--text-body);
font-family: var(--sans);
font-size: 16px;
line-height: 1.75;