Initial commit: L10N_Asia Pacific packages

odoo-bringout-oca-ocb-l10n_hk/README.md

@@ -0,0 +1,44 @@
+# Hong Kong - Accounting
+
+ This is the base module to manage chart of accounting and localization for Hong Kong 
+
+## Installation
+
+```bash
+pip install odoo-bringout-oca-ocb-l10n_hk
+```
+
+## Dependencies
+
+This addon depends on:
+- account
+
+## Manifest Information
+
+- **Name**: Hong Kong - Accounting
+- **Version**: 1.0
+- **Category**: Accounting/Localizations/Account Charts
+- **License**: LGPL-3
+- **Installable**: False
+
+## Source
+
+Based on [OCA/OCB](https://github.com/OCA/OCB) branch 16.0, addon `l10n_hk`.
+
+## License
+
+This package maintains the original LGPL-3 license from the upstream Odoo project.
+
+## Documentation
+
+- Overview: doc/OVERVIEW.md
+- Architecture: doc/ARCHITECTURE.md
+- Models: doc/MODELS.md
+- Controllers: doc/CONTROLLERS.md
+- Wizards: doc/WIZARDS.md
+- Install: doc/INSTALL.md
+- Usage: doc/USAGE.md
+- Configuration: doc/CONFIGURATION.md
+- Dependencies: doc/DEPENDENCIES.md
+- Troubleshooting: doc/TROUBLESHOOTING.md
+- FAQ: doc/FAQ.md

odoo-bringout-oca-ocb-l10n_hk/doc/ARCHITECTURE.md

@@ -0,0 +1,32 @@
+# Architecture
+
+```mermaid
+flowchart TD
+    U[Users] -->|HTTP| V[Views and QWeb Templates]
+    V --> C[Controllers]
+    V --> W[Wizards – Transient Models]
+    C --> M[Models and ORM]
+    W --> M
+    M --> R[Reports]
+    DX[Data XML] --> M
+    S[Security – ACLs and Groups] -. enforces .-> M
+
+    subgraph L10n_hk Module - l10n_hk
+      direction LR
+      M:::layer
+      W:::layer
+      C:::layer
+      V:::layer
+      R:::layer
+      S:::layer
+      DX:::layer
+    end
+
+    classDef layer fill:#eef8ff,stroke:#6ea8fe,stroke-width:1px
+```
+
+Notes
+- Views include tree/form/kanban templates and report templates.
+- Controllers provide website/portal routes when present.
+- Wizards are UI flows implemented with `models.TransientModel`.
+- Data XML loads data/demo records; Security defines groups and access.

odoo-bringout-oca-ocb-l10n_hk/doc/CONFIGURATION.md

@@ -0,0 +1,3 @@
+# Configuration
+
+Refer to Odoo settings for l10n_hk. Configure related models, access rights, and options as needed.

odoo-bringout-oca-ocb-l10n_hk/doc/CONTROLLERS.md

@@ -0,0 +1,3 @@
+# Controllers
+
+This module does not define custom HTTP controllers.

odoo-bringout-oca-ocb-l10n_hk/doc/DEPENDENCIES.md

@@ -0,0 +1,5 @@
+# Dependencies
+
+This addon depends on:
+
+- [account](../../odoo-bringout-oca-ocb-account)

odoo-bringout-oca-ocb-l10n_hk/doc/FAQ.md

@@ -0,0 +1,4 @@
+# FAQ
+
+- Q: Which Odoo version? A: 16.0 (OCA/OCB packaged).
+- Q: How to enable? A: Start server with --addon l10n_hk or install in UI.

odoo-bringout-oca-ocb-l10n_hk/doc/INSTALL.md

@@ -0,0 +1,7 @@
+# Install
+
+```bash
+pip install odoo-bringout-oca-ocb-l10n_hk"
+# or
+uv pip install odoo-bringout-oca-ocb-l10n_hk"
+```

odoo-bringout-oca-ocb-l10n_hk/doc/MODELS.md

@@ -0,0 +1,11 @@
+# Models
+
+Detected core models and extensions in l10n_hk.
+
+```mermaid
+classDiagram
+```
+
+Notes
+- Classes show model technical names; fields omitted for brevity.
+- Items listed under _inherit are extensions of existing models.

odoo-bringout-oca-ocb-l10n_hk/doc/OVERVIEW.md

@@ -0,0 +1,6 @@
+# Overview
+
+Packaged Odoo addon: l10n_hk. Provides features documented in upstream Odoo 16 under this addon.
+
+- Source: OCA/OCB 16.0, addon l10n_hk
+- License: LGPL-3

odoo-bringout-oca-ocb-l10n_hk/doc/REPORTS.md

@@ -0,0 +1,3 @@
+# Reports
+
+This module does not define custom reports.

odoo-bringout-oca-ocb-l10n_hk/doc/SECURITY.md

@@ -0,0 +1,8 @@
+# Security
+
+This module does not define custom security rules or access controls beyond Odoo defaults.
+
+Default Odoo security applies:
+- Base user access through standard groups
+- Model access inherited from dependencies
+- No custom row-level security rules

odoo-bringout-oca-ocb-l10n_hk/doc/TROUBLESHOOTING.md

@@ -0,0 +1,5 @@
+# Troubleshooting
+
+- Ensure Python and Odoo environment matches repo guidance.
+- Check database connectivity and logs if startup fails.
+- Validate that dependent addons listed in DEPENDENCIES.md are installed.

odoo-bringout-oca-ocb-l10n_hk/doc/USAGE.md

@@ -0,0 +1,7 @@
+# Usage
+
+Start Odoo including this addon (from repo root):
+
+```bash
+python3 scripts/nix_odoo_web_server.py --db-name mydb --addon l10n_hk
+```

odoo-bringout-oca-ocb-l10n_hk/doc/WIZARDS.md

@@ -0,0 +1,3 @@
+# Wizards
+
+This module does not include UI wizards.

odoo-bringout-oca-ocb-l10n_hk/l10n_hk/__init__.py

@@ -0,0 +1,2 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.

odoo-bringout-oca-ocb-l10n_hk/l10n_hk/__manifest__.py

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.
+
+{
+    'name': 'Hong Kong - Accounting',
+    'version': '1.0',
+    'category': 'Accounting/Localizations/Account Charts',
+    'description': """ This is the base module to manage chart of accounting and localization for Hong Kong """,
+    'author': 'Odoo SA',
+    'depends': ['account'],
+    'data': [
+        'data/account_chart_template_data.xml',
+        'data/account.account.template.csv',
+        'data/l10n_hk_chart_data.xml',
+        'data/account_chart_template_configure_data.xml',
+    ],
+    'demo': [
+        'demo/demo_company.xml',
+    ],
+    'license': 'LGPL-3',
+}

odoo-bringout-oca-ocb-l10n_hk/l10n_hk/data/account.account.template.csv

@@ -0,0 +1,73 @@
+"id","name","code","account_type","chart_template_id/id","tag_ids/id","reconcile"
+"l10n_hk_11","Fixed Assets","11","asset_fixed","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1110","Furniture and Fixtures","1110","asset_non_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1130","Equipment","1130","asset_non_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1140","Decoration","1140","asset_non_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1160","Investments","1160","asset_non_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_12","Current Assets","12","asset_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1240","Account Receivable","1240","asset_receivable","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_1241","Utility & Rental Deposit","1241","asset_current","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_1242","Supplier Prepayments","1242","asset_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1243","Account Receivable (PoS)","1243","asset_receivable","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_1245","Sundry Deposits","1245","asset_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1246","Other Receivable","1246","asset_receivable","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_1250","Stock Interim Account (Received)","1250","asset_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1260","Stock Interim Account (Delivered)","1260","asset_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_1270","Stock Valuation Account","1270","asset_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_21","Non-current Liabilities","21","liability_non_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_22","Current Liabilities","22","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_2210","Accruals","2210","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_221001","MPF (Employer)","221001","liability_current","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_221002","MPF (Employee)","221002","liability_current","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_2211","Account Payable","2211","liability_payable","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_2212","Receipt in Advance (Customer Prepayments)","2212","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_2214","Provision for Taxation","2214","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_2215","Proposed Dividend","2215","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_2216","Other Payable","2216","liability_payable","l10n_hk.l10n_hk_chart_template","","True"
+"l10n_hk_31","Paid Capital","31","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_32","Accumulated Profit & Loss","32","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_33","Profit & Loss Account","33","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_34","Short-term Borrowing","34","liability_current","l10n_hk.l10n_hk_chart_template","","False"
+"l10n_hk_41","Trade Income","41","income","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_42","Other Income and Gains","42","income","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_4210","Sundry Income","4210","income","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_4220","Exchange Adjustment","4220","income","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_4230","Bank Interest Income","4230","income","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_4240","Foreign Exchange Gain","4240","income","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_4250","Cash Discount Gain","4250","income_other","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_51","Costs","51","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5101","Trade Costs","5101","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5105","Misc. Costs","5105","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5106","Costs of Transportation","5106","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5111","Declaration Fees","5111","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5112","Packing Fees","5112","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_52","Expenses","52","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5201","Bank Charges","5201","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5202","Entertainment","5202","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5203","Electricity & Water Fees","5203","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5205","Postage & Stamps","5205","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5206","Printing & Stationery","5206","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5207","Rent & Rates","5207","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5208","Sundry Expenses","5208","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5209","Telecommunication Expenses","5209","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5210","Traffic Fees","5210","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5211","IT Expenses","5211","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5214","Insurance","5214","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5215","Sales Commission","5215","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5216","Overseas Traveling","5216","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5217","MPF Contribution","5217","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5218","Wages & Salaries","5218","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5219","Bonus Payment","5219","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5221","Taxation","5221","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5222","Local Delivery","5222","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5223","Management Fees","5223","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5224","Depreciation","5224","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5225","Audit Fees","5225","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5226","Bad Debts","5226","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5228","Legal & Professional Fees","5228","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5229","Dividend","5229","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5231","Disposal","5231","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5234","Repair and Maintenance","5234","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5235","Advertising","5235","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5240","Foreign Exchange Loss","5240","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"
+"l10n_hk_5250","Cash Discount Loss","5250","expense","l10n_hk.l10n_hk_chart_template","account.account_tag_operating","False"

odoo-bringout-oca-ocb-l10n_hk/l10n_hk/data/account_chart_template_configure_data.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<odoo noupdate="1">
+    <function model="account.chart.template" name="try_loading">
+        <value eval="[ref('l10n_hk.l10n_hk_chart_template')]"/>
+    </function>
+</odoo>

odoo-bringout-oca-ocb-l10n_hk/l10n_hk/data/account_chart_template_data.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<odoo>
+    <record id="base.CNY" model="res.currency">
+        <field name="active" eval="True" />
+    </record>
+
+    <!-- Account Chart template -->
+    <record id="l10n_hk_chart_template" model="account.chart.template">
+        <field name="name">Hong Kong - Chart of Accounts</field>
+        <field name="bank_account_code_prefix">1200</field>
+        <field name="cash_account_code_prefix">1210</field>
+        <field name="transfer_account_code_prefix">111220</field>
+        <field name="code_digits">6</field>
+        <field name="currency_id" ref="base.HKD" />
+        <field name="country_id" ref="base.hk"/>
+    </record>
+</odoo>

odoo-bringout-oca-ocb-l10n_hk/l10n_hk/data/l10n_hk_chart_data.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+
+    <!-- Account Chart Template -->
+    <record id="l10n_hk_chart_template" model="account.chart.template">
+        <field name="name">Hong Kong - Chart of Accounts</field>
+        <field name="property_account_receivable_id" ref="l10n_hk_1240"/>
+        <field name="property_account_payable_id" ref="l10n_hk_2211"/>
+        <field name="property_account_income_categ_id" ref="l10n_hk_41"/>
+        <field name="property_account_expense_categ_id" ref="l10n_hk_51"/>
+        <field name="expense_currency_exchange_account_id" ref="l10n_hk_5240"/>
+        <field name="income_currency_exchange_account_id" ref="l10n_hk_4240"/>
+        <field name="default_pos_receivable_account_id" ref="l10n_hk_1243"/>
+        <field name="account_journal_early_pay_discount_loss_account_id" ref="l10n_hk_5250"/>
+        <field name="account_journal_early_pay_discount_gain_account_id" ref="l10n_hk_4250"/>
+        <field name="use_anglo_saxon" eval="True"/>
+    </record>
+
+</odoo>

odoo-bringout-oca-ocb-l10n_hk/l10n_hk/demo/demo_company.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <record id="partner_demo_company_hk" model="res.partner">
+        <field name="name">HK Company</field>
+        <field name="vat"></field>
+        <field name="street">118 Connaught Road West</field>
+        <field name="street2">Unit 07 - 10, 38/F Yat Chau International Plaza</field>
+        <field name="city">Sai Ying Pun</field>
+        <field name="country_id" ref="base.hk"/>
+
+        <field name="zip"></field>
+        <field name="phone">+852 5123 4567</field>
+        <field name="email">info@company.hkexample.com</field>
+        <field name="website">www.hkexample.com</field>
+    </record>
+
+    <record id="demo_company_hk" model="res.company">
+        <field name="name">HK Company</field>
+        <field name="partner_id" ref="partner_demo_company_hk"/>
+    </record>
+
+    <function model="res.company" name="_onchange_country_id">
+        <value eval="[ref('demo_company_hk')]"/>
+    </function>
+
+    <function model="res.users" name="write">
+        <value eval="[ref('base.user_root'), ref('base.user_admin'), ref('base.user_demo')]"/>
+        <value eval="{'company_ids': [(4, ref('l10n_hk.demo_company_hk'))]}"/>
+    </function>
+
+    <function model="account.chart.template" name="try_loading">
+        <value eval="[ref('l10n_hk.l10n_hk_chart_template')]"/>
+        <value model="res.company" eval="obj().env.ref('l10n_hk.demo_company_hk')"/>
+    </function>
+</odoo>

odoo-bringout-oca-ocb-l10n_hk/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "odoo-bringout-oca-ocb-l10n_hk"
+version = "16.0.0"
+description = "Hong Kong - Accounting - Odoo addon"
+authors = [
+    { name = "Ernad Husremovic", email = "hernad@bring.out.ba" }
+]
+dependencies = [
+    "odoo-bringout-oca-ocb-account>=16.0.0",
+    "requests>=2.25.1"
+]
+readme = "README.md"
+requires-python = ">= 3.11"
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11", 
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business",
+]
+
+[project.urls]
+homepage = "https://github.com/bringout/0"
+repository = "https://github.com/bringout/0"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+packages = ["l10n_hk"]
+
+[tool.rye]
+managed = true
+dev-dependencies = [
+    "pytest>=8.4.1",
+]