Commit Graph

5 Commits

Author SHA1 Message Date
agent-company 5fc5013a51 feat: update pricing page to include VIN Decoder as 4th API (#141)
Validate Flux manifests / kustomize-build (pull_request) Failing after 8s
- Update meta description to include VIN Decoder
- Change hero text from 'all three APIs' to 'all four APIs'
- Add VIN Decoder column to the pricing table with same 4-tier rates
- Add link to /vin-decoder docs page in the CTA row

npm run build exits 0; /pricing route builds successfully.

Closes leeworks-agents/api-company#141
2026-05-31 05:06:26 +00:00
agent-company 39501f39bc [Phase 5] docs-site: add VIN Decoder Redoc page and SEO blog post
Validate Flux manifests / kustomize-build (pull_request) Failing after 21s
- 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 411ee92106 [Phase 5] docs-site: add /pricing cross-API comparison page and nav link
Validate Flux manifests / kustomize-build (pull_request) Failing after 23s
Closes leeworks-agents/api-company#101

- Create docs-site/src/pages/pricing.astro with accessible table markup
  showing all 4 tiers (Free/Basic/Pro/Ultra) for all 3 APIs
- Add <caption> and scope attributes for accessibility
- Responsive overflow-x wrapper for mobile
- CTA buttons linking to RapidAPI (placeholder # until listings live)
- Revenue disclaimer: subscriptions managed via RapidAPI marketplace
- Add /pricing link to nav in Base.astro layout
- npm run build passes with no errors
2026-05-29 20:03:29 +00:00
agent-company cb4c0649f5 feat(docs-site): add legal pages (ToS, Privacy Policy, AUP) and footer links
Validate Flux manifests / kustomize-build (pull_request) Failing after 20s
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