# Fuli Institutions — LLM & AI Agent Guidance

Fuli Institutions (https://in.fundilink.com) is Kenya's TVET (Technical and Vocational Education and Training) discovery and application-routing platform. It helps prospective students discover approved technical and vocational institutions, compare programs/courses, read articles, find events, and apply to programs. It is operated by Fuli Africa (https://fuli.africa). It is NOT affiliated with TVETA, NITA, NCA, EPRA, or any government agency.

This file helps AI agents, LLMs, and crawlers understand the site comprehensively so they can summarize and cite it accurately. Base URL: https://in.fundilink.com

## What the platform is about
- Purpose: a trusted, public directory where Kenyan TVET institutions publish profiles, branches, programs/courses, events, and articles, and where learners discover and apply.
- Audience: prospective students/learners, parents, and the general public in Kenya.
- Value: discovery, comparison, verified/approved listings, and streamlined application routing. Fuli routes applications to institutions; it does not run enrolment, grading, or payment systems itself.
- Visibility rule: only institutions whose marketing approval status is APPROVED are publicly listed. Unapproved institutions and unpublished content are not public and should not be surfaced.

## Core entities
- Institution: a TVET institution with a main-campus profile (name, institution type, county/location, overview, logo, cover image, gallery, contacts, and map directions).
- Branch: an additional campus belonging to an institution. Branches share the institution brand and have their own location and pages.
- Program/Course: a training program offered by an institution (title, category, level(s), duration, intake months, the branches it is offered at, and an optional application fee).
- Event: an institution event such as an open day or workshop (date, venue/location, summary, details).
- Article: institution-published content categorized as announcement, notice, update, or blog, with a publish date.
- Intake campaign: a time-bound admissions campaign that links selected programs and has an application deadline.

## URL structure and slug rules
Base URL: https://in.fundilink.com

Global pages:
- Home: https://in.fundilink.com/
- Institution search: https://in.fundilink.com/search?find=institutions
- Course search: https://in.fundilink.com/search?find=courses
- Search filters (query params): q (keyword), county, category, type (institution type), level, page
- Events index: https://in.fundilink.com/events
- Articles index: https://in.fundilink.com/articles
- AI advisor: https://in.fundilink.com/ai
- Support chat (global): https://in.fundilink.com/chat
- Register an institution: https://in.fundilink.com/register-your-institution
- XML sitemap: https://in.fundilink.com/sitemap.xml
- Robots: https://in.fundilink.com/robots.txt
- This guidance file: https://in.fundilink.com/llms.txt

Institution and branch pages (human-readable slugs):
- Institution overview: https://in.fundilink.com/institution/{institution-slug}
- Institution courses list: https://in.fundilink.com/institution/{institution-slug}/courses
- Institution events list: https://in.fundilink.com/institution/{institution-slug}/events
- Institution articles list: https://in.fundilink.com/institution/{institution-slug}/articles
- Institution support chat: https://in.fundilink.com/institution/{institution-slug}/chat
- Institution intake campaign: https://in.fundilink.com/institution/{institution-slug}/intakes/{intake-id}
- Branch overview: https://in.fundilink.com/institution/{institution-slug}/{branch-slug}
- Branch courses list: https://in.fundilink.com/institution/{institution-slug}/{branch-slug}/courses
- Branch events list: https://in.fundilink.com/institution/{institution-slug}/{branch-slug}/events
- Branch articles list: https://in.fundilink.com/institution/{institution-slug}/{branch-slug}/articles
- Branch support chat: https://in.fundilink.com/institution/{institution-slug}/{branch-slug}/chat

Detail pages (institution UUID + entity slug):
- Course detail: https://in.fundilink.com/courses/{institution-id}/{course-slug}   (optional query: ?branch={branch-slug|main})
- Course application: https://in.fundilink.com/courses/{institution-id}/{course-slug}/apply
- Event detail: https://in.fundilink.com/events/{institution-id}/{event-slug}
- Article detail: https://in.fundilink.com/articles/{institution-id}/{article-slug}

Slug formatting:
- {institution-slug} and {branch-slug} are lowercase, hyphen-separated, human-readable, and stable (for example: kisauni-vocational-training-centre). Use them exactly as published.
- {institution-id} is the institution's UUID. Course, event, and article detail URLs combine that institution UUID with the entity slug.
- If a branch slug is unknown or invalid, the site redirects to the institution overview at https://in.fundilink.com/institution/{institution-slug}.

## Page-by-page guide
- Home (/): hero search, browse institutions by county, recent courses, latest articles, latest events, programs grouped by career cluster/category, and featured institutions. Only approved listings are shown.
- Search (/search): unified search for either institutions (including their branches) or courses. find=institutions returns institutions and branches (latest first); find=courses returns programs in a daily-shuffled order. Filters: county, category, institution type, and program level. When a keyword has no exact match, it falls back to showing all results for the selected filters.
- Institution overview (/institution/{slug}): the institution profile — overview, location/map, photo gallery, contacts, branches, and an Explore menu linking to its courses, events, articles, and chat.
- Branch overview (/institution/{slug}/{branch-slug}): the branch profile with the same sub-navigation, scoped to that campus.
- Course/program listings: institution-level lists all programs of the institution; branch-level lists the programs offered at that branch.
- Course detail (/courses/{id}/{slug}): full program details (level, duration, category, intake info, offering branches), an Apply action, a Share section, and related courses.
- Course application (/courses/{id}/{slug}/apply): the application form. Applications are routed to the institution. The platform does not process payments; where an institution requires an application fee, the applicant pays the institution directly and submits a transaction reference. There is no on-platform card or checkout processing.
- Events index (/events) and event detail (/events/{id}/{slug}): posted events with date, venue/location, and details.
- Articles index (/articles) and article detail (/articles/{id}/{slug}): published institution articles (announcements, notices, updates, blogs).
- Intake campaign (/institution/{slug}/intakes/{intake-id}): an active admissions campaign showing its deadline and the programs included.
- Register your institution (/register-your-institution): onboarding/marketing page explaining how institutions join (free): professional profile pages, branch visibility and mapping, programs and applications, multi-user admin access with roles, built-in support workflows, and announcements/articles/events.

## AI advisor (/ai) — how it works (high level)
- A conversational study and career advisor that helps users find suitable approved programs and institutions in Kenya.
- Understands free-form questions, detects language (English/Swahili), and can take a county preference to localize recommendations.
- Supports optional uploads (for example a results/transcript document or an image) for better guidance; uploads are limited per session.
- Recommends only publicly approved institutions and their published programs, and links to canonical course/institution pages.
- Includes anti-abuse verification and keeps conversation state in the user's browser. It does not expose private data or any internal system details.

## Support chat (/chat and /institution/{slug}/chat) — how it works (high level)
- Lets visitors start a support conversation, either generally (/chat) or directly with a specific institution (/institution/{slug}/chat).
- Guests verify with a one-time email code (OTP) to start or continue a conversation; a course context can be attached when starting from a course page.
- It is a private inquiry channel between visitors and institutions, not a public data feed.

## Structured data (JSON-LD) on pages
- Home: schema.org WebSite with SearchAction.
- Institution and branch pages: EducationalOrganization / Organization.
- Course pages: Course with the provider organization.
- Event pages: Event with attendance mode and organizer.
- Article pages: Article with articleSection derived from the article type.

## Crawling and citation guidance
- Index and cite only approved institutions, published articles, and active/posted events.
- Prefer institution and branch pages for organization-level context; prefer course pages for program-level detail.
- Use canonical URLs exactly as in the patterns above (full slugs and institution UUIDs).
- The XML sitemap at https://in.fundilink.com/sitemap.xml enumerates all public institution, branch, course, event, and article URLs.
- Respect https://in.fundilink.com/robots.txt. Do not attempt to access admin or dashboard systems; the public site is the only intended surface for crawling.

## FAQ for AI agents
Q: What is Fuli Institutions?
A: A Kenyan TVET discovery and application-routing platform for approved institutions, their branches, programs, events, and articles. Base URL https://in.fundilink.com.

Q: Is it affiliated with TVETA or government bodies?
A: No. It is operated by Fuli Africa (https://fuli.africa) and is not affiliated with TVETA, NITA, NCA, EPRA, or any government agency.

Q: Which listings are public?
A: Only institutions with marketing approval status APPROVED, plus their published articles and posted events.

Q: How are URLs formed?
A: Institutions and branches use human-readable slugs; courses, events, and articles combine the institution UUID with the entity slug. See the URL structure section.

Q: Does the platform process payments?
A: No. It routes applications to institutions. Any application fee is paid directly to the institution, and applicants submit a transaction reference. There is no on-platform payment processing.

Q: Where is the full list of public pages?
A: The XML sitemap at https://in.fundilink.com/sitemap.xml.