Skip to content

docs(round2): emails, SDK CDN delivery, wire orphan diagrams#17

Merged
ahmetabdullahgultekin merged 2 commits into
mainfrom
docs/round2-2026-05-28
May 28, 2026
Merged

docs(round2): emails, SDK CDN delivery, wire orphan diagrams#17
ahmetabdullahgultekin merged 2 commits into
mainfrom
docs/round2-2026-05-28

Conversation

@ahmetabdullahgultekin

Copy link
Copy Markdown
Contributor

Summary

  • Emails: Replaced info@app.fivucsas.com and security@fivucsas.com everywhere with info@fivucsas.com (primary) + rollingcat.help@gmail.com (alternate). Files: SECURITY.md, 02-architecture/security.md.

  • SDK delivery: npm packages @fivucsas/auth-* return 404 (not published). The CDN is live: https://verify.fivucsas.com/fivucsas-auth.js (IIFE, HTTP 200) and https://verify.fivucsas.com/fivucsas-auth.esm.js (ESM, HTTP 200). Updated INTEGRATION_GUIDE.md (Quick Start + Options A/B/C), tenant-onboarding.md, and EMBEDDABLE_AUTH_WIDGET_ARCHITECTURE.md to use the confirmed CDN paths and mark npm as "coming soon — not yet published".

  • Orphan diagrams wired: All 11 .drawio and 5 ADD_diagrams/*.png referenced in new §11–12 of ARCHITECTURE_DIAGRAMS.md and a summary table in 02-architecture/README.md. Per-diagram verdicts below.

Diagram verdicts

.drawio — accurate + wired

  • system_architecture.drawio — JWT corrected HS512 → RS256 in source XML
  • hexagonal_architecture.drawio — accurate
  • er_diagram.drawio — broadly accurate (pre-V55 schema; note on V55–V60 added)
  • use_case_diagram.drawio — accurate
  • biometric_puzzle_flow.drawio — accurate
  • data_flow_diagram.drawio — accurate
  • nfc_handshake.drawio — accurate
  • ml_pipeline.drawio — accurate (9 DeepFace models shown; MobileFaceNet was a separate stripped model not listed here)

.drawio — needs regeneration (wired with caveat note)

  • deployment_architecture.drawio — shows NGINX; prod uses Traefik
  • technology_stack.drawio — API gateway section shows NGINX; prod uses Traefik
  • implementation_progress.drawio — "Fall 2025" percentages; project is now 98%+ complete

ADD_diagrams/*.png — accurate + wired

  • diagram_01_use_cases_by_actor.png
  • diagram_02_domain_model___core_entities.png
  • diagram_03_entity_relationship_diagram.png

ADD_diagrams/*.png — needs regeneration

  • diagram_04_system_architecture_overview.png — NGINX gateway + "DeepFace 9 Models" (MobileFaceNet removed); Traefik is the real gateway
  • diagram_05_docker_deployment.png — nginx:8000 + web-app:5173; prod uses Traefik + verify.fivucsas.com

Test plan

  • Confirm CDN URLs still resolve: curl -sI https://verify.fivucsas.com/fivucsas-auth.js → 200; curl -sI https://verify.fivucsas.com/fivucsas-auth.esm.js → 200
  • Check no remaining info@app.fivucsas.com or security@fivucsas.com in docs tree
  • Open diagrams/system_architecture.drawio in draw.io and confirm JWT label reads RS256
  • Review §11–12 links in ARCHITECTURE_DIAGRAMS.md — all relative paths should resolve within the repo

🤖 Generated with Claude Code

1. Contact email: replace info@app.fivucsas.com and security@fivucsas.com
   with info@fivucsas.com (primary) + rollingcat.help@gmail.com (alternate)
   in SECURITY.md and 02-architecture/security.md.

2. SDK delivery: npm packages @fivucsas/auth-* are not yet published.
   Update Quick Start, Option A/B/C and tenant-onboarding to use the
   confirmed CDN URLs (fivucsas-auth.js + fivucsas-auth.esm.js — both
   HTTP 200 at https://verify.fivucsas.com/). Old /sdk/ sub-path was 404.
   Mark npm install lines as "coming soon — not yet published".

3. Orphan diagrams: wired all 11 .drawio and 5 ADD_diagrams/*.png into
   new §11–12 of ARCHITECTURE_DIAGRAMS.md and README.md summary table.
   Per-diagram verdict: accurate+wired (7 drawio, 3 PNG) vs needs-regen
   (3 drawio, 2 PNG — NGINX→Traefik, stale progress bars).
   Corrected HS512→RS256 in system_architecture.drawio and Mermaid seq
   diagram in ARCHITECTURE_DIAGRAMS.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 28, 2026 10:19

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

…design-doc refs)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ahmetabdullahgultekin ahmetabdullahgultekin merged commit 8c55511 into main May 28, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants