Source-audited platform manualበምንጭ የተመረመረ የplatform መመሪያ

Troubleshooting & Platform Glossaryችግር መፍቻ እና የPlatform ቃላት መፍቻ

A cross-application diagnostic guide plus the terminology users need to interpret GTM account, learning, textual, grammatical and research states correctly.

ይህ መመሪያ በGTM account፣ learning፣ textual እና research applications መካከል የሚፈጠሩ ችግሮችን ለመለየት እና ዋና ዋና የplatform ቃላትን ለመረዳት ያግዛል።

5diagnostic layersየdiagnostic ንብርብሮች

20+core termsዋና ቃላት

403authorization clueየauthorization ፍንጭ

500server exceptionየserver exception

First diagnose the layer that failedችግሩ ከየትኛው layer እንደመጣ መጀመሪያ ይለዩ

Symptom type	Likely layer
Pending / cannot sign in / reset / MFA	Account & Security
Locked assessment / no enrollment / score issue	Courses & Assessments
Wrong/missing progress	Server learning record or browser-local research state, depending on application
No Interlinear result / unexpected coverage	Corpus authority/coverage
Concordance count seems “too small”	Check lemma vs token-layer coverage and active filters
Research workspace state missing on another device	Likely browser-local Grammatical/Exegetical state

ችግሩ የaccount/security፣ የcourse/assessment፣ የእድገት መረጃ ቋሚነት፣ የcorpus ሽፋን፣ የConcordance ማጣሪያ ወይም በbrowser ውስጥ ብቻ የሚቀመጥ የresearch state ከሆነ መጀመሪያ የችግሩን የመረጃ layer ይለዩ። ከዚያም ችግሩ ከsource፣ account state፣ server record ወይም browser state የመጣ መሆኑን ለይተው ይፈትሹ።

Account / verification / MFA problemsየAccount፣ verification እና MFA ችግሮች

You see	Action
Pending	Use the same account. Resend verification if needed; open the email link and then press Verify email.
Expired verification link	Request a new one; do not register another account.
Correct password but Pending login fails	Complete verification first.
Repeated login/MFA failures	Wait for temporary lock/back-off to clear rather than repeatedly retrying.
Admin write says Forbidden	Complete fresh password + TOTP reauthentication. A recovery-code session is not sufficient for sensitive writes.
MFA recovery code fails	Each code is single-use. Use an unused code or restore TOTP, then regenerate the set.

Pending ማለት verification ገና አልተጠናቀቀም ማለት ነው። Link ጊዜው ካለፈ Resend ይጠቀሙ። Admin ላይ Forbidden ከታየ fresh password + TOTP reauthentication ያስፈልጋል። Recovery code አንድ ጊዜ ብቻ የሚጠቀም ነው።

Learning / course problemsየትምህርት እና Course ችግሮች

Problem	Explanation
Account is Active but course absent	Account activation is not enrollment; open Courses and enroll in the published course.
Assessment is Locked	A prerequisite mastery component is not yet satisfied.
Cannot Finish attempt	Every question must have an accepted answer.
Later score is lower	The platform retains the best full-attempt percentage for mastery.
NT310 word keeps returning	That is spaced review, not lost progress.
Grammar “quiz count” is visible but no quiz questions	The audited current Grammar UI renders counts but not the underlying 823 quiz records.

Active account መኖሩ enrollment መኖሩን አያረጋግጥም። Locked assessment ካለ prerequisite እንደተሟላ ይፈትሹ። NT Greek 310 ውስጥ ቃል spaced review ላይ ሊኖር ይችላል። Grammar quiz count ከcurrent UI quiz records ጋር በቀጥታ ተመሳሳይ እንደሆነ መገመት አይገባም።

Interlinear / Concordance / research problemsየInterlinear፣ Concordance እና Research ችግሮች

Problem	Check
Form search returns fewer results than expected	Forms & Morphology is integrated-token coverage, not the full-NT lemma layer. Check authority/book/chapter/morphology filters.
Interlinear page says Research Fixture	Do not treat it as completed Production FINAL linguistic review.
Syntax label seems questionable	Check whether it is source-supplied and compare multiple occurrences/context.
Exegetical machine candidate has a high score	Similarity ranking is not a dependence probability or curated relationship.
Study List/Saved View missing on another device	Many static Grammatical/Exegetical states are browser-local, not GTM-account synchronized.

Forms & Morphology የሙሉ NT morphology coverage አይደለም። Research Fixture የመጨረሻ የሰው የቋንቋ ግምገማ የተጠናቀቀበት መረጃ ማለት አይደለም። Source-supplied syntax እና machine discovery የመጀመሪያ የምርምር ማስረጃዎች ናቸው፤ context ሳይመረመር እንደ የመጨረሻ ውሳኔ መጠቀም አይገባም። Browser-local workspace state ከdevice ወደ device ላይከተል ይችላል።

Browser / deployment problemsየBrowser እና Deployment ችግሮች

Old page after deployment: reopen the route and perform a deliberate reload. Do not repeatedly refresh an old POST/error page.
500 Internal Server Error: treat it as a server exception, not a user mistake; use the server log/traceback to identify the route.
403 Forbidden on privileged action: distinguish authorization/MFA freshness from application failure.
SSH terminal prompt changed: always confirm whether the prompt is the Mac or the VPS before using sudo or deployment paths.

Deployment ከተቀየረ አሮጌ route ካሳየ ገጹን እንደገና ይክፈቱ ወይም force reload ያድርጉ። 500 ማለት server exception ነው። 403 በprivileged action ላይ ከታየ authorization/MFA freshness መመርመር አለበት። Terminal command ከመጻፍ በፊት promptው Mac prompt ነው ወይስ VPS prompt ነው የሚለውን ያረጋግጡ።

Stale browser cache after a deployment Deployment ከተቀየረ በኋላ browser cache አሮጌ ገጽ ሊያሳይ ይችላል

Typical symptom: one browser or a Private/Incognito window shows the new working page, while a normal Safari or Chrome window still shows an older loading state, old controls or stale text.

Compare with a Private / Incognito window.ከPrivate / Incognito window ጋር ያነጻጽሩ። If the same normal URL works there, the server and current production page may already be correct.እዚያ ተመሳሳይ normal URL ከሰራ፣ serverው እና current production page አስቀድሞ ትክክል ሊሆኑ ይችላሉ።
Compare browsers.Browsersን ያነጻጽሩ። If Firefox shows the updated page while Safari or Chrome normal windows do not, suspect a stale local browser copy before changing production code.Firefox የupdated pageን ሲያሳይ Safari ወይም Chrome normal windows ካላሳዩ፣ production codeን ከመቀየር በፊት stale local browser copy እንዳለ ይጠርጥሩ።
Use a temporary versioned URL for diagnosis.ለdiagnosis temporary versioned URL ይጠቀሙ። A query string such asእንደ ?v=20260904 creates a distinct browser cache key. If that version works immediately, stale caching is strongly indicated.ያለ query string የተለየ browser cache key ይፈጥራል። ያ version ወዲያውኑ ከሰራ stale caching በጣም የሚጠረጠር ነው።
Check the server independently.Serverውን በተለየ ይመርምሩ። Server-side tools such asእንደ curl can confirm the current HTML and cache headers. A correct server response plus a stale normal browser window indicates a client-side cache problem rather than a failed deployment.ያሉ server-side tools current HTML እና cache headers ሊያረጋግጡ ይችላሉ። Correct server response ከstale normal browser window ጋር ካለ፣ ችግኙ failed deployment ሳይሆን client-side cache problem ነው።
Do not keep patching working application code.የሚሰራውን application code በተደጋጋሚ አትpatch ያድርጉ። Once the production page is verified in a fresh session and from the server, resolve the stale browser copy through revalidation, a versioned navigation link, or clearing stored site data as appropriate.Production page በfresh session እና ከserver ላይ ከተረጋገጠ በኋላ፣ stale browser copyን revalidation፣ versioned navigation link ወይም አስፈላጊ ሲሆን stored site dataን በማጽዳት ይፍቱ።
Remember that old cache rules may survive temporarily.የቆዩ cache rules ለጊዜው ሊቆዩ እንደሚችሉ ያስታውሱ። Adding a newአዲስ Cache-Control: no-cache, must-revalidateCache-Control: no-cache, must-revalidate policy prevents future stale reuse, but an older page already stored under previous cache rules may still need one forced refresh or versioned navigation.policy ወደፊት stale reuseን ይከላከላል፤ ነገር ግን በቀድሞ cache rules የተቀመጠ አሮጌ page አንድ forced refresh ወይም versioned navigation ሊፈልግ ይችላል።

Diagnostic principle:የDiagnostic መርህ፦ if a fresh/private session and a cache-busted URL both work, treat the problem first as stale client state—not as evidence that the production application is still broken.Fresh/private session እና cache-busted URL ሁለቱም ከሰሩ፣ ችግኙን በመጀመሪያ stale client state እንደሆነ ይመልከቱ፤ production application አሁንም broken ነው የሚል evidence አይደለም።

Core platform glossaryየዋናው Platform ቃላት መፍቻ

Active: Email-verified usable account status.
Pending: Account exists but email verification has not completed.
Enrollment: Server record connecting a user to a course version; separate from account registration.
Mastery: For formal Level One components, best full-attempt percentage ≥80%. NT310 also has its own formative Mastered state; the two are not identical.
Lemma: Dictionary/headword form used for lexical reference and full-NT lemma concordance.
Surface form: The inflected form actually occurring in the text.
Morphology: Formal grammatical features encoded in a token/form.
PT1904 / Antoniades: Primary GTM teaching-text tradition identified by the platform.
Production FINAL: Finished GTM teaching corpus status for an integrated Interlinear corpus.
Research Fixture: Research/alignment fixture; not completed linguistic review.
Source-supplied syntax: Syntactic role/data inherited from a source layer rather than independently human-reviewed by GTM for every token.
Curated: Editorially/source checked within GTM workflow; not synonymous with independent peer review.
Machine discovery: Automated candidate-ranking aid; not a confidence/dependence claim.
Reader View: Normal scholarly-use surface of the Exegetical Concordance.
Research Audit View: Advanced methodological/history/QA surface of the Exegetical Concordance.
Transcript: Immutable/versioned official academic snapshot derived from locked course completions.
Certificate: Non-accredited GTM course-completion award linked to public verification.
Recovery code: Single-use MFA fallback code; it does not authorize sensitive admin writes.
Fresh reauthentication: Recent current-password + TOTP check required for sensitive administrator writes.

Active account ማለት የemail ማረጋገጫ የተጠናቀቀ እና ለመጠቀም ዝግጁ የሆነ account ነው። Pending Account ገና የemail ማረጋገጫ ያልጨረሰ account ነው። Enrollment ተጠቃሚውን ከአንድ የcourse version ጋር የሚያገናኝ የserver መዝገብ ነው። Formal Level One Mastery ምርጥ score 80% ወይም ከዚያ በላይ ሲሆን የሚመዘገብ ሁኔታ ነው። NT Greek 310 ውስጥ ያለው formative mastery ከዚህ formal mastery የተለየ ነው። Lemma የመዝገበ-ቃላት ዋና የቃል ቅርጽ ነው። Surface form በጽሑፉ ውስጥ በትክክል የታየው ቅርጽ ነው። Inflected form በሰዋሰው ምክንያት የተለወጠ ቅርጽ ነው። Production FINAL የተጠናቀቀ የGTM ማስተማሪያ corpus ሁኔታ ነው። Research Fixture ለresearch/alignment አወቃቀር የተዘጋጀ መረጃ ነው። Source-supplied syntax ከውጭ source layer የመጣ የsyntax መረጃ ነው። Curated ማለት በGTM workflow ውስጥ የeditorial/source ማረጋገጫ ተደርጓል ማለት ነው። Reader View መደበኛው የExegetical ምርምር እይታ ነው። Research Audit View ደግሞ ለadvanced research/QA የሚጠቅም የላቀ የማረጋገጫ ክፍል ነው።

When the manual should say “stop and report this”በManual ውስጥ “stop and report” ማለት ምንድነው?

A result contradicts the displayed corpus authority/status.
A protected academic record changes after it was supposedly locked.
A certificate public page exposes private academic data.
A student account can perform staff/admin actions.
A research-fixture result is presented as Production FINAL.
NT Greek 310 silently falls back to unapproved device speech.
A destructive admin action is available without the intended fresh privileged reauthentication.

የauthority ወይም status ተቃርኖ ካለ፣ የተቆለፈ academic record ተቀይሮ ካለ፣ public certificate የግል መረጃ ካሳየ፣ student ያልተፈቀደለት admin access ካገኘ፣ Research Fixture እንደ FINAL ከታየ፣ NT Greek 310 ላይ unapproved audio fallback ከሰራ፣ ወይም destructive admin write አዲስ reauthentication ሳይጠይቅ ከተፈጸመ፣ ስራውን ያቁሙ። ችግሩን ይመዝግቡ እና ሪፖርት ያድርጉ።