AndreaWeb documentation index¶
Use this page to find the authoritative document for each kind of decision. Avoid copying detailed procedures into several documents; link to the owner instead.
Start here¶
- Andrea's first redesign — the design direction, bilingual architecture, review iterations and data-preserving production release.
- Architecture and operations overview — current production topology, versions, containers, data ownership, queues, resources, security, deployments, commands, and known gaps.
- Roadmap — phased delivery status and future priorities.
- Local WSL operations — starting, stopping, verifying, troubleshooting, and sharing the local stack.
- OVH deployment and cutover — production deployment runbook.
- Read-only production host audit — host, container, storage, rotation, backup-age, and release-pointer checks.
- GitLab Pages snapshot export — architecture and export
procedure for the live
docs.andreazambrano.codocumentation site.
Andrea redesign¶
The dedicated redesign topic is the narrative entry point. Its stage-by-stage links preserve the original implementation records without mistaking intermediate local previews for the current deployment.
- Visual review — height-aware landing tiles, footer behavior and related-product alignment.
- Product photos and variants — gallery controls, Medusa data flow, variant selection and deliberate future work.
- Production cutover record — verified release, backups, catalog relabeling and remaining risks.
Product and merchant operations¶
- Medusa Admin product guide — Spanish-language catalog, variants, price, inventory, and troubleshooting guide for Andrea.
- Customer account readiness audit — why login is not advertised in the new Guanza interface yet.
- Future commerce, payments, and communications — manual payments, support links, Colombian providers, email, and WhatsApp Business.
Operations, growth, and publishing¶
- CI/CD pipeline plan — quality gates and future delivery automation.
- Observability, operations, and growth — telemetry, reports, safe maintenance, customer data, outreach, and loyalty.
- SEO and public indexing — crawl/index launch gate, bilingual signals, structured data, image discovery, webmaster tools, and ongoing search work.
- Publishing, analytics, consent, and advertising — current Astro/Sveltia Journal publishing flow, audience measurement, cookies/CMP, and journal-only advertising.
Architecture decisions¶
- ADR 0001: MVP hosting and commerce foundation
- ADR 0002: S3-compatible product media
- ADR 0003: production resource, log, and retention policy
Architecture decision records explain why a foundation was selected. The architecture overview describes what is running now. Runbooks describe how to operate it. The roadmap describes what remains.