Spesifikasi Teknis

Stack Aplikasi

Area	Teknologi	Peran
Runtime	Next.js 16.2.11	App Router, server rendering, route handling, dan metadata.
UI	React 19.2.1	Komponen halaman dan interaksi client.
Dokumentasi	Fumadocs 16.12.1	Loader content, sidebar, search, dan layout dokumentasi.
Authoring	MDX dan TypeScript	Materi dengan Markdown yang dapat memakai komponen React.
Styling	Tailwind CSS 4	Styling layout, navigation, dan komponen UI.
Validation	`fumadocs-mdx`, Next typegen, TypeScript	Validasi content, route type, dan kontrak kode.

Struktur Folder

eduverse/
├── app/                    # route dan layout Next.js
│   ├── (home)/             # homepage, navbar, dan course catalog
│   └── (mdx)/              # renderer halaman content Fumadocs
├── content/                # source learner-facing dalam MDX
│   ├── docs/               # dokumentasi project ini
│   ├── frameworks/         # materi framework
│   ├── knowledge/          # materi pengetahuan dan course
│   └── tools/              # materi tools
├── .agents/                # governance, source, dan course context
├── components/             # komponen UI dan MDX
├── lib/source.ts           # Fumadocs loader dengan clean route
├── public/                 # aset statis
└── scripts/                # validator dan utilitas project

Kontrak Content

content/<root>/index.mdx membuat route /<root>.
content/<root>/<section>/index.mdx membuat route /<root>/<section>.
meta.json mengatur judul, urutan, dan sidebar; meta.json tidak membuat halaman tanpa file MDX.
baseUrl Fumadocs adalah string kosong, sehingga route tidak memakai prefix /docs kecuali root content memang bernama docs.
Internal link harus menunjuk ke route bersih yang benar-benar memiliki file sumber.

Perintah Pengembangan

pnpm dev
pnpm run types:check
pnpm run agents:check
pnpm build
pnpm exec fumadocs-mdx
pnpm run export:pdf -- /docs/fitur-belajar /knowledge/rekayasa-perangkat-lunak/pertemuan-1

types:check meregenerasi source MDX, route type, lalu menjalankan TypeScript check. Jalankan setelah perubahan struktur atau isi content.

export:pdf menggunakan Puppeteer untuk mencetak route yang sudah dirender menjadi PDF. Route diberikan sebagai argumen setelah --; hasilnya disimpan di folder pdfs/.

Endpoint Pendukung Belajar Dan AI

Endpoint	Fungsi
`/api/search`	Menyediakan hasil search Fumadocs untuk menemukan materi.
`/<route>.mdx`	Menyediakan isi Markdown halaman untuk `Copy Markdown` dan konteks AI.
`/llms.mdx/<route>`	Mengembalikan satu halaman dalam format Markdown yang mudah dibaca mesin.
`/llms-full.txt`	Menggabungkan seluruh halaman menjadi satu sumber teks untuk workflow AI atau indexing.

Tombol Open pada halaman mengarahkan konteks Markdown ke layanan AI eksternal seperti Scira AI, ChatGPT, Claude, dan T3 Chat. Project tidak memiliki chat AI internal; integrasinya menggunakan URL dan endpoint Markdown yang tersedia.