chore: use native Azərbaycan spelling in user-facing strings
Replaces "Azerbaijan" with "Azərbaycan" in app description, README, and the descriptions of the Tax Period Closing Settings fields. Country master Link values (e.g. country_of_origin: Azerbaijan in item fixtures) are kept as-is to preserve references. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
8389e8502a
commit
0bdd885719
12
CLAUDE.md
12
CLAUDE.md
|
|
@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||||
|
|
||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
**taxes_az** is a Frappe/ERPNext application for managing Azerbaijan tax declarations and compliance. It integrates with Azerbaijan's E-Taxes system (new.e-taxes.gov.az) to automate tax filing, company profile management, and tax calculations.
|
**taxes_az** is a Frappe/ERPNext application for managing Azərbaycan tax declarations and compliance. It integrates with Azərbaycan's E-Taxes system (new.e-taxes.gov.az) to automate tax filing, company profile management, and tax calculations.
|
||||||
|
|
||||||
## Development Environment
|
## Development Environment
|
||||||
|
|
||||||
|
|
@ -49,7 +49,7 @@ after_migrate = "taxes_az.create_item_group.create_item_groups"
|
||||||
### Core Integration Modules
|
### Core Integration Modules
|
||||||
|
|
||||||
#### 1. E-Taxes Authentication (`taxes_az/auth.py`)
|
#### 1. E-Taxes Authentication (`taxes_az/auth.py`)
|
||||||
- Handles authentication with Azerbaijan E-Taxes API
|
- Handles authentication with Azərbaycan E-Taxes API
|
||||||
- Token management and renewal (endpoint: `https://new.e-taxes.gov.az/api/po/auth/public/v1/renew`)
|
- Token management and renewal (endpoint: `https://new.e-taxes.gov.az/api/po/auth/public/v1/renew`)
|
||||||
- Activity tracking with 10-minute timeout
|
- Activity tracking with 10-minute timeout
|
||||||
- Key functions:
|
- Key functions:
|
||||||
|
|
@ -119,7 +119,7 @@ Located in `taxes_az/taxes_az/report/`:
|
||||||
|
|
||||||
### Item Groups
|
### Item Groups
|
||||||
|
|
||||||
The app manages specialized item groups for Azerbaijan tax purposes:
|
The app manages specialized item groups for Azərbaycan tax purposes:
|
||||||
- **Neft Məhsulları** (Oil Products) - Includes fuel types
|
- **Neft Məhsulları** (Oil Products) - Includes fuel types
|
||||||
- **Faydalı qazıntılar** (Mining Resources) - 20+ types of minerals with units
|
- **Faydalı qazıntılar** (Mining Resources) - 20+ types of minerals with units
|
||||||
- **İdman, mərc və lotoreya oyunları** (Gaming) - Sports betting and lottery
|
- **İdman, mərc və lotoreya oyunları** (Gaming) - Sports betting and lottery
|
||||||
|
|
@ -137,7 +137,7 @@ Each doctype folder contains:
|
||||||
|
|
||||||
### Naming Conventions
|
### Naming Conventions
|
||||||
- Child table doctypes often have parent name + description (e.g., `declaration_of_value_added_tax_elave_1`)
|
- Child table doctypes often have parent name + description (e.g., `declaration_of_value_added_tax_elave_1`)
|
||||||
- Azerbaijani terms used extensively in doctype names
|
- Azərbaycan terms used extensively in doctype names
|
||||||
|
|
||||||
### Hooks Registration
|
### Hooks Registration
|
||||||
|
|
||||||
|
|
@ -175,7 +175,7 @@ fixtures = [
|
||||||
## Working with E-Taxes API
|
## Working with E-Taxes API
|
||||||
|
|
||||||
### Authentication Flow
|
### Authentication Flow
|
||||||
1. User authenticates via ASAN Login (Azerbaijan's e-government system)
|
1. User authenticates via ASAN Login (Azərbaycan's e-government system)
|
||||||
2. Tokens stored in "Asan Login" doctype with `is_default` flag
|
2. Tokens stored in "Asan Login" doctype with `is_default` flag
|
||||||
3. Activity tracked every API call to prevent timeout
|
3. Activity tracked every API call to prevent timeout
|
||||||
4. Automatic token renewal via `RENEW_URL`
|
4. Automatic token renewal via `RENEW_URL`
|
||||||
|
|
@ -250,7 +250,7 @@ bench --site [site-name] run-tests --doctype "Declaration of Value Added Tax"
|
||||||
|
|
||||||
The codebase uses a mix of:
|
The codebase uses a mix of:
|
||||||
- **Russian** - Comments and some internal documentation
|
- **Russian** - Comments and some internal documentation
|
||||||
- **Azerbaijani** - DocType names, field labels, Item Group names
|
- **Azərbaycan** - DocType names, field labels, Item Group names
|
||||||
- **English** - Code, function names, technical terms
|
- **English** - Code, function names, technical terms
|
||||||
|
|
||||||
When adding new features, follow existing language conventions for each context.
|
When adding new features, follow existing language conventions for each context.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
## Taxes Az
|
## Taxes Az
|
||||||
|
|
||||||
Azerbaijan Taxes
|
Azərbaycan Taxes
|
||||||
|
|
||||||
#### License
|
#### License
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -3,7 +3,7 @@ name = "taxes_az"
|
||||||
authors = [
|
authors = [
|
||||||
{ name = "Jey Soft", email = "info@jeysoft.az"}
|
{ name = "Jey Soft", email = "info@jeysoft.az"}
|
||||||
]
|
]
|
||||||
description = "Azerbaijan Taxes"
|
description = "Azərbaycan Taxes"
|
||||||
requires-python = ">=3.10"
|
requires-python = ">=3.10"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
dynamic = ["version"]
|
dynamic = ["version"]
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
app_name = "taxes_az"
|
app_name = "taxes_az"
|
||||||
app_title = "Taxes Az"
|
app_title = "Taxes Az"
|
||||||
app_publisher = "Jey Soft"
|
app_publisher = "Jey Soft"
|
||||||
app_description = "Azerbaijan Taxes"
|
app_description = "Azərbaycan Taxes"
|
||||||
app_email = "info@jeysoft.az"
|
app_email = "info@jeysoft.az"
|
||||||
app_license = "unlicense"
|
app_license = "unlicense"
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -359,7 +359,7 @@
|
||||||
{
|
{
|
||||||
"default": "18",
|
"default": "18",
|
||||||
"depends_on": "enable_vat",
|
"depends_on": "enable_vat",
|
||||||
"description": "Standard VAT rate in Azerbaijan is 18% (Maddə 159 of the Tax Code). This is used for reference and reporting only — the actual VAT amounts are calculated from GL account balances, not by applying this rate.\n\nChange only if the government announces a new rate.",
|
"description": "Standard VAT rate in Azərbaycan is 18% (Maddə 159 of the Tax Code). This is used for reference and reporting only — the actual VAT amounts are calculated from GL account balances, not by applying this rate.\n\nChange only if the government announces a new rate.",
|
||||||
"fieldname": "vat_rate",
|
"fieldname": "vat_rate",
|
||||||
"fieldtype": "Percent",
|
"fieldtype": "Percent",
|
||||||
"label": "VAT Rate (%)"
|
"label": "VAT Rate (%)"
|
||||||
|
|
@ -421,7 +421,7 @@
|
||||||
{
|
{
|
||||||
"default": "20",
|
"default": "20",
|
||||||
"depends_on": "enable_profit_tax",
|
"depends_on": "enable_profit_tax",
|
||||||
"description": "Corporate profit tax rate. Standard rate in Azerbaijan is 20% (Maddə 104 of the Tax Code).\n\nApplied to: Net Profit = Total Income − Total Expenses for the period.\n\nChange only if your company qualifies for a reduced rate (e.g., certain agricultural or IT activities may have incentives).",
|
"description": "Corporate profit tax rate. Standard rate in Azərbaycan is 20% (Maddə 104 of the Tax Code).\n\nApplied to: Net Profit = Total Income − Total Expenses for the period.\n\nChange only if your company qualifies for a reduced rate (e.g., certain agricultural or IT activities may have incentives).",
|
||||||
"fieldname": "profit_tax_rate",
|
"fieldname": "profit_tax_rate",
|
||||||
"fieldtype": "Percent",
|
"fieldtype": "Percent",
|
||||||
"label": "Profit Tax Rate (%)"
|
"label": "Profit Tax Rate (%)"
|
||||||
|
|
@ -596,7 +596,7 @@
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"default": "0",
|
"default": "0",
|
||||||
"description": "Enable road tax tracking. Relevant for companies owning vehicles registered in Azerbaijan.\n\nThe wizard will check if the company has transportation assets. Annual calculation.\n\nEnable only if the company owns registered vehicles.",
|
"description": "Enable road tax tracking. Relevant for companies owning vehicles registered in Azərbaycan.\n\nThe wizard will check if the company has transportation assets. Annual calculation.\n\nEnable only if the company owns registered vehicles.",
|
||||||
"fieldname": "enable_road_tax",
|
"fieldname": "enable_road_tax",
|
||||||
"fieldtype": "Check",
|
"fieldtype": "Check",
|
||||||
"label": "Enable Road Tax"
|
"label": "Enable Road Tax"
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue