System Architecture
TurkGateway operates on a specialized multi-agent architecture. Instead of relying on a single monolithic LLM, user requests are intercepted and routed to strictly scoped agents.
Micro-Agent Deployment
Three distinct agents (Permit, Student, Legal) operate independently. Each is initialized with a specific system prompt containing distinct operational schemas and state management rules.
Stateful Workflows
Conversations are not stateless. The backend maintains a `PermitState` and `ConversationState` object, tracking entities like `city`, `business_type`, and `nace_code` across turns.
Smart Router & Context Engine
The Smart Router is the core orchestrator. It intercepts all user input before it reaches the LLM, applying zero-latency local intent classification and context augmentation.
Keyword Heuristics
Fuzzy regex matching determines if the query is a greeting, smalltalk, or a domain-specific intent (e.g., `permit.restaurant`).
Contextual Augmentation
If the query is a short follow-up (e.g., "yes", "Dubai"), the Context Engine injects state variables (`visa`, `consulate`) to resolve ambiguity locally without an LLM call.
Localized Prompt Caching
For standard procedures, the Router retrieves localized JSON payloads (English, Turkish, Arabic) to ensure structural consistency in roadmaps.
Business Agent Architecture
The Business Agent is a high-precision system specialized in commercial real estate, business formation, and municipal licensing. It handles the complex licensing process across Istanbul's 39 districts.
NACE Sector Intelligence
The agent utilizes a semantic mapping engine to translate natural language business descriptions into official NACE codes. This inference is critical because the required permit type is directly derived from the NACE classification.
Licensing Workflow Pipeline
Physical Infrastructure Check
Validation of ceiling heights, emergency exits, and handicap access according to 2026 Istanbul Building Codes. The agent scans uploaded floor plans for compliance.
İtfaiye (Fire) Safety Protocol
Automatic generation of the Fire Department application roadmap based on floor area and fuel types used. Includes direct links to municipal payment portals.
Municipal Submission
Compilation of the "Ruhsat Başvuru Dosyası" with district-specific forms injected via the Local API Engine. The agent verifies signature requirements for each form.
Student Agent Architecture
The Student Agent is architected for international scholars navigating the Turkish Higher Education system. It provides end-to-end support for university registration and residency.
Residency Automation
The agent simulates connectivity with the "e-İkamet" system to generate precise document bundles. It differentiates between First Application, Extension, and Transfer.
- Biometric Photo Specs Validation
- Student Certificate QR Check
Insurance & GSS Engine
International students must maintain valid health insurance. The agent cross-references policy dates with residency appointment windows to ensure zero coverage gaps.
Legal Agent & RAG Engine
The Legal Agent serves as an enterprise-grade compliance monitor. It utilizes a Retrieval-Augmented Generation (RAG) pipeline to query a high-density vector database.
Vector-Indexed Law Repository
When a complex legal query is processed, the system performs a multi-stage retrieval. It embeds the query using a customized encoder and searches through thousands of chunks from the "Resmi Gazete" (Official Gazette).
Contract Analysis (OCR)
Proprietary OCR layers extract key entities (Parties, Dates, Penal Clauses) and flag non-compliant terms against standard Turkish Commercial Law.
KVKK Compliance
The agent monitors the Personal Data Protection Authority (KVKK) board decisions, ensuring your data registries are correctly mapped to localization laws.
Terms of Service
1. Acceptance of Terms
By creating an account or using TurkGateway AI, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service and our Privacy Policy.
- If using the Service on behalf of a company, you represent the authority to bind such entity.
- Minors under 18 may not use the Service without verifiable parental consent.
- Continued use after any Terms update constitutes acceptance of the revised terms.
2. AI Disclaimer
TurkGateway utilizes advanced LLMs and RAG pipelines to provide information about Turkish laws and municipal protocols. This does NOT constitute professional legal advice, financial advice, or an official government determination.
3. User Responsibilities
Users must provide accurate, up-to-date information. You may not use the service for activities illegal under Turkish law, reverse-engineer our Agentic workflows, or automate interactions beyond our provided RPA features.
4. Subscriptions & Payments
Premium features are billed via iyzico (PCI-DSS Level 1). Subscriptions auto-renew monthly unless cancelled before the renewal date. Fees are non-refundable except as required by Turkish Consumer Protection Law (No. 6502).
5. Limitation of Liability
TurkGateway shall not be liable for any indirect, incidental, or consequential damages from administrative delays, visa rejections, permit denials, government portal downtime, or regulatory changes. Our total liability shall not exceed fees paid in the preceding 3 months.
6. Intellectual Property
All platform content — including AI model logic, Smart Router, workflow schemas, UI design, and documentation — is the exclusive intellectual property of TurkGateway. You retain ownership of your personal data, uploaded documents, and exported roadmaps.
7. Termination
You may terminate your account via Settings → Account → Delete Account. TurkGateway reserves the right to suspend accounts that violate these Terms, engage in fraudulent behavior, or attempt to circumvent payment obligations.
8. Governing Law
These Terms are governed by the laws of the Republic of Turkey. Any disputes fall under the exclusive jurisdiction of the Istanbul Courts. Before legal proceedings, please contact support@turkgateway.ai.
Privacy Policy
KVKK Compliance
TurkGateway AI is fully compliant with the Personal Data Protection Law (KVKK) No. 6698. We act as a data processor for administrative queries and implement strict technical measures to prevent unauthorized access.
Data Collection
We collect only the minimum data required to facilitate your bureaucratic applications. This includes account information and the specific entities provided during chat sessions (e.g., location, business type).
Document Data
Any documents uploaded for review (e.g., floor plans, certificates) are processed in real-time and are not used for model training or permanent storage without explicit user consent.
Third-Party Sharing
We do not sell your personal data. We only share anonymized analytical data with infrastructure providers to maintain platform uptime and performance.
Data Storage
Data is stored on encrypted servers within the European Economic Area (EEA) and Türkiye, ensuring high compliance with both local and international privacy standards.
Your Rights
Under KVKK, you have the right to access, correct, or request the deletion of your personal data at any time. You can exercise these rights via your account settings or by contacting our support team.
Data Retention
We retain data only as long as necessary to provide our services or as required by law. Inactive accounts and associated session data are purged after 24 months of inactivity.
Policy Updates
This policy may be updated to reflect changes in legal requirements or platform features. Users will be notified of significant changes via email or dashboard alerts.
Resource Center
A curated list of official Turkish government portals, databases, and application systems. These are the primary sources our Agents use to verify requirements and roadmaps.
e-Devlet Gateway
The central digital platform for all Turkish government services. Used for downloading criminal records, residency proofs, SGK details, and tax debt status.
Göç İdaresi (e-Ikamet)
The official portal of the Presidency of Migration Management for foreigners. Used for applying for new residence permits, renewals, and extensions.
T.C. Resmî Gazete
The Official Gazette of the Republic of Turkey. The absolute source of truth for new laws, presidential decrees, regulations, and public appointments.
MERSİS (Ministry of Trade)
Central Registration System for businesses. Required for establishing new companies (LLC, Joint Stock), managing trade registries, and updating company bylaws.