यह दीर्घ-रूप वाला डीप-डाइव है। शीघ्र साथी के लिए, देखें ब्लॉग पोस्ट. कर सलाह नहीं. लाइव एचएमआरसी सबमिशन से पहले हमेशा यूके अकाउंटेंट की समीक्षा करें।
1. परिचय: क्या एआई स्वचालित रूप से स्व-मूल्यांकन दर्ज कर सकता है?
ईमानदार जवाब है अधिकतर तैयारी के लिए हाँ, बिना ध्यान दिए सबमिशन के लिए नहीं. एक एआई सिस्टम एक पीडीएफ बैंक स्टेटमेंट को निगल सकता है, सैकड़ों लेनदेन निकाल सकता है, उन्हें एचएमआरसी सेल्फ असेसमेंट व्यय श्रेणियों में वर्गीकृत कर सकता है, शेष राशि का मिलान कर सकता है, 2025-26 जैसे कर वर्ष के लिए आयकर और राष्ट्रीय बीमा की गणना कर सकता है, और फाइल करने के लिए एचएमआरसी मेकिंग टैक्स डिजिटल (एमटीडी) एपीआई को कॉल कर सकता है - लेकिन केवल एक मानव (या अकाउंटेंट) द्वारा वर्गीकरण, सुलह और गणना रिटर्न की समीक्षा करने के बाद, और करदाता द्वारा एचएमआरसी पूरा करने के बाद ही। उनके सरकारी गेटवे क्रेडेंशियल्स के साथ OAuth।
यह आलेख दस्तावेज है फ़ाइलमाईटैक्सद्वारा विकसित एक प्रदर्शन पाइपलाइन कार्यस्थान के लिए कॉग्नोएआई, जो अंतर्निहित सिस्टम बौद्धिक संपदा का मालिक है और उसने यह प्रकाशित करने की अनुमति दी है कि यह कैसे काम करता है। FileMyTax यहां प्रयुक्त प्रकाशन नाम है; यह अन्य CognoAI पेशकशों के समान उत्पाद नाम नहीं है। वर्कस्टेशन का निर्माण और कार्यान्वयन का दस्तावेजीकरण; CognoAI के पास IP है।
हम छह-एपीआई पाइपलाइन, आर्किटेक्चर के माध्यम से चलेंगे, जहां एआई वित्तीय विश्लेषण में मदद करता है, जहां नियतात्मक कोड को अपना स्थान लेना चाहिए, एचएमआरसी ओएथ और एमटीडी फाइलिंग, मकान मालिक बैंक-स्टेटमेंट परीक्षण से सीखी गई सीमाएं, और क्यों पूरी तरह से अप्राप्य फाइलिंग की सिफारिश नहीं की जाती है।
2. इसे किसने और क्यों बनवाया
कॉग्नोएआई पीडीएफ बैंक स्टेटमेंट और स्प्रेडशीट गोंद में डूबे मकान मालिकों, एकमात्र व्यापारियों और वित्त टीमों के लिए यूके सेल्फ असेसमेंट के दर्द को कम करने के लिए अंतर्निहित प्लेटफ़ॉर्म को चालू किया गया। लक्ष्य एकाउंटेंट को प्रतिस्थापित करना नहीं है - यह कठिन 90% (निष्कर्षण, वर्गीकरण, सुलह, ड्राफ्ट गणना) को स्वचालित करना है, इसलिए पेशेवर समीक्षा निर्णय कॉल पर केंद्रित है, न कि डेटा प्रविष्टि पर।
कार्यस्थान स्टैक को इंजीनियर किया गया: डॉकराइज्ड नेग्नेक्स रूटिंग, एक नेक्स्ट.जेएस फ्रंटएंड, एआई-हेवी ऑपरेशंस के लिए फास्टएपीआई, प्रमाणीकरण और टैक्स सीआरयूडी, पोस्टग्रेएसक्यूएल, मिनिओ ऑब्जेक्ट स्टोरेज और गैटस हेल्थ मॉनिटरिंग के लिए ऑप्सैपी (लुआ लैपिस)। यह आलेख CognoAI एट्रिब्यूशन के साथ FileMyTax डेमो नाम के तहत उस आर्किटेक्चर की व्याख्या करता है।
3. समस्या: पीडीएफ, स्प्रेडशीट और एमटीडी
जमींदारों और एकमात्र व्यापारियों को अक्सर बैंक पीडीएफ के वार्षिक पैक प्राप्त होते हैं - कई खाते, मिश्रित व्यक्तिगत और व्यावसायिक लाइनें, बंधक ब्याज, मरम्मत, एजेंट शुल्क और स्थानांतरण जिन्हें बड़े पैमाने पर वर्गीकृत करना कठिन होता है। विकास में हमने पाइपलाइन के विरुद्ध तनाव-परीक्षण किया काल्पनिक एचएसबीसी-शैली मकान मालिक कथन फिक्स्चर (केवल सिंथेटिक डेटा, वास्तविक ग्राहक रिकॉर्ड नहीं) लोड के तहत निष्कर्षण को मान्य करने के लिए £500k और £700k के आसपास टर्नओवर परिदृश्यों के साथ। वास्तविक दुनिया के पैक अस्त-व्यस्त हैं: स्कैन किए गए पृष्ठ, तालिका लेआउट जहां शेष कॉलम को गलती से भुगतान की गई राशि समझ लिया जाता है, और "ट्रांसफर" के आगे "रेंट आरईसी" जैसे विवरण जिन्हें संदर्भ की आवश्यकता होती है।
स्प्रेडशीट तब तक काम करती हैं जब तक वे ऐसा नहीं करते: फॉर्मूला ड्रिफ्ट, कोई ऑडिट ट्रेल नहीं, कोई प्रत्यक्ष एमटीडी सबमिशन नहीं, और एचएमआरसी व्यय श्रेणियों (कॉस्टऑफगुड्स, परिसररनिंगकॉस्ट, प्रोफेशनलफीस और बाकी) के लिए कोई सुसंगत मैपिंग नहीं। पैकेज्ड SaaS मदद कर सकता है, लेकिन विशिष्ट डेटा रेजिडेंसी आवश्यकताओं या अजीब स्टेटमेंट प्रारूपों वाली टीमों को अभी भी उनके द्वारा नियंत्रित पाइपलाइन से लाभ होता है।
4. FileMyTax सिंहावलोकन
स्पष्ट अंग्रेजी में, FileMyTax निम्नलिखित कार्य करता है:
- आप एक पीडीएफ बैंक स्टेटमेंट अपलोड करें।
- एआई और पीडीएफप्लंबर संरचित लेनदेन निकालते हैं।
- एलएलएम आत्मविश्वास स्कोर के साथ प्रत्येक पंक्ति को स्व-मूल्यांकन श्रेणियों में वर्गीकृत करता है।
- सिस्टम डेबिट, क्रेडिट और चालू शेष का मिलान करता है।
- एक नियतात्मक कर इंजन चुने हुए कर वर्ष के लिए रिटर्न की गणना करता है।
- मानव अनुमोदन और HMRC OAuth के बाद, प्लेटफ़ॉर्म MTD के माध्यम से फ़ाइल कर सकता है।
सब कुछ लोकलहोस्ट (या मोबाइल परीक्षण के लिए LAN IP) पर एक एकल nginx प्रविष्टि बिंदु के पीछे चलता है। JWT प्रमाणीकरण FastAPI और opsapi के बीच साझा किया जाता है। राष्ट्रीय बीमा नंबर जैसे संवेदनशील क्षेत्र बाकी समय एन्क्रिप्टेड होते हैं।
5. छह चरणों वाली एपीआई पाइपलाइन
संपूर्ण डेमो पाइपलाइन छह प्रमाणित एपीआई कॉल है (उदाहरण के लिए nginx का उपयोग करें)। http://localhost; यदि पोर्ट समायोजित करें NGINX_HOST_PORT सेट है)। के माध्यम से एक JWT प्राप्त करें POST /opsapi/auth/login प्रथम.
प्रत्येक चरण अद्यतन होता है ProcessingStatus और ValidationStatus पंक्तियाँ ताकि यूआई और गैटस-आसन्न ऑप्स टूलिंग यह देख सकें कि कोई कथन गणना के लिए तैयार बनाम निष्कर्षण में फंस गया है या नहीं। अलगाव में कर्ल उदाहरण पढ़ते समय उस राज्य मशीन को नजरअंदाज करना आसान है, लेकिन यह वही है जो समानांतर अपलोड को सुरक्षित बनाता है: स्टेटमेंट आईडी स्वतंत्र हैं, और हमेशा एक ही कुंजी की गणना करते हैं statement_id प्लस स्पष्ट tax_year क्वेरी पैरामीटर (उदाहरण के लिए 2025-26).
फास्टएपीआई के लिए स्वैगर यहां रहता है http://localhost/fastapi/docs; ऑप्सैपी उजागर करता है http://localhost/opsapi/swagger. जब nginx पोर्ट 80 लिया जाता है (रंचर डेस्कटॉप या अपाचे के साथ सामान्य), तो सेट करें NGINX_HOST_PORT=8080 में .env और पुनः चलाएँ ./start.sh - फिर सभी उदाहरणों का उपयोग करें localhost:8080 इसके बजाय.
5.1 पीडीएफ विवरण अपलोड करें
curl -F "file=@bank_statement.pdf" \
-H "Authorization: Bearer $TOKEN" \
http://localhost/fastapi/api/upload
5.2 लेनदेन निकालें
curl -X POST http://localhost/fastapi/api/extract \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"statement_id": 1}'
मूल पीडीएफ पीडीएफप्लंबर का उपयोग करते हैं; स्कैन की गई पीडीएफ़ क्लाउड विज़न ओसीआर में वापस आ जाती हैं। क्लासिफायर प्रदाता का चयन किया जाता है LLM_PROVIDER (ओपनएआई या एंथ्रोपिक) स्टार्टअप पर - विफलता पर कोई स्वचालित क्रॉस-प्रदाता फ़ॉलबैक नहीं है; असफल वर्गीकरण अवर्गीकृत होकर वापस आते हैं confidence: 0.0.
5.3 लेनदेन को वर्गीकृत करें
curl -X POST http://localhost/fastapi/api/classify \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"statement_id": 1}'
5.4 समाधान कथन
curl -X POST http://localhost/fastapi/api/reconcile \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"statement_id": 1}'
5.5 टैक्स रिटर्न की गणना करें
curl -H "Authorization: Bearer $TOKEN" \
http://localhost/fastapi/api/calculate/1?tax_year=2025-26
कर कैलकुलेटर 2025/26 नियम लागू करता है: व्यक्तिगत भत्ता £12,570 £100k से अधिक टेपर के साथ, 20%, 40%, 45% पर आयकर बैंड, और कक्षा 4 एनआई 8% और 2% पर। यह कदम है नियतिवादी पायथन - अंकगणित में कोई एलएलएम नहीं।
5.6 एचएमआरसी को फाइल
curl -X POST http://localhost/fastapi/api/file \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"statement_id": 1,
"nino": "AB123456C",
"access_token": "your_hmrc_token",
"tax_year": "2025-26"
}'
इस समापन बिंदु को अप्राप्य न कहें। समीक्षा और अकाउंटेंट के हस्ताक्षर के बाद इसे अंतिम द्वार मानें।
6. वास्तुकला
ट्रैफ़िक nginx के माध्यम से प्रवाहित होता है: / Next.js के लिए, /fastapi/* फास्टएपीआई को, /opsapi/* ऑप्सैपी को. PostgreSQL विवरण, लेनदेन, कर रिटर्न और प्रसंस्करण स्थिति रखता है। मिनियो स्टोर्स ने पीडीएफ अपलोड किए। पोर्ट 8085 पर गैटस हर 10-30 सेकंड में स्वास्थ्य समापन बिंदुओं का सर्वेक्षण करता है। प्रत्यक्ष डिबग पोर्ट मौजूद हैं (FastAPI 8847, फ्रंटएंड 3847) लेकिन उत्पादन-शैली परीक्षण केवल nginx पथ का उपयोग करता है।
7. वर्कफ़्लो आरेख
स्विम लेन अलग-अलग चिंताएँ हैं: ग्राहक समीक्षा, निगलना, एआई निष्कर्षण और वर्गीकरण, नियतात्मक कर इंजन, HMRC OAuth और फाइलिंग, और ऑडिट (JWT, एन्क्रिप्टेड NINO, लॉग)। निर्णय मैट्रिक्स समय, सटीकता, ऑडिट ट्रेल, लागत, एचएमआरसी अनुपालन और मानव निरीक्षण पर मैन्युअल स्प्रेडशीट और अकाउंटेंट-केवल तैयारी के खिलाफ FileMyTax AI-सहायता प्रवाह की तुलना करता है।
8. वित्तीय विश्लेषण के लिए एआई - लाभ
| फायदा | एआई क्या प्रदान करता है | मानवीय भूमिका |
|---|---|---|
| गति | मिनटों में वर्गीकृत सैकड़ों पंक्तियाँ | उच्च-मूल्य वाली पंक्तियों की स्पॉट-चेक करें |
| संगति | प्रत्येक लेनदेन पर समान नियम लागू होते हैं | किनारे के मामलों को कारण के साथ ओवरराइड करें |
| विसंगति का पता लगाना | झंडे बेमेल, विषम पैटर्न को संतुलित करते हैं | चिह्नित वस्तुओं की जांच करें |
| पैमाने पर वर्गीकरण | एचएमआरसी एसए व्यय श्रेणियों के लिए मानचित्र | अस्पष्ट विवरण की पुष्टि करें |
| ऑडिट ट्रेल | प्रसंस्करण स्थिति + प्रति पंक्ति आत्मविश्वास | एकाउंटेंट के लिए निर्यात |
| गोपनीयता | स्थानीय डॉकर स्टैक; कोई तृतीय-पक्ष SaaS किरायेदार नहीं | एपीआई कुंजी और अवधारण को नियंत्रित करें |
| अकाउंटेंट तैयारी का समय | ड्राफ्ट रिटर्न + मिलान किया गया खाता | फ़ाइल से पहले व्यावसायिक साइन-ऑफ़ |
8बी. ढेर और सेवाएँ (तकनीकी विवरण)
FileMyTax के पीछे एक डॉकर कंपोज़ स्टैक है जो ऑर्केस्ट्रेटेड है ./start.sh, जो स्थानीय, LAN, परीक्षण, स्टेजिंग या उत्पादन मोड में चल सकता है। बैकएंड PostgreSQL पर SQLModel के साथ FastAPI का उपयोग करता है; एपीआई कंटेनरों में शून्य स्थानीय डिस्क भंडारण के साथ मिनिआईओ में अपलोड की गई पीडीएफ भूमि। फ्रंटएंड Next.js के साथ है NEXT_PUBLIC_* वेरिएबल को निर्माण के समय रूट से बेक किया जाता है .env.
प्रमाणीकरण जानबूझकर विभाजित किया गया है. opsapi (लुआ लैपिस) जेडब्ल्यूटी एक्सेस टोकन और अपारदर्शी रिफ्रेश टोकन जारी करता है (वेब के लिए केवल सुरक्षित कुकीज़, मोबाइल के लिए JSON बॉडी)। फास्टएपीआई इसे सत्यापित करता है JWT_SECRET_KEY. सेवाओं में स्टोरेजसर्विस, पीडीएफप्रोसेसरसर्विस, एलएलएमएससर्विस, क्लासिफिकेशनसर्विस, रीकंसीलिएशनसर्विस, टैक्सकैलकुलेटरसर्विस और एचएमआरसीक्लाइंट शामिल हैं - प्रत्येक की एक संकीर्ण सीमा है ताकि एआई विफलताएं कर अंकगणित को दूषित न करें।
समर्थित बैंक पार्सर सामान्य यूके लेआउट (एचएसबीसी, बार्कलेज, लॉयड्स, सैंटेंडर और समान टेबल पीडीएफ) को लक्षित करते हैं। पार्सर दिनांक, विवरण, डेबिट/क्रेडिट या राशि और संतुलन कॉलम का लचीले ढंग से पता लगाता है - जो गलत कॉलम चुने जाने तक शक्तिशाली है; नीचे सीमाएँ देखें।
9. एचएमआरसी टैक्स को डिजिटल बना रहा है
एमटीडी सेल्फ असेसमेंट के लिए उपयोगकर्ता-अधिकृत OAuth की आवश्यकता होती है - अकेले NINO पर्याप्त नहीं है। विशिष्ट प्रवाह:
- NINO सहेजें —
POST /opsapi/api/v2/tax/profile/nino(बाकी में एन्क्रिप्टेड, प्रतिक्रियाओं में छिपा हुआ)। - एचएमआरसी कनेक्ट करें —
GET /opsapi/auth/hmrc/initiateरिटर्नauth_url; उपयोगकर्ता सरकारी गेटवे के माध्यम से साइन इन करता है; कॉलबैक सर्वर-साइड संग्रहीत टोकन के लिए कोड का आदान-प्रदान करता है। - व्यवसाय लाएँ —
POST /fastapi/api/hmrc/businesses/fetchकैश ट्रेडिंग नाम और आईडी। - दायित्व प्राप्त करें —
POST /fastapi/api/hmrc/obligations/fetchत्रैमासिक अवधियों और देय तिथियों के लिए। - फ़ाइल —
POST /fastapi/api/fileसमीक्षा के बाद.
सेट HMRC_ENVIRONMENT=sandbox विकास के लिए; पर स्विच करें production तैयार होने पर बिना कोड परिवर्तन के। बैकएंड अनिवार्य धोखाधड़ी रोकथाम हेडर भेजता है; ग्राहकों को स्थिर प्रदान करना चाहिए X-Device-ID और सटीक User-Agent मूल्य. सैंडबॉक्स परीक्षण उपयोगकर्ता इसके माध्यम से बनाए जा सकते हैं POST /fastapi/api/hmrc/sandbox/create-test-user जब सैंडबॉक्स मोड सक्षम हो।
एचएमआरसी एक्सेस टोकन लगभग चार घंटे के बाद समाप्त हो जाते हैं; बैकएंड रिफ्रेश का प्रबंधन करता है - मोबाइल और वेब क्लाइंट OAuth रीडायरेक्ट से परे ब्राउज़र में रहस्यों को एम्बेड करने के बजाय opsapi-संग्रहीत टोकन का उपयोग करते हैं।
9.1 NINO सहेजें और प्रोफ़ाइल जांचें
curl -X POST http://localhost/opsapi/api/v2/tax/profile/nino \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "nino": "QQ123456C" }'
curl -H "Authorization: Bearer $TOKEN" \
http://localhost/opsapi/api/v2/tax/profile
प्रतिक्रियाएँ NINO को छुपाती हैं (****456C) पुष्टि करते हुए hmrc_connected और OAuth के बाद टोकन की समाप्ति।
9.2 OAuth आरंभ करें
curl -H "Authorization: Bearer $TOKEN" \
"http://localhost/opsapi/auth/hmrc/initiate?source=settings"
खुला auth_url सिस्टम ब्राउज़र या ASWebAuthenticationSession में - क्रेडेंशियल-भरा हुआ WebView नहीं। मोबाइल ऐप्स को डीप लिंक या यूनिवर्सल लिंक के रूप में पंजीकृत करना चाहिए HMRC_REDIRECT_URI.
9.3 व्यवसाय और दायित्व
curl -X POST http://localhost/fastapi/api/hmrc/businesses/fetch \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
curl -X POST http://localhost/fastapi/api/hmrc/obligations/fetch \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "business_id": "XAIS12345678910" }'
बाद में कैश्ड रीड प्रत्येक पेज लोड पर एचएमआरसी से टकराने से बचें: GET /fastapi/api/hmrc/businesses और GET /fastapi/api/hmrc/obligations?tax_year=2024-25.
9.4 डिस्कनेक्ट और स्थिति
curl -X DELETE http://localhost/opsapi/auth/hmrc/disconnect \
-H "Authorization: Bearer $TOKEN"
curl -H "Authorization: Bearer $TOKEN" \
http://localhost/fastapi/api/hmrc/status
8सी. वित्तीय विश्लेषण के लिए एआई - गहन दृष्टिकोण
सारांश तालिका के अलावा, बिल्ड-बनाम-खरीद का मूल्यांकन करने वाली फिनऑप्स टीमों के लिए तीन पैटर्न मायने रखते हैं।
सबसे पहले, थ्रूपुट. दो किराये के खातों में बारह महीने के लेन-देन वाला एकमात्र व्यापारी एक्सेल पिवट टेबल में एक दिन बिता सकता है; FileMyTax पाइपलाइन कॉफ़ी बनाने में लगने वाले समय में अर्क + वर्गीकृत + सामंजस्य पूरा करती है, जिससे निर्णय के लिए मानव घंटे निकल जाते हैं। यह बदलाव अकाउंटेंट अर्थशास्त्र को डेटा प्रविष्टि से सलाहकार तक ले जाता है - बिल योग्य मूल्य अकाउंटेंट वैसे भी पसंद करते हैं।
दूसरा, व्याख्यात्मकता. प्रत्येक वर्गीकरण में एक आत्मविश्वास स्कोर होता है और इसे लेन-देन के साथ संग्रहीत कारण से ओवरराइड किया जा सकता है। यह संपूर्ण चेन-ऑफ-थॉट ऑडिट लॉग से कमजोर है, लेकिन ब्लैक-बॉक्स SaaS निर्यात से अधिक मजबूत है जहां आप यह नहीं देख सकते कि पंक्ति 417 की "मरम्मत" क्यों की गई।
तीसरा, लागत वक्र. स्थानीय स्तर पर चल रहा है, प्रति रिटर्न सीमांत लागत वर्गीकरण प्लस बिजली के लिए एपीआई टोकन है - इकाई गणना के साथ प्रति सीट सास शुल्क स्केलिंग नहीं। कई बयानों वाले पोर्टफोलियो जमींदारों या वित्त संचालन टीमों के लिए, वह वक्र मायने रखता है। अग्रिम इंजीनियरिंग लागत वास्तविक है; कॉग्नोएआई ने हर साल प्रत्येक उपयोगकर्ता पर स्प्रेडशीट श्रम को आगे बढ़ाने के बजाय वर्कस्टेशन डिलीवरी के माध्यम से इसे अवशोषित किया।
गोपनीयता-संवेदनशील संगठन इस बात का भी ध्यान रखते हैं कि पीडीएफ और पोस्टग्रेज पंक्तियाँ एचएमआरसी फाइलिंग तक उनके डॉकर नेटवर्क के अंदर रहें - डेमो आर्किटेक्चर में कोई बहु-किरायेदार क्लाउड अंतर्ग्रहण चरण नहीं है। उत्पादन सख्त करने के लिए अभी भी बैकअप, अभिगम नियंत्रण और DPIA दस्तावेज़ीकरण की आवश्यकता होती है; लेख यह नहीं दर्शाता कि जीडीपीआर अनुपालन स्वचालित है क्योंकि स्टैक स्थानीय है।
10. डेमो वीडियो
एंड-टू-एंड FileMyTax प्रदर्शन: वर्गीकरण और गणना के माध्यम से HMRC MTD सैंडबॉक्स फाइलिंग के माध्यम से बैंक पीडीएफ, यूआई में दिखाए गए समीक्षा गेट्स के साथ।
11. पाश में मानव
एआई स्कैन किए गए कॉलम को गलत तरीके से पढ़ सकता है, आय के साथ हस्तांतरण को भ्रमित कर सकता है, या विवरण अस्पष्ट होने पर गलत व्यय श्रेणी निर्दिष्ट कर सकता है। यूआई को समीक्षा के लिए डिज़ाइन किया गया है: कैप्चर किए गए कारणों के साथ लेनदेन को स्वीकार करना, ओवरराइड करना या विभाजित करना। कर गणना नियतात्मक और परीक्षण योग्य है; एलएलएम कभी भी देय कर की गणना नहीं करता है।
अकाउंटेंट साइन-ऑफ़ किसी भी लाइव एचएमआरसी से पहले सबमिशन अनिवार्य है। यह लेख है कर सलाह नहीं. FileMyTax CognoAI के लिए इंजीनियरिंग क्षमता प्रदर्शित करता है; भत्ते, संपत्ति आय विभाजन, साझेदारी और अन्य एसए अनुसूचियों पर आपकी परिस्थितियाँ भिन्न हो सकती हैं।
11बी. गैटस के साथ निगरानी
शामिल गैटस डैशबोर्ड (http://localhost:8085 डिफ़ॉल्ट रूप से) nginx, FastAPI के माध्यम से फ्रंटएंड को पोल करता है /fastapi/health, ऑप्सैपी /opsapi/health?detailed=true, स्वैगर रीचैबिलिटी, और बाईपास डायग्नोस्टिक्स के लिए सीधे कंटेनर पोर्ट। प्रति जांच अंतराल 10-30 सेकंड है। किसी सेवा को जोड़ने का अर्थ है संपादन करना monitoring/gatus/config.yaml और गैटस कंटेनर को फिर से शुरू करना - वास्तविक वित्तीय डेटा के लिए पाइपलाइन पर भरोसा करने से पहले एक छोटी लेकिन महत्वपूर्ण ऑप्स आदत।
स्वास्थ्य जांच एंड-टू-एंड परीक्षणों का विकल्प नहीं है: रेपो रनिंग स्टैक के विरुद्ध प्लेराइट E2E और बैकएंड पर पाइटेस्ट का भी समर्थन करता है। एक हरा गैटस बोर्ड और एक असफल सामंजस्य अभी भी एक असफल दिन है।
12. सीमाएँ
- पीडीएफ निष्कर्षण: पीडीएफप्लंबर टेबल लेआउट मानता है; एचएसबीसी-शैली के बयानों ने हमें शेष राशि बनाम भुगतान किए गए कॉलम को स्पष्ट रूप से मान्य करना सिखाया - गलत कॉलम मैपिंग चुपचाप सुलह को भ्रष्ट कर देती है।
- ओसीआर: स्कैन किए गए बयान क्लाउड विजन पर निर्भर करते हैं; ख़राब स्कैन को मानवीय सुधार की आवश्यकता है।
- एलएलएम रेलिंग: कम-आत्मविश्वास वाले वर्गीकरणों को स्वतः फ़ाइल नहीं किया जाना चाहिए; अनुमान लगाने के बजाय प्रदाता की विफलता पर डिफ़ॉल्ट को अवर्गीकृत किया गया।
- नियतात्मक पृथक्करण: टैक्स बैंड और एनआई दरें रहती हैं
tax_calculator.pyदशमलव परिशुद्धता के साथ - कभी भी प्रॉम्प्ट-इंजीनियर नहीं किया गया। - अनुपालन का दायरा: जीडीपीआर, डेटा संरक्षण अधिनियम 2018 और एचएमआरसी नियम लागू होते हैं; उत्पादन को डेव डॉकर कंपोज़ से परे बैकअप, रहस्य प्रबंधन और निगरानी की आवश्यकता होती है।
- जेडब्ल्यूटी संरेखण: FastAPI और opsapi को अवश्य साझा करना चाहिए
JWT_SECRET_KEY; अपारदर्शी 401 हस्ताक्षर त्रुटियों के रूप में बेमेल सतहों - यदि पुन: तैनाती के बाद प्रमाणीकरण अचानक टूट जाता है तो दोनों कंटेनरों की जांच करें। - स्टार्टअप पर प्रदाता लॉक-इन:
LLM_PROVIDERक्रॉस-फ़ेलओवर के बिना ओपनाई या एंथ्रोपिक है; यदि किसी प्रदाता के पास आउटेज है तो रखरखाव विंडो की योजना बनाएं।
जमींदार परिदृश्यों का परीक्षण करते समय, सुलह डेल्टा को प्रथम श्रेणी के संकेतों के रूप में मानें, उपद्रवों के रूप में नहीं। £12k बेमेल का मतलब अक्सर कॉलम गलत-मैपिंग होता है, शरारती किरायेदार नहीं। निष्कर्षण नियमों को ठीक करना और निष्क्रिय पाइपलाइन को फिर से चलाना सैकड़ों पंक्तियों को हाथ से ओवरराइड करने से सस्ता है।
12बी. इसकी तुलना पैकेज्ड टैक्स सॉफ्टवेयर से कैसे की जाती है
फ्रीएजेंट, ज़ीरो टैक्स और इसी तरह के उपकरण अधिकांश उपयोगकर्ताओं के लिए सही डिफ़ॉल्ट हैं: प्रमाणित एमटीडी कनेक्टर, सपोर्ट डेस्क और पहले से प्रशिक्षित अकाउंटेंट। FileMyTax-शैली प्लेटफ़ॉर्म तब समझ में आता है जब आपको कस्टम वर्गीकरण नियमों, ऑन-प्रिमाइसेस या VPC परिनियोजन, मौजूदा opsapi पहचान विमान के साथ एकीकरण, या ऊर्ध्वाधर वर्कफ़्लो के प्रकाशन की आवश्यकता होती है (जैसा कि CognoAI AI-सहायता प्राप्त लेखांकन के लिए करता है)। वर्कफ़्लो एसवीजी में निर्णय मैट्रिक्स जानबूझकर ईमानदार है: स्प्रेडशीट धीमी और त्रुटि-प्रवण हैं; केवल अकाउंटेंट सुरक्षित है लेकिन बार-बार तैयारी करना महंगा है; एआई-सहायता प्राप्त स्थानीय पाइपलाइनें ऑडिटेबिलिटी और सीमांत लागत पर तभी जीतती हैं जब आप इंजीनियरिंग में निवेश करते हैं और फिर भी पेशेवर साइन-ऑफ के लिए भुगतान करते हैं।
13. FileMyTax/CognoAI के लिए आगे क्या है?
प्लेटफ़ॉर्म डॉक्स में दिखाई देने वाले रोडमैप आइटम में गहन एमटीडी आईटीएसए पूर्वावलोकन-गणना राउंड-ट्रिप, अकाउंटेंट सुधारों से विस्तारित आरएजी-शैली प्रशिक्षण डेटा, सास तैनाती के लिए मल्टी-टेनेंट ऑथ कुकी डोमेन और सख्त मोबाइल ओएथ प्रवाह शामिल हैं। कॉग्नोएआई की ओर से वर्कस्टेशन इंजीनियरिंग जारी रखता है; उत्पाद दिशा और आईपी CognoAI के पास रहता है।
इंजीनियरिंग पाठकों को अपस्ट्रीम रेपो में तीन एकीकरण दस्तावेज़ देखने चाहिए: एचएमआरसी एमटीडी इंटीग्रेशन (पूर्वावलोकन गणना के लिए चरण ए-डी), साझा प्रमाणीकरण (जेडब्ल्यूटी + रिफ्रेश रोटेशन), और एआई प्रशिक्षण डेटा पाइपलाइन (पीजीवेक्टर एम्बेडिंग प्लस अकाउंटेंट सुधारों के मिनिओ मार्कडाउन निर्यात)। साथ में वे दिखाते हैं कि कैसे आज की डेमो पाइपलाइन एक सीखने की प्रणाली बन जाती है - जब पेशेवर कर कैलकुलेटर को फिर से प्रशिक्षित किए बिना गलतियों को ठीक करते हैं तो वर्गीकरण में सुधार होता है।
ऑपरेटरों के लिए, उत्पादन परिनियोजन का अर्थ है ENVIRONMENT=production, nginx के सामने HTTPS समाप्ति, डेटाबेस बैकअप, फ्लैट के बाहर रहस्य .env फ़ाइलें, और गैटस हरी बत्तियों से परे चेतावनी। इनमें से कोई भी मूल कहानी को कम नहीं करता है: एआई स्प्रेडशीट घर्षण को दूर करता है; नियतात्मक कोड कर कानून रखता है; मनुष्य जवाबदेही बनाए रखते हैं।
13बी. अक्सर पूछे जाने वाले प्रश्न
क्या FileMyTax मेरे अकाउंटेंट की जगह लेता है? नहीं, यह तैयारी के श्रम को कम करता है; अकाउंटेंट अभी भी उपचार, राहत और अन्य आय स्रोतों को बैंक पीडीएफ पर मान्य नहीं करते हैं।
क्या मैं इसे फ़ोन पर चला सकता हूँ? LAN मोड आपके वाई-फाई आईपी पर CORS और API URL को फिर से लिखता है ताकि आप उसी नेटवर्क पर फोन पर Next.js UI का परीक्षण कर सकें - डेमो के लिए उपयोगी, कठोर मोबाइल रिलीज़ इंजीनियरिंग का विकल्प नहीं।
यदि एलएलएम बंद हो जाए तो क्या होगा? वर्गीकरण शून्य आत्मविश्वास के साथ अवर्गीकृत पंक्तियाँ लौटाता है; पाइपलाइन चुपचाप प्रदाताओं को स्विच नहीं करती है। आप प्रदाता कॉन्फ़िगरेशन को ठीक करें या प्रतीक्षा करें - मानव समीक्षा मौजूद होने का एक और कारण है।
क्या यहां DIY टैक्स रिटर्न का उल्लेख किया गया है? नहीं, यह नाम अलग CognoAI उत्पाद ब्रांडिंग को संदर्भित करता है। यह आलेख प्रकाशन नियमों के अनुसार केवल FileMyTax का उपयोग करता है।
13सी. 2025-26 गणना स्नैपशॉट
एचएमआरसी मार्गदर्शन के विरुद्ध नियतात्मक इंजन की पुष्टि करने वाले पाठकों के लिए, कैलकुलेटर में शामिल 2025/26 मापदंडों में शामिल हैं: व्यक्तिगत भत्ता £12,570 £100,000 से ऊपर की आय के प्रत्येक £2 के लिए £1 कम करना; £12,571 और £50,270 के बीच मूल दर 20%; उच्च दर 40% £125,140 तक; अतिरिक्त दर उससे 45% अधिक; कक्षा 4 एनआई £12,571 और £50,270 के बीच लाभ पर 8% और इससे ऊपर 2%। व्यय श्रेणियां एचएमआरसी स्व-रोज़गार बक्सों से संरेखित होती हैं - कॉस्टऑफ गुड्स, परिसर रनिंग कॉस्ट, ट्रैवल कॉस्ट, प्रोफेशनल फीस, और बाकी प्लेटफॉर्म रीडमी में सूचीबद्ध हैं। इंजन वर्गीकृत कुल उपभोग करता है; यह प्राकृतिक भाषा विवरणों की पुनर्व्याख्या नहीं करता है। वह सीमा वह है जो स्वचालित फाइलिंग को रक्षात्मक बनाती है: एलएलएम लेबल प्रस्तावित करता है; कैलकुलेटर क़ानून लागू करता है.
14. निष्कर्ष
क्या एआई सिस्टम यूके सेल्फ असेसमेंट रिटर्न को एचएमआरसी में स्वचालित रूप से संसाधित और दाखिल कर सकता है? यह लगभग सभी तैयारियों को स्वचालित कर सकता है और एक-क्लिक फ़ाइल एपीआई को उजागर कर सकता है - लेकिन जिम्मेदार उपयोग के लिए मानव समीक्षा, अकाउंटेंट साइन-ऑफ़, सैंडबॉक्स परीक्षण और करदाता OAuth की आवश्यकता होती है। FileMyTax दिखाता है कि यह व्यवहार में कैसा दिखता है: छह एपीआई, स्पष्ट वास्तुकला, एआई जहां पैटर्न पहचान जीतती है, और नियतात्मक कोड जहां कानून को सटीकता की आवश्यकता होती है।
देखो यूट्यूब पर डेमो, यात्रा कॉग्नोएआई उत्पाद संदर्भ के लिए, और वर्कस्टेशन से संपर्क करें यदि आपको अपने स्टैक पर फिनऑप्स इंजीनियरिंग की इस श्रेणी की आवश्यकता है।
इस आलेख के लिए SEO स्नैपशॉट
- एसईओ शीर्षक: क्या एआई एचएमआरसी को स्व-मूल्यांकन दाखिल कर सकता है? | फ़ाइलमाईटैक्स
- मेटा विवरण: FileMyTax डेमो: AI बैंक पीडीएफ निकालता है, SA लेनदेन को वर्गीकृत करता है, 2025-26 कर की गणना करता है, HMRC MTD के माध्यम से फ़ाइलें - मानव समीक्षा के साथ। CognoAI के लिए वर्कस्टेशन द्वारा निर्मित।
- प्राथमिक कीवर्ड: एआई सेल्फ असेसमेंट, फाइलमाईटैक्स, एचएमआरसी एमटीडी, स्वचालित टैक्स फाइलिंग, बैंक स्टेटमेंट एआई, कॉग्नोएआई, वर्कस्टेशन
- ट्विटर/एक्स (280 अक्षरों से कम): क्या एआई एचएमआरसी को यूके सेल्फ असेसमेंट दाखिल कर सकता है? FileMyTax डेमो: बैंक पीडीएफ → वर्गीकृत → गणना → एमटीडी, पहले मानव गेट + सैंडबॉक्स के साथ। @CognoAI के लिए वर्कस्टेशन द्वारा निर्मित। वीडियो + 4k-शब्द लेखन। कर सलाह नहीं. #HMRC #MTD #AI #FileMyTax
- लिंक्डइन पोस्ट: हमने प्रकाशित किया कि कैसे FileMyTax - CognoAI के लिए वर्कस्टेशन द्वारा विकसित - AI निष्कर्षण, HMRC श्रेणी वर्गीकरण, नियतात्मक 2025-26 कर गणना और MTD फाइलिंग के माध्यम से एन्क्रिप्टेड NINO स्टोरेज, OAuth और जमा करने से पहले एक कठिन मानव अनुमोदन गेट के माध्यम से एक मकान मालिक या एकमात्र-व्यापारी बैंक पीडीएफ लेता है। लंबे लेख में छह-एपीआई पाइपलाइन, आर्किटेक्चर एसवीजी, धोखाधड़ी रोकथाम हेडर और ईमानदार सीमाएं (पीडीएफप्लंबर कॉलम ट्रैप, एलएलएम कॉन्फिडेंस रेलिंग) शामिल हैं। नया डेमो वीडियो देखें; किसी भी लाइव फ़ाइल से पहले एक अकाउंटेंट से हस्ताक्षर करवाएं। कर सलाह नहीं.
अस्वीकरण: जहां संदर्भित काल्पनिक बैंक डेटा; FileMyTax एक प्रदर्शन नाम है; कर सलाह नहीं; लाइव एचएमआरसी सबमिशन से पहले अकाउंटेंट की समीक्षा आवश्यक है।

