Site plan

PLAN.md پروجیکٹ کی پہلی بلڈ مکمل ہوتے ہی لکھی جاتی ہے، اور اس کا مقصد ہمیشہ سائٹ کی موجودہ حالت بیان کرنا ہوتا ہے — اس کے ساتھ جو کچھ بھی ہوا اس کا لاگ نہیں (وہ کام Versions ٹیب اور Changelog کے ہیں)۔ Site plan اسکرین اس Markdown کو اصل UI میں بدلتی ہے: صفحات کے لیے ٹیبل، ماڈیولز کے لیے فہرست، کھلے سوالات کے لیے چیک لسٹ، اور کاروباری حقائق، برانڈ اور فیصلوں کے لیے سادہ متن۔

کسی بھی بلڈ کے مکمل ہونے سے پہلے پڑھنے کو کچھ نہیں ہوتا: اسکرین "ابھی کوئی پلان نہیں" دکھاتی ہے، صاف بتاتی ہے کہ پلان پروجیکٹ کی پہلی بلڈ لکھتی ہے، اور خالی ٹیبل دکھانے کے بجائے پروجیکٹ کے اپنے صفحے کا لنک دیتی ہے۔

ایسی سائٹ جس کی فائلیں بغیر پلان کے آئیں (کنیکٹر کے ذریعے کسی اور AI ٹول سے شائع، امپورٹ، یا اپ لوڈ) پھر بھی ایک پلان حاصل کرتی ہے: اسکرین پروجیکٹ بریف، کٹ کے انتخابات اور ماپے گئے صفحات سے پلان شروع کرتی ہے، اور ایک بینر، "یہ پلان آپ کے لیے شروع کیا گیا تھا"، Save this plan کی پیشکش کرتا ہے، جو اسے پروجیکٹ کا اصل پلان بنا دیتا ہے تاکہ ہر سیکشن ایڈٹ ہو سکے۔ Read the full site plan بٹن Plan & brief ٹیب پر موجود پلان دستاویز تک لے جاتا ہے۔

Kit سے (Add to plan کے ذریعے) بعد میں شامل کیے گئے ٹولز Modules فہرست میں Planned کے طور پر آ جاتے ہیں، ساتھ View in the Kit لنک کے، چاہے پلان کا متن ان کے شامل ہونے سے پہلے ہی کیوں نہ لکھا گیا ہو۔

عنوان کے نیچے ایک سطر بتاتی ہے کہ پلان آخری بار کب تازہ کیا گیا: "Plan updated Oct 2, 3:04 PM"۔ یہ وقت اس آخری بار سے آتا ہے جب aiKit نے سائٹ کی اصل فائلیں ماپیں، اور یہ ہر تبدیلی کے بعد ہوتا ہے (چیٹ میں ترمیم، پن، کٹ میں شامل کرنا، بحالی، پلان کی ہاتھ سے ترمیم، یا کسی اور AI ٹول سے اشاعت)۔

سب توں اُتے، جدوں اک پلان بن جائے: اک مجموعی فیصد مکمل ہون والی بار، تے اس دے تھلے تن ٹائل: بنائے ہوئے صفحے (منصوبہ بندی توں کنے)، بنائے ہوئے ماڈیول (چُنے ہوئے کنے)، تے جواب دتے سوال (پلان دے کھلے سوالاں توں کنے)۔ ہر ٹائل اک بٹن ہے جو اس حصے تک سکرول کردا ہے جس نوں اوہ گندا ہے۔ ایہہ سب پلان دے متن توں خود رپورٹ نہیں ہُندا: کوئی صفحہ اوданوں بنیا ہویا گنیا جاندا جدوں aiKit اسنوں سائٹ دیاں اصل فائلاں وچ لبھے؛ کوئی ماڈیول اوданوں بنیا گنیا جاندا جدوں تصدیق شدہ بلڈ رپورٹ جاں فائلاں وچ لبھے ماڈیول توں ایہہ ثابت ہووے؛ تے کوئی سوال اوданوں جواب دتا گنیا جاندا جدوں اس دی لائن پلان وچ نشان لگی ہووے جاں گاہک نے اپنے Questions صفحے تے جواب دتا ہووے۔

دو گلاں پلان نوں پچھے رکھدیاں نیں، تے سکرین دسدی ہے کہڑی: اوہ AI پاس جو کسے تبدیلی توں بعد پلان نوں دوبارہ لکھدا ہے مکمل نہیں ہویا ("لکھیا پلان پچھلی تبدیلی توں بعد اپڈیٹ نہیں ہویا،" کارن دے نال)، جاں سائٹ دا نویں ورژن ہے جس دے مقابلے وچ پلان نوں ماپیا گیا سی ("پلان آخری واری اپڈیٹ ہون توں بعد سائٹ بدل گئی")۔ دوہاں صورتاں وچ "پلان تازہ کرو" بٹن دِسدا ہے۔ صفحہ کھولن تے ایہہ خود نہیں چلدا (صفحہ کھولن نال AI کدی نہیں ورتیا جاندا)؛ انجن ہر تبدیلی نوں پس منظر وچ پلان وچ شامل کر دیندا ہے، تے ایہہ بٹن اوس لئی ہے جدوں ایہہ کم پچھے رہ جائے۔ پلان تازہ کرو تازہ ترین تبدیلی نوں لکھے پلان وچ شامل کردا ہے تے سائٹ نوں دوبارہ ماپدا ہے۔ جے فیر وی کم نہ ہووے، تاں بینر اوہی دسدا رہندا ہے کہ کیہ گل غلط ہوئی، تے تسی "پلان تازہ کرو" دوبارہ دبا سکدے ہو یا پلان نوں ہتھوں ایڈٹ کر سکدے ہو۔

صحت کارڈ سائٹ نوں 100 وچوں نمبر دیندا ہے، اوہناں قاعدیاں توں جو aiKit اصل فائلاں وچ چیک کردا ہے، کدی AI دی رائے توں نہیں: کوئی گم جاں دوہرا صفحہ عنوان یا تلاش وضاحت، کوئی صفحہ جس وچ مرکزی سرخی نہ ہووے جاں ایک توں ودھ ہووے، کسے ایسے صفحے دا لنک جو موجود نہیں، اوہ صفحہ جس تے کوئی لنک نہ ہووے تے مینو وچ وی نہ ہووے، اسکرین ریڈر لئی تفصیل توں بغیر تصویراں، بہت چھوٹے صفحے، اوہ فارم جس دا جواب کتے نہ جاندا ہووے، تے اوہ ماڈیول جو بریف وچ منگیا گیا مگر سائٹ تے نہیں۔ ہر مسئلہ دسدا ہے کہ کیہڑا صفحہ، کیوں اہم ہے، تے اس دا اک Fix بٹن ہے: Fix اس مسئلے دی تیار ہدایت نوں درخواست بنا کے فائل کردا ہے تے AI نوں دیندا ہے، کم چلدیاں بٹن "Fix requested" دسدا ہے، تے تبدیلی لگن تے نمبر دوبارہ ماپیا جاندا ہے۔ High، Medium تے Low گنتیاں نال سیوریٹی توں فہرست فلٹر کرو، تے "Show all" فلٹر صاف کر دیندا ہے۔

سائٹ میپ سائٹ نوں درخت وانگ دِکھاندا ہے: سب توں اُتے ہوم، فیر مینو ترتیب وار، فیر اوہ صفحے جو انہاں صفحیاں توں پہنچے جاندے نیں۔ جنہاں صفحیاں تے کوئی لنک نہیں، اوہ اپنے گروپ وچ بیٹھدے نیں، پلان وچ درج پر ابھی نہ بنے صفحے ڈیشڈ لائن نال دِکھائے جاندے نیں تے Planned نشان لگدا ہے، تے بنے ہوئے مگر پلان وچ ذکر نہ ہون والے صفحیاں اُتے "Not in the plan" لکھیا آندا ہے نال "Add to plan" بٹن جو اوہناں نوں Pages حصے وچ شامل کردا ہے۔

کسے وی صفحے (سائٹ میپ یا Pages فہرست وچ) تے دبا کے اس دی تفصیل پلان دے نال کھلدی ہے۔ ایڈریس بار ?page=/about وچ بدل جاندا ہے، تاں جو لنک ٹیم دے ہر بندے لئی اوہی صفحہ کھولے۔ تفصیل وچ دِسدا ہے کہ صفحہ گوگل وچ کیویں لگدا ہے (عنوان، پتہ، وضاحت)، اس دے حصے تے مرکزی سرخیاں، لفظاں دی گنتی، تصویراں تے کنیاں وچ وضاحت نہیں، اس دے فارم تے کہڑا کٹ ماڈیول اوہناں نوں چلاندا ہے، کیہ گاہک نے منظور کیتا ہے، تے آخری تبدیلی: کدوں، کس نے مانگی، تے کیہ مانگیا۔

تاریخ اوہ ورژن دسدی ہے جو aiKit رکھدا ہے (Original تے نویں ترین 10)، نویں توں پرانے ترتیب وار: اس دا نمبر، تبدیلی دی قسم (First build، Chat، Pin، Kit، Published، Restore، Plan edit)، کدوں، کیہ مانگیا، کس نے مانگیا، تے کیہڑے صفحے بدلے (صفحہ تے دبا کے اس دی تفصیل کھولو)۔ سب توں نویں تے "Current version" لکھیا ہُندا ہے؛ کوئی وی پرانا ورژن "Restore this version" دسدا ہے، جو پہلاں پُچھدا ہے تے سائٹ واپس رکھن توں پہلاں موجودہ حالت محفوظ کردا ہے، تاں جو بحالی وی واپس کیتی جا سکے۔ پہلے تن دِسدے نیں؛ "Show all" باقی سب دِکھاندا ہے۔

Business facts حصہ گاہک فائل وچلے فون، ای میل، پتے تے وقتاں نوں بنائے ہوئے صفحیاں دے متن نال ملاندا ہے (پہلاں ہوم تے رابطہ)۔ ہر حقیقت دسدی ہے "On the site" یا "Not found on the site" (نال ایہہ وی کہ کنے صفحے چیک ہوئے، کیونکہ سائٹ پرانی قیمت دِکھا سکدی ہے)، تے اک "Edit in the Client File" لنک گاہک فائل نوں اصل ذریعہ رکھدا ہے۔

• Pages — اک جدول: Page، Path، Purpose، تے Status (Built یا Planned)، جدوں صفحہ بن جائے تے سائٹ لائیو ہووے تاں اصل "View" لنک لائیو صفحے تے۔
• Modules and tools — پلان وچ درج ہر ماڈیول، ہر اک نال Built یا Planned پِل تے اپنا نوٹ۔
• Business facts — وقت، پتہ، خدمات، قیمتاں، کاروبار بارے کوئی وی حقیقی گل، سادہ متن وچ۔
• Brand — پلان وچ درج رنگ، لہجہ، تے کوئی وی سٹائل نوٹ۔
• Decisions — اصل فیصلے جو ہو چکے نیں تے جنہاں نوں اگلی تبدیلی وچ دوبارہ نہیں کھولنا چاہیدا۔
• Open questions — ابھی واقعی فیصلہ نہ ہون والیاں گلاں دی چیک لسٹ، ہر اک دِکھاندی ہے answered یا still open۔

ہر حصہ کارڈ وچ اکو جہے دو بٹن ہُندے نیں۔ "Edit" اوس حصے دا خام Markdown سادہ ٹیکسٹ ایریا وچ کھولدا ہے تے سِدھا PLAN.md وچ واپس محفوظ کردا ہے۔ ایہہ اصل تے فوری لکھت ہے (پروجیکٹ دے اپنے PUT endpoint راہیں)، پر جان بوجھ کے اس وچ بلڈ یا ڈپلائے شروع نہیں ہُندا؛ ایہہ صرف دسدا ہے کہ پلان دی دستاویز کیہ کہندی ہے، جیویں کسے وی نوٹ نوں ایڈٹ کرن نال ہُندا ہے۔

"Ask for a change" جان بوجھ کے مختلف ہے: ایہہ اک چھوٹا فارم کھولدا ہے ("<section> وچ کیہ تبدیلی چاہندے ہو؟")، تے بھیجن نال پروجیکٹ دے Feedback ٹیب تے اصل درخواست جاندی ہے، جس دا لیبل "Site plan — <Section>: …" ہُندا ہے، بالکل جویں کسے وی pin یا Quick edit درخواست نال، اپنے اسٹیٹس دے دور نال، تے بھیجن توں بعد "View the request" لنک۔ Edit اوس وقت ورتو جدوں تسی پلان دا اپنا متن خود درست یا دوبارہ لکھنا چاہندے ہو؛ Ask for a change اوس وقت ورتو جدوں تسی چاہندے ہو کہ اصل سائٹ (تے اس دے نتیجے وچ پلان) اس نال ملائی جائے۔

یہ پلان دو تہاں وچ ہے۔ پیمائشاں (صفحے، عنوان، حصے، لنک، فارم، ماڈیول، صحت) ہر تبدیلی دے بعد اصل فائلاں توں کوڈ ذریعے لی جاندیاں ہن، اس لئی ایہ کدی وی بے میل نہیں ہوندیاں۔ لکھیا ہویا پلان (مقصد، کاروباری حقائق، برانڈ، فیصلے، کھلے سوال) ہر تبدیلی توں بعد چلن والا اے آئی پاس تازہ رکھدا اے، جو صرف اوہ حصے دوبارہ لکھدا اے جنہاں نوں تبدیلی نے چھوہیا ہووے۔ ایہ کدی وی تبدیلیاں دا لاگ یا تاریخ والیاں انٹریاں شامل نہیں کردا؛ تبدیلیاں دا ریکارڈ تاریخ وچ ہوندا اے۔

جے اے آئی پاس ناکام ہو جائے تاں لکھیا ہویا پلان ادھا لکھن دی بجائے جیویں سی تیویں رہندا اے، ناکامی ریکارڈ ہوندی اے، تے سکرین خاموشی نال پرانا پلان دکھان دی بجائے پلان تازہ کرو (اوپر دیکھو) دکھاندی اے۔

پلان دے نال اک پٹی وچ کارروائیاں ہوندیاں نیں (فون تے ایہ پٹی پراگریس بینڈ دے تھلے پوری چوڑائی دا "کلائنٹ لنک کاپی کرو" بٹن بن جاندی اے، باقی "مزید کارروائیاں (3)" دے تھلے لکے ہوندے نیں)۔ "کلائنٹ نال شیئر کرو" اک صرف پڑھن والا لنک (aikit.ai/p/<project>/plan) کاپی کردا اے، جس وچ سٹاف دے ٹول، ایڈٹ بٹن یا اندرونی چیز کچھ وی نہیں ہوندا۔ "لائیو سائٹ کھولو" سیدھا لائیو سائٹ دا لنک اے، یا جے سائٹ لائیو نہ ہووے تاں پٹی صاف لکھدی اے "ابھی لائیو نہیں"۔ "فائلاں" اصل فائلاں دی گنتی دکھاندا اے، تے ہر فائل دے راستے تے سائز دی پھیلنے والی فہرست۔ "پلان ڈاؤنلوڈ کرو" موجودہ PLAN.md اصل .md فائل دے طور اتے ڈاؤنلوڈ کردا اے، بالکل اوہی جو سکرین پڑھ رہی اے، کوئی دوبارہ بنایا ہویا خلاصہ نہیں۔

کلائنٹ دا صفحہ اپنے پلان ٹیب توں کھلدا اے: اوہی سائٹ پلان دستاویز جو سٹاف پلان تے بریف ٹیب اتے دیکھدا اے (جائزہ تے مقاصد، سامعین، حکمت عملی، سائٹ میپ، ہر ٹول تے اوہ اس دے کاروبار لئی کیہ کردا اے تے اس دی حالت، مواد دا منصوبہ، ٹائم لائن، فیصلے تے کھلے سوال)، مگر سٹاف والے حصے نکال کے: نہ ٹول شامل کرن دے وقت لکھے نوٹ، نہ کسنے کیہ شامل کیتا، نہ aiKit دے Kit وچ لنک، تے نہ "پلان لکھو" بٹن۔ دوسرا ٹیب، صفحے اور منظوریاں، صفحہ بہ صفحہ ویو ہیٹھ رکھدا اے۔

صفحے اور منظوریاں اتے، اوہی رسائی کوڈ جو اوہ فیڈبیک دین لئی پہلاں توں ورتدے نیں (کوئی وکھرا لاگ اِن نہیں) لاگو ہوندا اے۔ کلائنٹ اوہی پراگریس بینڈ، اپنے صفحیاں دا سائٹ میپ، "View" لنکاں والی صفحیاں دی فہرست، ماڈیول، کاروباری حقائق، برانڈ، فیصلے تے کھلے سوال، نال "پلان تازہ ہو گیا" لائن ویکھدا اے۔ اوہنوں صحت، ٹھیک کرن دیاں ہدایات، تاریخ، کسنے کیہ منگیا، فائلاں دی فہرست، تے کوئی وی ایڈٹ یا "تبدیلی منگو" بٹن نہیں ملدا۔

جو کچھ سٹاف اپنے لئی نشان لاؤندا اے، اوہ صفحہ بھیجن توں پہلاں سرور اتے ہر حصے وچوں ہٹا دتا جاندا اے: "(internal)"، "[internal]" یا "(staff only)" والی لائن، "Internal:" یا "Staff only:" توں شروع ہون والی لائن، عنوان وچ Internal یا Staff only والا کوئی وی حصہ، تے لکے ہوئے تبصرے۔ ایہ لائناں کلائنٹ دے براؤزر تک کدی وی نہیں پہنچدیاں، صفحے دے نیٹ ورک ڈیٹا وچ وی نہیں۔

ہر بنائے ہوئے صفحے اتے منظوری دا بٹن ہوندا اے۔ کلائنٹ اپنا نام (تے اختیاری نوٹ) لکھ کے منظوری دیندا اے؛ منظوری اس صفحے دے عین موجودہ مواد نال جڑی ہوندی اے، تے جے صفحہ بعد وچ بدلے تاں "منظوری دے بعد تبدیل ہو گیا" دکھاندا اے تے دوبارہ پُچھدا اے۔ صرف کلائنٹ دا رسائی کوڈ ورتن والا ای منظوری دے سکدا اے۔ جے تسیں سٹاف دے طور اتے لاگ اِن ہو کے کلائنٹ لنک کھولو تاں ہر صفحے دی منظوری دی حالت ویکھدے او پر منظوری دا بٹن نہیں ہوندا، تاکہ کوئی وی کلائنٹ دی جگہ منظوری نہ دے سکے۔ سٹاف دے سائٹ پلان اتے منظور شدہ صفحے "کلائنٹ نے منظور کیتا" تے تبدیل شدہ "منظوری توں بعد تبدیل ہوا" دکھاندے نیں۔

تھلے اک "فیڈبیک بھیجو" بٹن ہوندا اے: جے سائٹ لائیو اے تاں ایہ اصل لائیو سائٹ اوہدے اپنے رسائی کوڈ نال فیڈبیک اوورلے آن کر کے کھولدا اے؛ جے ابھی لائیو نہیں تاں ایہ اوہنوں اوہدے "حالیہ تبدیلیاں" صفحے اتے لے جاندا اے۔