What this category's data looks like
Materials in the foreign teacher appointment and course scheduling category include three types: appointment contracts, work permit materials, and course scheduling tables. Sources are the school's HR system, the Foreign Experts Affairs Bureau receipts, and academic affairs scheduling records, with an update cadence that rolls by semester and permit validity period. Appointment contracts provide the position, appointment period, and signature fields; work permit materials provide the permit number, validity period, and receipt; course scheduling tables provide course names, week numbers, and instructor signatures. When these three types of materials enter the deployment, operations, and application handover function, each plays a different role: contracts and permit materials serve as the basis for version and status verification, while course scheduling tables serve as the reference draft for task records and data row indexing, with field characteristics concentrated in dates, names, quantities, and signature receipts.
Configuration and implementation checks
This step is performed by the deployment environment and the administrator version upgrade page (server-side operation), outputting image versions, migration task records, and data row index status. "Handover-ready deployment status and operation records" are then completed by operations handover and business use.
| Object | Check | Verification action |
|---|---|---|
| Main service and commercial edition image versions | Both images are the same target version; verify the version identifiers of both images against the version notes | Record the version identifiers of both images on the version upgrade page, and verify the connection status of the environments where MONGODB_URI, PG_URL, and REDIS_URL reside |
| Historical chunk training task migration | Triggered only after the old instance has fully stopped and the old task lease has expired; view the execution record of this task on the administrator's version upgrade page | Verify the time and status of the task record against the handover sheet, and confirm that both records—old instance stopped and lease expired—are complete |
| Knowledge base rebuild status migration | Triggered only after the previous migration is complete; verify the time and status of the two records | Verify the time order and status of the two migration task records, and confirm that the latter was triggered after the former was completed |
| Data row index status | After migration, it is a new index status system; sample one data row to verify the status field | Sample one data row to verify the index status field, and record the connection and task row index status of the environment where DB_MAX_LINK resides |
Three common errors
- Symptom: The service starts but the data row status still shows the old marker. Cause: The image version has been updated, but the knowledge base rebuild status migration has not yet been triggered or has not completed, so the old status marker has not entered the new index status system.
- Symptom: The name, quantity, and date of the same record do not match between the appointment contract and the course scheduling table. Cause: The two materials were not updated in sync, and when checking item by item against the handover sheet, the corresponding record is missing, with the signature or receipt field left blank.
- Symptom: The script execution reports an error or the two image versions are inconsistent. Cause: The old instance was not fully stopped, the old task lease had not expired before the migration was triggered, or the version identifiers of the main service and commercial edition images were not synchronized.
How to verify the setup
This function's acceptance: verify the version identifiers of the two images in the environments where MONGODB_URI, PG_URL, and REDIS_URL reside, then verify in order the two execution records—historical chunk training task migration and knowledge base rebuild status migration—and confirm that the latter was triggered after the former was completed.
Business test: check item by item once against the handover sheet to see which record is missing, focusing on verifying whether the dates, names, quantities, and signature receipts of the appointment contracts, work permit materials, and course scheduling tables are consistent.
- On the administrator version upgrade page, export the version identifiers of the two images and the two migration task records, and verify in time order whether the latter was triggered after the former was completed.
- Sample one data row to verify the index status field, and compare it against the dates, names, quantities, and signature receipts of the appointment contracts, work permit materials, and course scheduling tables; register missing items and hand them over to the next shift.