Skip to content

docs: truth-audit cleanup — correct customer/adoption claims + delete stale infra-contradicting decks#21

Merged
ahmetabdullahgultekin merged 1 commit into
mainfrom
chore/truth-audit-cleanup-2026-06-11
Jun 11, 2026
Merged

docs: truth-audit cleanup — correct customer/adoption claims + delete stale infra-contradicting decks#21
ahmetabdullahgultekin merged 1 commit into
mainfrom
chore/truth-audit-cleanup-2026-06-11

Conversation

@ahmetabdullahgultekin

Copy link
Copy Markdown
Contributor

What

Executes the SAFE, reviewable subset of the FIVUCSAS truth-audit (docs/THESIS_AUDIT_2026-06-11/14_truth_audit.md, local-only) that lives in this docs repo. Ground truth from the audit: there are no real/paying customers; the only users are the dev team; Marmara is the demo tenant (marmara-bys-demo) and the authors' own university. This PR removes wording that implies real customers/adoption and deletes two presentation decks that contradict current production on nearly every fact.

Review-only — please do not auto-merge. Opened for the author to review.

Fixes

  • plans/BAAS_RENTAL_MODEL.md (P1-4): "FIVUCSAS has evolved from a university project into a production-grade biometric platform … The next commercial step is offering …" → "FIVUCSAS, a university capstone biometric platform …, could be extended commercially by offering …". Removes the realized-evolution claim; the doc remains a clearly-labelled Design Document (Pre-Implementation) and its future-tense pricing content is untouched.
  • adr/0001-hosted-first-oidc.md (P1-5): "surfaces that real customers need to cover" → "surfaces that real-world integrations need to cover" (no existing customer base; means real-world integrator surfaces).
  • README.md (P3-4): stale footer "Documentation Last Updated: 2026-02-17" → 2026-06-11 (the body is already current to June 2026).

Deletions (verified dead)

Both decks have zero inbound references in this repo or the parent tree, are not served by the VitePress book (the book serves book/, not presentations/), and contradict current prod infra:

  • presentations/SPRING_2026_FINAL_PRESENTATION.md (P2-2 / P1-1): GTX 1650 / 4GB VRAM / GhostFaceNet (system is GPU-less by design, ALLOW_HEAVY_ML=false), JWT HS512 (prod OIDC = RS256), NGINX API Gateway (prod = Traefik v3.6.12), migrations V24 (actual V84), public bio.fivucsas.com (no public route), and upstream 99.83% / 99.65% LFW accuracy presented as if it characterises FIVUCSAS.
  • presentations/SPRING_2026_SPEECHES.md (P2-2): "Google Cloud Platform / Europe Central 2", "biometric processor on my laptop GPU through a Cloudflare Tunnel", "200 ms on our GTX 1650", "JWT … HS512", "full Cloudflare Tunnel deployment". Actual prod = Hetzner CX43, CPU-only, no Cloudflare.

Left as candidate-for-review (NOT deleted)

  • presentations/DEFENSE_PRESENTATION_JAN_2026.md, presentations/SLIDES_CONTENT.md — audit says "review before any defense"; a defense is imminent (13/22 Jun). Unreferenced but not unambiguously fact-contradicting like the two SPRING decks. Please confirm before deletion.
  • audits/AUDIT_2026-04-19.md, archive/2026-04-16/ (44 files), archive/2026-05-28/{test-report.md,SERVICES_OVERVIEW.md} (B.3) — large historical-archive snapshots; audit says "do NOT delete yet — confirm with author".

Finding IDs reference 14_truth_audit.md. Thesis-chapter customer/tenant fixes (P0-1..P0-3, P0-7) are handled separately in parent PR #164 and are not touched here.

…ting decks

Applies the SAFE subset of truth-audit 14_truth_audit.md to the docs repo.

Fixes:
- plans/BAAS_RENTAL_MODEL.md (P1-4): "has evolved from a university project
  into a production-grade biometric platform ... The next commercial step is"
  -> "a university capstone biometric platform ... could be extended
  commercially by". Removes the realized-evolution claim; doc stays a labelled
  Pre-Implementation design.
- adr/0001-hosted-first-oidc.md (P1-5): "surfaces that real customers need to
  cover" -> "surfaces that real-world integrations need to cover" (no existing
  customer base).
- README.md (P3-4): stale footer "Last Updated 2026-02-17" -> 2026-06-11
  (body already current to June 2026).

Deletions (verified dead: zero inbound references, not served by the VitePress
book, contradict current prod on nearly every fact):
- presentations/SPRING_2026_FINAL_PRESENTATION.md (P2-2/P1-1): GTX 1650 /
  GhostFaceNet, HS512, NGINX gateway, V24, public bio.fivucsas.com, 99.83%/99.65%
  LFW accuracy as if measured. Actual: GPU-less Hetzner CX43, RS256 OIDC, Traefik,
  V84, no public bio route.
- presentations/SPRING_2026_SPEECHES.md (P2-2): Google Cloud / Europe Central 2,
  laptop-GPU via Cloudflare Tunnel, 200ms GTX 1650, HS512. All false vs prod.
@ahmetabdullahgultekin ahmetabdullahgultekin merged commit 248e445 into main Jun 11, 2026
5 checks passed
@ahmetabdullahgultekin ahmetabdullahgultekin deleted the chore/truth-audit-cleanup-2026-06-11 branch June 11, 2026 22:27
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.

1 participant