<a id="internals"></a>

# வலைபெயர்ப்பு internals

#### NOTE
இந்த அத்தியாயம் வலைபெயர்ப்பு உட்புறங்களின் அடிப்படை கண்ணோட்டத்தை உங்களுக்கு வழங்கும்.

வலைபெயர்ப்பு அதன் குறியீடு கட்டமைப்பின் பெரும்பகுதியிலிருந்து பெறப்படுகிறது, மேலும் இது [சாங்கோ]() ஐ அடிப்படையாகக் கொண்டது.

## கோப்பக அமைப்பு

வலைபெயர்ப்பு முதன்மையான களஞ்சியத்தின் கோப்பக கட்டமைப்பின் விரைவான கண்ணோட்டம்:

`docs`
: இந்த ஆவணத்திற்கான மூலக் குறியீடு, [Sphinx](https://www.sphinx-doc.org/) ஐப் பயன்படுத்தி உருவாக்க முடியும்.

`dev-docker`
: டெவலப்மெண்ட் சர்வரை இயக்க கப்பல்துறை குறியீடு, பார்க்கவும் [டாக்கரில் உள்நாட்டில் வலைபெயர்ப்பு இயங்குகிறது](https://docs.weblate.org/ta/weblate-2026.10/contributing/start.md#dev-docker).

`weblate`
: வெப்லேட்டின் மூலக் குறியீடு [சாங்கோ](https://www.djangoproject.com/) பயன்பாடு, பார்க்க [வலைபெயர்ப்பு internals](#internals).

`weblate/static`
: கிளையன்ட் கோப்புகள் (CSS, சாவாகைஉரை மற்றும் படங்கள்), காண்க [வலைபெயர்ப்பு ஃபிரான்டென்ட்](https://docs.weblate.org/ta/weblate-2026.10/contributing/frontend.md).

## தொகுதிகள்

வலைபெயர்ப்பு பல சாங்கோ பயன்பாடுகளைக் கொண்டுள்ளது (சில விருப்பமானது, பார்க்க [விருப்ப வலைபெயர்ப்பு தொகுதிகள்](https://docs.weblate.org/ta/weblate-2026.10/admin/optionals.md)):

`accounts`

> பயனர் கணக்கு, சுயவிவரங்கள் மற்றும் அறிவிப்புகள்.

`addons`

> வலைபெயர்ப்பு நடத்தையை மாற்றுவதற்கு துணை நிரல்கள், காண்க [துணை நிரல்கள்](https://docs.weblate.org/ta/weblate-2026.10/admin/addons.md#addons).

`api`

> [சாங்கோ ரெச்ட் ஃபிரேம்வொர்க்](https://www.django-rest-framework.org/) ஐ அடிப்படையாகக் கொண்ட பநிஇ.

`auth`

> ஏற்பு மற்றும் அனுமதிகள்.

`billing`

> The optional [பட்டியலிடல்](https://docs.weblate.org/ta/weblate-2026.10/admin/optionals.md#billing) module.

`checks`

> மொழிபெயர்ப்பு சரம் [தர சோதனைகள்](https://docs.weblate.org/ta/weblate-2026.10/user/checks.md#checks) தொகுதி.

`fonts`

> எழுத்துரு பதிப்பு சரிபார்ப்பு தொகுதி.

`formats`

> மொழிபெயர்ப்பு-கருவித்தொகுப்பை அடிப்படையாகக் கொண்ட கோப்பு வடிவமைப்பு சுருக்க அடுக்கு.

`gitexport`

> விரும்பினால் [அறிவிலி ஏற்றுமதியாளர்](https://docs.weblate.org/ta/weblate-2026.10/admin/optionals.md#git-exporter) தொகுதி.

`lang`

> மொழி மற்றும் பன்மை மாதிரிகளை வரையறுக்கும் தொகுதி.

`legal`

> விருப்பத்தேர்வு [சட்ட தொகுதி](https://docs.weblate.org/ta/weblate-2026.10/admin/optionals.md#legal) தொகுதி.

`machinery`

> இயந்திர மொழிபெயர்ப்பு சேவைகளின் ஒருங்கிணைப்பு.

`memory`

> உள்ளமைக்கப்பட்ட மொழிபெயர்ப்பு நினைவகம், பார்க்கவும் [மொழிபெயர்ப்பு நினைவகம்](https://docs.weblate.org/ta/weblate-2026.10/admin/memory.md#translation-memory).

`screenshots`

> திரை சாட்கள் மேலாண்மை மற்றும் ஓ.சி.ஆர் தொகுதி.

`trans`

> மொழிபெயர்ப்புகளைக் கையாளும் முதன்மையான தொகுதி.

`utils`

> பல்வேறு உதவிப் பயன்பாடுகள்.

`vcs`

> பதிப்பு கட்டுப்பாட்டு அமைப்பு சுருக்கம்.

`wladmin`

> சாங்கோ நிர்வாக இடைமுக தனிப்பயனாக்கம்.

## Translation sources

A unit has a canonical file source and may have a translation from another
language as its effective source. Keep `Unit.source` and `Unit.source_unit`
canonical: repository synchronization and file formats depend on this. Use
`effective_source` and its language and plural accessors for content shown to
translators. Do not replace `source` on a copied unit to simulate an effective
source; other fields and related objects still describe the canonical source.

Use `Unit.source_snapshot` when an operation needs to preserve the source text,
language, plural rules, and terminology metadata together. Its `identity` defines source changes for
dependency reconciliation, editor conflict detection, and AI diagnostics. For
historical rendering and reports, read the snapshot recorded on the change,
rather than reconstructing it from the current unit.

A missing configured parent remains a custom source: its text is empty, its
language is retained, and its child is blocked. `effective_source_unit` is
then `None`. Only removing the workflow or selecting the canonical language
restores the canonical source.

Text-only accessors do not load language or plural metadata. For batch consumers
that need the complete effective source, use
`UnitQuerySet.prefetch_translation_parent()` alongside their existing unit
prefetches. `prefetch_source()` already includes this. Ordinary searches keep
the canonical query path and ordinary units retain their existing content hashes.

Source-dependent writes enter `source_operation()` before locking unit rows.
The outer operation takes a shared project gate and reads its workflow mapping
in one database round trip, including for projects without custom workflows.
Workflow changes take `source_project_gate(..., exclusive=True)` before
validation or persistence. Configuration changes affecting several projects
acquire their gates in ascending project ID order. Never upgrade a shared gate
to an exclusive one inside an operation.

The database gate function locks first and reads workflows in a separate
statement, so a waiter sees configuration committed while it waited. Write paths
use this transaction-scoped view rather than cached model settings. Nested
operations reuse it; rolled-back savepoints discard their dependency work.
Queued dependencies are reconciled before commit and external memory updates
are scheduled after commit. Source-change history is written in bulk, preserving
individual records while batching their notification dispatch.

Acquire any required repository locks before project gates, then component and
unit row locks. Reconciliation itself only changes database state and does not
acquire repository locks. Apply this boundary to bulk imports, automatic
translation, file-save failures, deletion, and restoration as well as editor
writes. Language and plural-rule changes require exclusive gates before their
updates. Historical migrations use historical models without these runtime
helpers.

Machinery source selection happens before mapping language codes to a provider.
Use `get_unit_source_language()` for translation and `uses_custom_source()`
for workflow-specific glossary handling. Provider codes can merge distinct
language variants, so code equality cannot determine whether a workflow source
was selected. Explicit component or secondary source selection takes precedence
over the workflow source.

<a id="background-tasks-internals"></a>

## பின்னணி பணிகள் உள்

#### HINT
இந்த பகுதி செலரி பணி உள்நிலைகளை விவரிக்கிறது. [செலரியைப் பயன்படுத்தி பின்னணி பணிகள்](https://docs.weblate.org/ta/weblate-2026.10/admin/install.md#celery) என்பது பணிகளை இயக்க செலரியை எவ்வாறு கட்டமைப்பது என்பதை விவரிக்கிறது.

பின்னணியில் பணிகளைச் செய்ய வலைபெயர்ப்பு சிவரிக்கீரை ஐப் பயன்படுத்துகிறது. சில பணிகள் நிகழ்வு-தூண்டப்பட்டவை, மேலும் சில பணிகள் அட்டவணை-தூண்டப்பட்டவை.

The Celery Beat is used for scheduling tasks, and django-celery-beat is used
to store the periodic task schedule in the database. The tasks schedule is
configured in `tasks.py` in each of the Django apps.

பல வரிசைகளைப் பயன்படுத்தி பணிகள் நுகரப்படுகின்றன; ரூட்டிங் `settings.py` இல் கட்டமைக்கப்பட்டுள்ளது. வரிசைகள் பல்வேறு வகையான பணிச்சுமைகளை பிரிக்க வடிவமைக்கப்பட்டுள்ளன:

`celery`
: பின்னணி பணிகள் செயலாக்கப்படும் இயல்புநிலை வரிசை.

`notify`
: வலைபெயர்ப்பு உள்ள நிகழ்வுகள் மற்றும் ஏற்பு அல்லது பதிவு ஆகிய இரண்டுக்கும் அறிவிப்பு மின்னஞ்சல்களை வழங்குகிறது. மற்ற பணிகளில் தேக்கம் ஏற்பட்டாலும் மின்னஞ்சல் வழங்கல் சீராக நடைபெற இது தனி வரிசை.

`memory`
: மொழிபெயர்ப்பு நினைவக உள்ளீடுகளை மேம்படுத்துகிறது. புதிய சரங்களை இறக்குமதி செய்யும் போது புதுப்பித்தல் வரிசை நீண்டதாக இருக்கும், மேலும் நீண்ட செயலாக்கம் இங்கு அதிகம் தேவையில்லை, எனவே தனி வரிசை வைத்திருப்பது மற்ற பணிகளைத் தடுப்பதைத் தவிர்க்கிறது.

`backup`
: காப்புப் பிரதி பணிகளை இணையாகச் செயல்படுத்த முடியாது, மேலும் ஒரு அர்ப்பணிப்புள்ள பணியாளர் இதை எளிதாக்குகிறார்.

`translate`
: தானியங்கி மொழிபெயர்ப்புப் பணிகள் வெளிப்புறச் சேவைகளைத் தாக்குவதால் நீண்ட நேரம் எடுக்கும்.
