o i' @sdZddlZddlZddlmZmZmZmZddlm Z m Z m Z m Z ddl mZddlmZmZzddlmZmZmZmZmZmZmZmZmZWn1eyyddlZejej ej!e"ddlmZmZmZmZmZmZmZmZmZYnwej#ej$dd d Z%e&d Z'Gd d d eZ(GdddeZ)GdddeZ*e dde%dZ+e+j,edgddgdgde+j-dddgde ddddfd e.fd!d"Z/e+j-d#d$dgde ddd%fd&e)d e.fd'd(Z0e+j-d)d*dgde ddd%fd e.fd+d,Z1e+j2d-d.d/gde ddd%fd e.fd0d1Z3e+j2d2e*d3d/gd4e ddd%fd e.fd5d6Z4e+j2d7d8d9gdd:d;Z5e+j6dd?Z7e+j2d@dAdBgddCdDZ8dS)Eut Question Bank Competency Evaluation — FastAPI Layer =================================================== Enterprise-grade HTTP API for the LMS Question Bank Competency feature. Phase 1 — TRAIN: 1. POST /train/{client_id}/start 2. POST /train/{client_id}/question-bank-batch 3. POST /train/{client_id}/finalize-questions Phase 2 — REPORT: GET /report/{client_id} → Full competency result (for cron/admin) GET /report/status/{client_id} → Training status check All data is client-isolated — no cross-contamination between organisations. N)AnyDictListOptional)FastAPI HTTPExceptionPathstatus)CORSMiddleware) BaseModelField) get_training_statusget_question_bank_resultlist_all_clientsdelete_client_datainitialize_client_storeaccumulate_question_bankfinalize_question_bankmark_training_failedTrainingStatusz4%(asctime)s | %(levelname)s | %(name)s | %(message)s)levelformatz 3.0.0-LIGHTassessment_report_apic@seZdZUedddZeed<edddZeed<edddZe ed<ed d dZ e eed <ed d dZ e eed <GdddZ dS)QuestionBankItem.z%Unique encrypted question identifier. descriptionidzFull question content. questionTextzQuestion format type. questionTypez,Category of the question for classification. categoryNamez#Available options for the question.questionOptionc@eZdZdZdS)zQuestionBankItem.ConfigignoreN__name__ __module__ __qualname__extrar)r)p/var/www/eduai.edurigo.com/assessment_competency_evaluation/testing/assessment_competency_evaluation_fast_api.pyConfigNr+N)r%r&r'r rstr__annotations__rrintr rr!r+r)r)r)r*rHs rc@s8eZdZUdZedddZeeed<GdddZ dS) QuestionBankBatchRequestz*Payload for a batch of question bank data..zBatch of question bank items.r question_bankc@r")zQuestionBankBatchRequest.Configr#Nr$r)r)r)r*r+Ur,r+N) r%r&r'__doc__r r1rrr.r+r)r)r)r*r0Rs r0c@sfeZdZUedddZeed<edddZeed<edddZ e ed<edd dZ e ee fed <d S) StatusResponse.zTrue if client exists.rr zStatus message.messagezThe client ID. client_idzTraining metadata.trainingN)r%r&r'r r boolr.r4r-r5r/r6rrr)r)r)r*r3]s  r3zQuestion Bank Competency APIu,## LMS Question Bank Competency API Streamlined competency mapping for question banks. ### Workflow 1. `/train/{id}/start` — Initialize 2. `/train/{id}/question-bank-batch` — Send data 3. `/train/{id}/finalize-questions` — Classify & Save 4. `/report/{id}` — Get Results (used by PHP cron))titlerversion*T) allow_originsallow_credentials allow_methods allow_headersz/train/{client_id}/startz!Initialize question bank trainingTraining)summarytags.zUnique integer client ID.)gerr5c sttd|dzt|}dd|d||dWSty9}ztd|d|td t|d d }~ww) z4Initializes the pipeline for question bank training. POST /train/z/startTz.Question bank training initialized for client .r r4r5r6z&Failed to initialize store for client :  status_codedetailN)loggerinfor Exception exceptionrr-)r5metaexcr)r)r*start_training_endpoints  rRz&/train/{client_id}/question-bank-batchz(Accumulate a batch of question bank data)rCpayloadc std|dt|jzdd|jD}t||}dd|d|dWStyH}ztd |d |td t |d d }~ww)z*Accumulates question bank data in batches.rDz/question-bank-batch | count=cSsg|]}|qSr)) model_dump).0qr)r)r* sz'question_bank_batch..TzBatch accumulated. Total: total_questions)r r4r5z Failed to accumulate for client rGrHrIN) rLrMlenr1rgetrNrOrr-)rSr5q_bankresultrQr)r)r*question_bank_batchs  r]z%/train/{client_id}/finalize-questionsz Finalize question classificationc std|dz t|}d|vrtd|dddd|d||d d d WStyI}ztd |d |tdt|dd}~ww)zEProcesses all accumulated questions and generates competency mapping.rDz/finalize-questionserrorirITzTraining completed for client rErXr)r r4r5rXzFailed to finalize for client rGrHN)rLrMrrrZrNrOr-)r5r\rQr)r)r*finalize_questions_endpoints    r_z/report/{client_id}z;Retrieve full question competency result (used by PHP cron)Reportcsztd|t|}|stddd|dtjkr*dd|d||dSt|}|s6td d dd d ||d S)ae Returns the question_bank_result.json for the client. Used by the PHP cron job (trainUserAttemptData) to get the competency mapping for all questions. Returns: - status: bool - result.questions: {question_id: {competency, ...}} - result.competency_summary: {competency_name: count} - result.total_questions: int z GET /report/Client not found.rIr FzTraining status: rFrHzResult file missing.TzResults retrieved.)r r4r5r\)rLrMr rrZr COMPLETEDr)r5 status_metar\r)r)r* get_reports&  rez/report/status/{client_id}zCheck training status)response_modelr@rAcs:t|}|durtdddtdd|d||dS)NrarbrITzStatus: r rF)r rr3rZ)r5rPr)r)r* check_statuss  rgz/clientszList all clients ManagementcsdtdS)NT)r clients)rr)r)r)r* list_clientss rjz/client/{client_id}zDelete client datac sLzt|r dddWStdddty%}ztdt|dd}~ww)NTzDeleted.)r r4raz Not found.rIi)rr RuntimeErrorr-)r5rQr)r)r* delete_clients  rlz/healthz Health checkSystemcs dtdS)Nok)r r9)VERSIONr)r)r)r* health_check"s rp)9r2osloggingtypingrrrrfastapirrrr fastapi.middleware.corsr pydanticr r $assessment_report_analysis_processorr rrrrrrrr ImportErrorsyspathappenddirnameabspath__file__ basicConfigINFOro getLoggerrLrr0r3appadd_middlewarepostr/rRr]r_rZrergrjdeleterlrpr)r)r)r*s 0 0             '