3 Commits

Author	SHA1	Message	Date
agent-company	39501f39bc	[Phase 5] docs-site: add VIN Decoder Redoc page and SEO blog post ... - Add docs-site/src/pages/vin-decoder.astro: Redoc reference page rendering /specs/vin-decoder.yaml (matches pattern of existing API pages) - Copy apis/vin-decoder/openapi.yaml to docs-site/public/specs/vin-decoder.yaml so Redoc can serve the spec - Add VIN Decoder card to index.astro hero grid (4th API) - Add docs-site/src/pages/blog/vin-decoder.mdx: 1,500+ word SEO blog post 'How to Decode a VIN Number with Node.js Using Free NHTSA Data' with meta description, working code examples, VIN structure explanation, NHTSA vPIC background, and use-case context - npm run build exits 0; /vin-decoder and /blog/vin-decoder routes present Closes leeworks-agents/api-company#123 Closes leeworks-agents/api-company#124	2026-05-30 15:06:32 +00:00
agent-company	cb4c0649f5	feat(docs-site): add legal pages (ToS, Privacy Policy, AUP) and footer links ... Add three Astro markdown pages under docs-site/src/pages/legal/: - terms-of-service.md -> /legal/terms-of-service - privacy-policy.md -> /legal/privacy-policy - acceptable-use-policy.md -> /legal/acceptable-use-policy All three use the Base.astro layout and render the legal content from docs/legal/ (synced verbatim). The Base.astro layout already had legal footer links added previously; this commit also adds a footer section directly in index.astro for redundancy. The ToS URL (https://docs.leeworks.dev/legal/terms-of-service) is now ready to be pasted into the RapidAPI listing (issue #44). Closes leeworks-agents/api-company#89	2026-05-29 05:05:13 +00:00
agent-company	a615b7ebfd	feat: implement docs-site, legal docs, metrics standard, flux manifests ... Closes leeworks-agents/api-company#5 (docs-site Astro scaffold) Closes leeworks-agents/api-company#9 (metrics instrumentation standard) Closes leeworks-agents/api-company#10 (Gitea Actions openapi aggregation pipeline) Closes leeworks-agents/api-company#11 (docs-site Flux HelmRelease) Closes leeworks-agents/api-company#12 (SEO blog posts x3) Closes leeworks-agents/api-company#13 (legal docs ToS/Privacy/AUP) Closes leeworks-agents/api-company#14 (DNS documentation) ## Changes ### docs/legal/ - terms-of-service.md — API usage, liability, account termination, governing law - privacy-policy.md — request log retention (90d), no PII sold, data sharing - acceptable-use-policy.md — rate limit abuse, scraping prohibition, resale ban ### docs/metrics-standard.md - Defines api_requests_total, api_response_duration_seconds, api_data_freshness_seconds - Fastify (TypeScript) and FastAPI (Python) reference middleware implementations - Prometheus scrape config and Grafana dashboard guidance ### docs/registry.md - Decision: use Gitea built-in container registry (no new infra) - Image naming convention, auth, Kubernetes imagePullSecrets, ingress config ### docs/dns.md - Required A records for all 6 subdomains - cert-manager ClusterIssuer and Ingress TLS examples - Verification commands and human-operator action items ### docs-site/ - Astro 4 + MDX + sitemap scaffold - Base layout with nav linking all APIs, blog, RapidAPI, status - Landing page with API cards - Per-API Redoc viewer pages (zip-enrichment, holidays, air-quality) - Blog index + 3 SEO blog posts (~1000 words each with JSON-LD) - Dockerfile (multi-stage: node build + nginx serve) - nginx.conf with gzip, caching, health endpoint ### flux/ - gitea-runner/: gitea-act-runner HelmRelease (org-scope, dind) - monitoring/: kube-prometheus-stack + Gatus HelmReleases - Prometheus with pod annotation scraping - Grafana at grafana.leeworks.dev with persistence - Gatus status page at status.leeworks.dev, 90-day retention - docs-site/: Deployment + Service + Ingress via raw chart - api-company-source/: GitRepository + Kustomization reference manifests - kustomization.yaml: root kustomize entry point (build validated) ### .gitea/workflows/build-docs.yaml - Aggregates openapi.yaml from zip-enrichment, holidays, air-quality repos - Builds Astro docs-site - Pushes image to registry.leeworks.dev/leeworks-agents/docs-site - Triggered on push to main, schedule daily 02:00 UTC, workflow_dispatch	2026-05-24 23:20:33 +00:00