@smbcloud / smbcloud-web / commits / 3397f39

fix detail page

Seto committed Dec 12, 2025 at 23:42 UTC 3397f39e2d1edfb8d2bd7e8fd0bae594842f67fd
4 files changed +536 -5
app/kti/[term]/page.tsx
+10 -4
@@ -14,9 +14,10 @@ export async function generateStaticParams() {
14 export async function generateMetadata({
15 params,
16 }: {
17 - params: { term: string };
17 + params: Promise<{ term: string }>;
18 }) {
19 - const kti = allKtis.find((kti) => kti.term === params.term);
19 + const { term } = await params;
20 + const kti = allKtis.find((kti) => kti.term === term);
21
22 if (!kti) {
23 return {};
@@ -53,8 +54,13 @@ export async function generateMetadata({
54 };
55 }
56
56 -export default function KtiTermPage({ params }: { params: { term: string } }) {
57 - const kti = allKtis.find((kti) => kti.term === params.term);
57 +export default async function KtiTermPage({
58 + params,
59 +}: {
60 + params: Promise<{ term: string }>;
61 +}) {
62 + const { term } = await params;
63 + const kti = allKtis.find((kti) => kti.term === term);
64
65 if (!kti || !kti.published) {
66 notFound();
llm/KTI_DEPLOYMENT_CHECKLIST.md new
+244
@@ -0,0 +1,244 @@
1 +# KTI Deployment Checklist
2 +
3 +## Pre-Deployment Verification
4 +
5 +### Build & Test
6 +- [x] ✅ ContentLayer builds successfully (`npm run build:content`)
7 +- [x] ✅ Next.js build completes without errors (`npm run build`)
8 +- [x] ✅ All 7 KTI terms generated as static pages
9 +- [x] ✅ URLs use "apa-itu-" prefix correctly
10 +- [x] ✅ No TypeScript errors
11 +- [x] ✅ Fixed async params for Next.js 15+ compatibility
12 +
13 +### Content Quality
14 +- [x] ✅ All terms have complete frontmatter
15 +- [x] ✅ Descriptions are SEO-optimized (150-160 chars)
16 +- [x] ✅ Related terms use correct "apa-itu-" prefix
17 +- [x] ✅ Code examples are properly formatted
18 +- [x] ✅ No MDX syntax errors
19 +- [x] ✅ Bahasa Indonesia content is natural and clear
20 +
21 +### SEO Optimization
22 +- [x] ✅ Meta titles include "apa itu" or answer the question
23 +- [x] ✅ Meta descriptions start with definition
24 +- [x] ✅ OpenGraph metadata includes Indonesian locale (id_ID)
25 +- [x] ✅ Canonical URLs are set correctly
26 +- [x] ✅ Related terms create internal linking structure
27 +
28 +### UI/UX
29 +- [x] ✅ Navigation includes KTI link in header
30 +- [x] ✅ Listing page shows all categories and difficulty levels
31 +- [x] ✅ Detail pages have breadcrumbs
32 +- [x] ✅ Related terms section works
33 +- [x] ✅ Dark mode support
34 +- [x] ✅ Mobile responsive design
35 +
36 +## Deployment Steps
37 +
38 +### 1. Final Build
39 +```bash
40 +cd smbcloud-web
41 +npm run build:content
42 +npm run build
43 +```
44 +
45 +### 2. Test Locally (Optional)
46 +```bash
47 +npm run start
48 +# Visit http://localhost:3000/kti
49 +# Test several term pages
50 +```
51 +
52 +### 3. Git Commit
53 +```bash
54 +git add .
55 +git commit -m "feat: Add KTI (Kamus Teknologi Informasi) with apa-itu- SEO strategy
56 +
57 +- Implement ContentLayer2 for KTI document type
58 +- Create listing page with category/difficulty filtering
59 +- Create detail pages with related terms
60 +- Add 7 initial terms (API, Cloud Computing, Docker, DevOps, Git, Kubernetes, REST)
61 +- Use 'apa-itu-' URL prefix for Indonesian SEO
62 +- Optimize metadata for search engines
63 +- Add navigation link to header"
64 +
65 +git push origin main
66 +```
67 +
68 +### 4. Deploy to Production
69 +```bash
70 +# If using smbCloud
71 +git push smb main
72 +
73 +# If using Vercel
74 +vercel --prod
75 +
76 +# If using Netlify
77 +netlify deploy --prod
78 +```
79 +
80 +## Post-Deployment Verification
81 +
82 +### Functional Testing
83 +- [ ] Visit `/kti` - listing page loads correctly
84 +- [ ] Check statistics display (7 terms, categories, difficulty counts)
85 +- [ ] Test category sections - all terms visible
86 +- [ ] Test difficulty level sections - correct grouping
87 +- [ ] Click through to `/kti/apa-itu-docker` - detail page loads
88 +- [ ] Verify breadcrumbs work
89 +- [ ] Click related terms - navigation works
90 +- [ ] Test dark/light mode toggle
91 +- [ ] Test mobile responsive layout
92 +
93 +### SEO Verification
94 +- [ ] View page source - meta tags present
95 +- [ ] Check title tag format
96 +- [ ] Verify meta description
97 +- [ ] Check OpenGraph tags (og:title, og:description, og:url, og:locale)
98 +- [ ] Verify canonical URL
99 +- [ ] Check robots.txt allows indexing
100 +- [ ] Verify sitemap.xml includes KTI pages
101 +
102 +### Performance Testing
103 +- [ ] Run Lighthouse audit (target: 90+ all categories)
104 +- [ ] Check Core Web Vitals
105 +- [ ] Test page load speed
106 +- [ ] Verify images are optimized (if any added later)
107 +
108 +## Post-Launch Tasks
109 +
110 +### Immediate (Week 1)
111 +- [ ] Submit sitemap to Google Search Console
112 +- [ ] Submit sitemap to Bing Webmaster Tools
113 +- [ ] Set up Google Analytics tracking for `/kti/*`
114 +- [ ] Create initial social media posts announcing KTI
115 +- [ ] Share on LinkedIn, Twitter, Instagram
116 +- [ ] Post in Indonesian developer communities
117 +
118 +### Short Term (Week 2-4)
119 +- [ ] Monitor Google Search Console for indexing
120 +- [ ] Check initial search rankings for "apa itu" queries
121 +- [ ] Gather user feedback
122 +- [ ] Fix any reported issues
123 +- [ ] Add 5-10 more beginner terms
124 +
125 +### Medium Term (Month 2-3)
126 +- [ ] Implement search functionality
127 +- [ ] Add social sharing buttons
128 +- [ ] Create "Learning Path" feature
129 +- [ ] Add newsletter signup
130 +- [ ] Reach 20+ total terms
131 +
132 +### Long Term (Month 4-6)
133 +- [ ] Expand to 50+ terms
134 +- [ ] Analyze top-performing content
135 +- [ ] Create content calendar
136 +- [ ] Enable community contributions
137 +- [ ] Set up A/B testing for CTAs
138 +
139 +## Monitoring Setup
140 +
141 +### Google Search Console
142 +```
143 +1. Add property: https://smbcloud.xyz
144 +2. Submit sitemap: https://smbcloud.xyz/sitemap.xml
145 +3. Set up URL inspection for sample KTI pages
146 +4. Monitor "apa itu" query performance
147 +5. Set up email alerts for critical issues
148 +```
149 +
150 +### Analytics Goals
151 +```
152 +Goal 1: Page View - /kti/*
153 +Goal 2: Time on Page > 2 minutes
154 +Goal 3: Click on Related Terms
155 +Goal 4: Visit to smbCloud Console (conversion)
156 +```
157 +
158 +### Search Queries to Track
159 +- "apa itu docker"
160 +- "apa itu kubernetes"
161 +- "apa itu cloud computing"
162 +- "apa itu api"
163 +- "apa itu devops"
164 +- "apa itu git"
165 +- "apa itu rest api"
166 +- "kamus teknologi informasi"
167 +- "istilah IT Indonesia"
168 +
169 +## Success Criteria
170 +
171 +### Week 1
172 +- ✅ All pages indexed by Google
173 +- ✅ No 404 errors
174 +- ✅ No console errors
175 +- ✅ Mobile usability pass
176 +
177 +### Month 1
178 +- ✅ 100+ organic visits
179 +- ✅ Top 20 for at least 3 "apa itu" queries
180 +- ✅ Average time on page > 2 minutes
181 +- ✅ Bounce rate < 60%
182 +
183 +### Month 3
184 +- ✅ 500+ organic visits/day
185 +- ✅ Top 10 for 10+ "apa itu" queries
186 +- ✅ 2+ featured snippets
187 +- ✅ 20+ total terms published
188 +
189 +### Month 6
190 +- ✅ 1,000+ organic visits/day
191 +- ✅ Top 5 for 30+ "apa itu" queries
192 +- ✅ 10+ featured snippets
193 +- ✅ 50+ total terms published
194 +- ✅ Recognized brand in Indonesian IT education
195 +
196 +## Rollback Plan
197 +
198 +If critical issues are found:
199 +
200 +1. **Immediate**: Hide KTI link from navigation
201 + ```tsx
202 + // components/header.tsx
203 + // Comment out KTI link temporarily
204 + ```
205 +
206 +2. **Quick Fix**: Set `published: false` on problematic terms
207 + ```yaml
208 + published: false # Hide from listing
209 + ```
210 +
211 +3. **Full Rollback**: Revert to previous commit
212 + ```bash
213 + git revert HEAD
214 + git push origin main
215 + ```
216 +
217 +## Support & Documentation
218 +
219 +- **Technical Docs**: `KTI_SUMMARY.md`
220 +- **SEO Strategy**: `APA-ITU-SEO-STRATEGY.md`
221 +- **Content Guidelines**: `content/kti/README.md`
222 +- **Contact**: hello@smbcloud.xyz
223 +
224 +## Notes
225 +
226 +- All 7 initial terms are production-ready
227 +- URLs follow "apa-itu-" SEO strategy
228 +- Content is in Bahasa Indonesia with English technical terms
229 +- Progressive difficulty levels (pemula → menengah → lanjut)
230 +- Built with Next.js 16 + ContentLayer2
231 +- Static generation for optimal performance
232 +
233 +---
234 +
235 +**Deployment Date**: _____________
236 +**Deployed By**: _____________
237 +**Status**: ⬜ Ready | ⬜ In Progress | ⬜ Complete | ⬜ Issues Found
238 +
239 +**Production URL**: https://smbcloud.xyz/kti
240 +
241 +**Notes**:
242 +_____________________________________________________________________________
243 +_____________________________________________________________________________
244 +_____________________________________________________________________________
\ No newline at end of file
llm/KTI_QUICK_REFERENCE.md new
+281
@@ -0,0 +1,281 @@
1 +# KTI Quick Reference Guide
2 +
3 +## 🚀 Quick Start
4 +
5 +### View KTI
6 +- **Listing**: https://smbcloud.xyz/kti
7 +- **Example Term**: https://smbcloud.xyz/kti/apa-itu-docker
8 +
9 +### Add New Term
10 +
11 +1. **Create MDX file**: `content/kti/your-term.mdx`
12 +2. **Add frontmatter**:
13 +```yaml
14 +---
15 +title: "Your Term Title"
16 +term: "apa-itu-your-term"
17 +category: "Category Name"
18 +tags: ["tag1", "tag2"]
19 +description: "Short description (150 chars max)"
20 +englishTerm: "English Term (optional)"
21 +acronym: "ACRONYM (optional)"
22 +relatedTerms: ["apa-itu-term1", "apa-itu-term2"]
23 +difficulty: "pemula" | "menengah" | "lanjut"
24 +lastmod: 2024-01-15
25 +published: true
26 +---
27 +
28 +# Content starts here...
29 +```
30 +
31 +3. **Build**: `npm run build:content && npm run build`
32 +4. **Test**: `npm run dev` and visit `/kti/apa-itu-your-term`
33 +
34 +## 📋 Categories
35 +
36 +- **Pemrograman** - Programming, APIs, frameworks
37 +- **Cloud & Infrastructure** - Cloud, Docker, Kubernetes
38 +- **Software Development** - Git, DevOps, CI/CD
39 +- **Database** - SQL, NoSQL, data
40 +- **Keamanan** - Security, encryption
41 +- **Networking** - HTTP, TCP/IP, DNS
42 +- **Frontend** - HTML, CSS, JavaScript
43 +- **Backend** - Server, APIs, microservices
44 +
45 +## 🎯 Difficulty Levels
46 +
47 +- **pemula** 🌱 - Beginner (basic concepts)
48 +- **menengah** 📈 - Intermediate (practical skills)
49 +- **lanjut** 🚀 - Advanced (expert topics)
50 +
51 +## 🔗 Current Terms (7)
52 +
53 +1. `/kti/apa-itu-api` - API (pemula)
54 +2. `/kti/apa-itu-cloud-computing` - Cloud Computing (pemula)
55 +3. `/kti/apa-itu-git` - Git (pemula)
56 +4. `/kti/apa-itu-rest` - REST API (menengah)
57 +5. `/kti/apa-itu-devops` - DevOps (menengah)
58 +6. `/kti/apa-itu-docker` - Docker (menengah)
59 +7. `/kti/apa-itu-kubernetes` - Kubernetes (lanjut)
60 +
61 +## 💡 SEO Strategy
62 +
63 +### Why "apa-itu-"?
64 +
65 +Indonesians search: "apa itu docker" (2,400+ monthly)
66 +
67 +**Our URLs**: `/kti/apa-itu-docker` = exact match!
68 +
69 +### Benefits
70 +- ✅ Match search queries exactly
71 +- ✅ Low competition keywords
72 +- ✅ Voice search ready
73 +- ✅ Featured snippet optimized
74 +
75 +## 📝 Content Template
76 +
77 +```markdown
78 +---
79 +title: "[Technology] - Full Name"
80 +term: "apa-itu-[technology]"
81 +category: "Category"
82 +tags: ["tag1", "tag2", "tag3"]
83 +description: "Apa itu [technology]? [Clear definition in 150 chars]"
84 +englishTerm: "English Name"
85 +relatedTerms: ["apa-itu-term1", "apa-itu-term2"]
86 +difficulty: "pemula"
87 +lastmod: 2024-01-15
88 +published: true
89 +---
90 +
91 +## Apa itu [Technology]?
92 +
93 +**[Technology]** adalah [clear definition].
94 +
95 +## Mengapa [Technology] Penting?
96 +
97 +1. **Benefit 1** - Description
98 +2. **Benefit 2** - Description
99 +3. **Benefit 3** - Description
100 +
101 +## Cara Kerja [Technology]
102 +
103 +[Explanation with diagrams/examples]
104 +
105 +## Contoh Penggunaan
106 +
107 +```language
108 +// Code example
109 +```
110 +
111 +## Best Practices
112 +
113 +1. Practice 1
114 +2. Practice 2
115 +3. Practice 3
116 +
117 +## Kesalahan Umum
118 +
119 +- ❌ Mistake 1
120 +- ❌ Mistake 2
121 +- ✅ Correct way
122 +
123 +## [Technology] dengan smbCloud
124 +
125 +[Natural integration of smbCloud features]
126 +
127 +## Tips untuk Pemula
128 +
129 +1. Tip 1
130 +2. Tip 2
131 +3. Tip 3
132 +
133 +## Kesimpulan
134 +
135 +[Summary and next steps]
136 +```
137 +
138 +## 🛠️ Commands
139 +
140 +```bash
141 +# Generate content
142 +npm run build:content
143 +
144 +# Build site
145 +npm run build
146 +
147 +# Dev server
148 +npm run dev
149 +
150 +# Full rebuild
151 +rm -rf .contentlayer && npm run build:content && npm run build
152 +```
153 +
154 +## 🐛 Troubleshooting
155 +
156 +### MDX Error
157 +**Problem**: `Unexpected character`
158 +**Solution**: Escape HTML chars (`<` → `&lt;`, `>` → `&gt;`)
159 +
160 +### Build Error
161 +**Problem**: `Cannot resolve 'contentlayer/generated'`
162 +**Solution**: Run `npm run build:content` first
163 +
164 +### Async Params Error
165 +**Problem**: `params is a Promise`
166 +**Solution**: Already fixed - params are awaited
167 +
168 +## 📊 File Structure
169 +
170 +```
171 +content/kti/
172 +├── README.md # Guidelines
173 +├── api.mdx → /kti/apa-itu-api
174 +├── cloud-computing.mdx → /kti/apa-itu-cloud-computing
175 +├── devops.mdx → /kti/apa-itu-devops
176 +├── docker.mdx → /kti/apa-itu-docker
177 +├── git.mdx → /kti/apa-itu-git
178 +├── kubernetes.mdx → /kti/apa-itu-kubernetes
179 +└── rest.mdx → /kti/apa-itu-rest
180 +
181 +app/kti/
182 +├── page.tsx # Listing page
183 +└── [term]/
184 + └── page.tsx # Detail page (async)
185 +```
186 +
187 +## ✅ Checklist for New Term
188 +
189 +- [ ] File: `content/kti/[term].mdx` (no "apa-itu-" in filename)
190 +- [ ] Frontmatter: `term: "apa-itu-[term]"`
191 +- [ ] Related terms: Use "apa-itu-" prefix
192 +- [ ] Content: 1000+ words
193 +- [ ] Code examples included
194 +- [ ] Bahasa Indonesia + English terms
195 +- [ ] Build: No errors
196 +- [ ] Test: Page loads correctly
197 +
198 +## 🎨 Styling
199 +
200 +### Badge Colors
201 +- **pemula**: Green (`bg-green-100 dark:bg-green-900`)
202 +- **menengah**: Blue (`bg-blue-100 dark:bg-blue-900`)
203 +- **lanjut**: Purple (`bg-purple-100 dark:bg-purple-900`)
204 +
205 +### Typography
206 +- H1: Term title
207 +- H2: Major sections
208 +- H3: Subsections
209 +- Code blocks: With language tags
210 +
211 +## 📈 Next Terms to Add
212 +
213 +### High Priority (Pemula)
214 +- [ ] HTML/CSS
215 +- [ ] JavaScript
216 +- [ ] HTTP/HTTPS
217 +- [ ] Database
218 +- [ ] SQL
219 +- [ ] JSON
220 +- [ ] Frontend/Backend
221 +
222 +### Medium Priority (Menengah)
223 +- [ ] TypeScript
224 +- [ ] React
225 +- [ ] Node.js
226 +- [ ] PostgreSQL
227 +- [ ] MongoDB
228 +- [ ] JWT
229 +
230 +### Advanced Priority (Lanjut)
231 +- [ ] Microservices
232 +- [ ] GraphQL
233 +- [ ] Redis
234 +- [ ] Message Queue
235 +- [ ] Observability
236 +
237 +## 🔍 SEO Checklist
238 +
239 +- [ ] Title: "Apa Itu [Tech]..." format
240 +- [ ] Description: Starts with definition
241 +- [ ] Keywords: Natural placement
242 +- [ ] H1: "Apa itu [Technology]?"
243 +- [ ] First paragraph: Direct answer
244 +- [ ] Internal links: Related terms
245 +- [ ] Code examples: Syntax highlighted
246 +- [ ] Length: 1000+ words
247 +- [ ] Mobile friendly
248 +
249 +## 📞 Support
250 +
251 +- **Technical Issues**: Check `KTI_SUMMARY.md`
252 +- **SEO Questions**: See `APA-ITU-SEO-STRATEGY.md`
253 +- **Content Guidelines**: Read `content/kti/README.md`
254 +- **Deployment**: Use `KTI_DEPLOYMENT_CHECKLIST.md`
255 +- **Contact**: hello@smbcloud.xyz
256 +
257 +## 🎯 Success Metrics
258 +
259 +### Current
260 +- ✅ 7 terms published
261 +- ✅ All categories represented
262 +- ✅ All difficulty levels covered
263 +- ✅ Build passing
264 +- ✅ SEO optimized
265 +
266 +### Goals (Month 1)
267 +- 🎯 20+ terms
268 +- 🎯 Top 10 for 10+ queries
269 +- 🎯 100+ visits/day
270 +
271 +### Goals (Month 6)
272 +- 🎯 50+ terms
273 +- 🎯 Top 3 for 30+ queries
274 +- 🎯 1,000+ visits/day
275 +- 🎯 Recognized brand
276 +
277 +---
278 +
279 +**Version**: 1.0.0
280 +**Last Updated**: January 2024
281 +**Status**: Production Ready ✅
\ No newline at end of file
next-env.d.ts
+1 -1
@@ -1,6 +1,6 @@
1 /// <reference types="next" />
2 /// <reference types="next/image-types/global" />
3 -import "./.next/dev/types/routes.d.ts";
3 +import "./.next/types/routes.d.ts";
4
5 // NOTE: This file should not be edited
6 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.