Memulai dengan LensCore

Selamat datang di LensCore! Panduan ini akan membantu Anda memulai dengan platform testing aksesibilitas dan web crawling kami.

Apa itu LensCore?

LensCore adalah platform open-source yang menggabungkan:

• Testing Aksesibilitas dengan axe-core
• Web Crawling Cerdas menggunakan Playwright
• Analisis Berbasis AI dengan OpenAI (opsional)
• Pelaporan Komprehensif dalam format HTML dan JSON

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

• Node.js >= 20.0.0
• Docker (untuk deployment dalam container)
• npm atau yarn package manager
• OpenAI API Key (opsional, untuk fitur AI)

Instalasi

Instalasi Global

Install LensCore secara global via npm:

npm install -g @accesstime/lenscore

Atau menggunakan yarn:

yarn global add @accesstime/lenscore

Verifikasi Instalasi

Cek apakah LensCore terinstall dengan benar:

lens-core --version

Konfigurasi

Setup Awal

Jalankan wizard setup untuk konfigurasi LensCore:

lens-core setup --port 3001

Ini akan:

• Membuat file konfigurasi di ~/.lenscore/config.json
• Setup environment Docker
• Konfigurasi port API
• Opsional setup integrasi OpenAI

Konfigurasi Manual

Anda juga bisa manual edit file konfigurasi:

{
  "mode": "local",
  "docker": {
    "image": "lenscore:latest",
    "port": 3001
  },
  "remote": {
    "baseUrl": "http://localhost:3001"
  },
  "openai": {
    "apiKey": "",
    "model": "gpt-3.5-turbo",
    "enabled": false
  },
  "project": {
    "framework": "",
    "cssFramework": "",
    "language": "",
    "buildTool": ""
  }
}

Environment Variables

Anda juga bisa konfigurasi LensCore menggunakan environment variables:

• LENSCORE_PORT: Port API server (default: 3001)
• OPENAI_API_KEY: API key OpenAI Anda
• CACHE_TYPE: Tipe cache (memory|redis|none)
• CACHE_TTL: Time-to-live cache dalam detik
• CACHE_MAX_SIZE: Ukuran maksimum cache

Mulai Cepat

1. Setup Awal

Jalankan wizard setup interaktif untuk konfigurasi LensCore untuk proyek Anda:

lens-core setup

Ini akan memandu Anda melalui:

• Membuat lenscore.config.json
• Konfigurasi aturan test aksesibilitas
• Setup fitur AI (opsional)
• Memilih strategi cache
• Metadata proyek

Contoh dengan custom port:

lens-core setup --port 8080

Ini memungkinkan Anda menentukan port custom untuk API server.

2. Build dan Start Services

Setelah setup, build dan start services:

lens-core build

Perintah ini akan:

• Build Docker image
• Start services dalam container
• Initialize API server

3. Cek Status Service

lens-core status

Anda akan melihat:

✓ Docker daemon is running
✓ Container lenscore is running
✓ API is healthy

4. Test Satu Halaman

Jalankan test aksesibilitas pertama Anda:

lens-core test https://example.com

Ini akan:

• Load webpage
• Jalankan test aksesibilitas
• Generate laporan
• Output hasil ke console

5. Test dengan Analisis AI

Aktifkan rekomendasi berbasis AI:

lens-core test https://example.com --enable-ai

6. Generate Laporan HTML

Buat laporan HTML visual:

lens-core test https://example.com --web

Laporan akan disimpan ke direktori web/output/.

Contoh Penggunaan Dasar

Test Beberapa Halaman

lens-core test-multiple \
  https://example.com \
  https://example.com/about \
  https://example.com/contact

Crawl Website

Temukan dan list semua halaman di website:

lens-core crawl https://example.com --max-urls 50

Scan Website Lengkap

Crawl dan test seluruh website:

lens-core scan https://example.com \
  --max-urls 50 \
  --max-depth 3 \
  --enable-ai \
  --web

Menggunakan API

LensCore menyediakan RESTful API yang bisa digunakan dari HTTP client mana pun.

Start API Server

lens-core up

Test Halaman via API

curl -X POST http://localhost:3001/api/test \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "enableAI": false
  }'

Cek Kesehatan API

curl http://localhost:3001/api/health

Struktur Project

Struktur Runtime (dibuat saat menjalankan LensCore):

~/.lenscore/
├── config.json          # File konfigurasi
├── logs/                # Log aplikasi
│   ├── combined.log
│   └── error.log
├── cache/               # Direktori cache
└── web/                 # Web templates (disalin dari package)
    └── output/          # Laporan HTML yang di-generate

Opsi Konfigurasi

Konfigurasi Docker

# Set port kustom
lens-core config --set "docker.port=3002"

# Cek konfigurasi saat ini
lens-core config --list

Konfigurasi OpenAI

# Set API key
lens-core config --set "openai.apiKey=sk-..."

# Aktifkan fitur AI
lens-core config --set "openai.enabled=true"

# Set model
lens-core config --set "openai.model=gpt-4"

Konteks Project

Set konteks project untuk rekomendasi AI yang lebih baik:

lens-core config --set "project.framework=react"
lens-core config --set "project.cssFramework=tailwind"

Troubleshooting

Docker Tidak Berjalan

Jika melihat "Docker daemon is not running":

# Start Docker Desktop (macOS/Windows)
# Atau start Docker service (Linux)
sudo systemctl start docker

Port Sudah Digunakan

Jika port 3001 sudah digunakan:

lens-core setup --port 3002

Masalah Permission

Jika mengalami error permission:

# Linux/macOS
sudo chown -R $USER ~/.lenscore

# Cek permissions
ls -la ~/.lenscore/

Masalah Cache

Clear cache jika mengalami masalah:

# Via API
curl -X DELETE http://localhost:3001/api/cache/clear

# Atau restart services
lens-core down
lens-core up

Langkah Selanjutnya

Sekarang Anda sudah setup LensCore, Anda bisa:

• Jelajahi Perintah CLI - Pelajari semua perintah dan opsi yang tersedia
• Baca Dokumentasi API - Integrasikan LensCore ke aplikasi Anda
• Pelajari Tentang Aksesibilitas - Pahami panduan WCAG
• Kontribusi ke LensCore - Bantu tingkatkan project

Mendapatkan Bantuan

Jika butuh bantuan:

• Cek GitHub Issues kami
• Baca dokumentasi CLI
• Review referensi API
• Bergabung dengan diskusi komunitas kami

Update

Jaga LensCore tetap up to date:

# Cek update
npm outdated -g @accesstime/lenscore

# Update ke versi terbaru
npm update -g @accesstime/lenscore

---

Siap untuk mendalami lebih lanjut? Lihat Dokumentasi CLI untuk referensi perintah yang komprehensif!