E-POWER · Overviewទិដ្ឋភាពទូទៅ
E-POWER Condo Billing Systemប្រព័ន្ធគិតថ្លៃសេវាខុនដូ E-POWER
A desktop billing system for electricity distribution and condominium utility billing — electricity, water, management fees and parking fees — in Khmer (default) and English. This documentation explains every feature: how to use it step by step, and how the process works behind the screen. ប្រព័ន្ធគិតថ្លៃសេវាសម្រាប់ការចែកចាយអគ្គិសនី និងសេវាខុនដូ — អគ្គិសនី ទឹក ថ្លៃគ្រប់គ្រង និងថ្លៃចំណត — ជាភាសាខ្មែរ (លំនាំដើម) និងអង់គ្លេស។ ឯកសារនេះពន្យល់មុខងារទាំងអស់៖ របៀបប្រើប្រាស់ជាជំហានៗ និងដំណើរការរបស់ប្រព័ន្ធនៅខាងក្រោយ។
Feature areasផ្នែកមុខងារ
Customer Lifecycleវដ្តអតិថិជន
Register → Activate → Block/Unblock → Close. Merge accounts, deposits, meters. ចុះឈ្មោះ → ចាប់ផ្តើមប្រើ → ផ្តាច់/ភ្ជាប់ចរន្ត → ឈប់ប្រើ។ អតិថិជនរួម ប្រាក់តម្កល់ នាឡិកាស្ទង់។
Billing & Invoicesការចេញវិក្កយបត្រ
Monthly bill run, service charges, adjustments, void, reverse bill, invoice status policy. ចេញវិក្កយបត្រប្រចាំខែ ថ្លៃសេវាកម្ម ការកែសម្រួល ការលុប និងគោលការណ៍ស្ថានភាពវិក្កយបត្រ។
Paymentsការទទួលប្រាក់
Receive payment, prepayment, deposit, bank import, KHQR, cancel/delete, cash drawer. ទទួលប្រាក់បង់ ប្រាក់បង់មុន ប្រាក់តម្កល់ ទូទាត់តាមធនាគារ KHQR លុបការបង់ប្រាក់ កេះដាក់ប្រាក់។
Metering & Prepaidនាឡិកាស្ទង់ និងកាតបង់មុន
Prepaid IC-cards, AMR/EDMI smart meters, modem relay control, IR devices, manual entry. កាត IC បង់មុន នាឡិកាស្ទង់ឆ្លាតវៃ AMR/EDMI បញ្ជា Relay តាម Modem ឧបករណ៍ IR និងបញ្ចូលដោយដៃ។
Reportsរបាយការណ៍
Master report, payment report, aging, cancel-payment, e-Filing, Crystal Reports. MasterReport របាយការណ៍ទទួលប្រាក់ បំណុលតាមកាល លុបការបង់ប្រាក់ e-Filing និង Crystal Reports។
System & Integrationsប្រព័ន្ធ និងការតភ្ជាប់
Startup, migrations, auto-update releases, security, configuration, accounting push. ការចាប់ផ្តើម Migration ការធ្វើបច្ចុប្បន្នភាពស្វ័យប្រវត្តិ សុវត្ថិភាព ការកំណត់ និងគណនេយ្យ។
The monthly cycle — big pictureវដ្តប្រចាំខែ — ទិដ្ឋភាពរួម
- Collect usageប្រមូលការប្រើប្រាស់ Collectorអ្នកអានកុងទ័រ
Meter readings from IR devices, mobile devices, GPRS modems, EDMI AMR or manual entry — all converge into one usage table. អានកុងទ័រតាមឧបករណ៍ IR ទូរស័ព្ទ Modem GPRS, EDMI AMR ឬបញ្ចូលដោយដៃ — ទាំងអស់ចូលក្នុងតារាងការប្រើប្រាស់តែមួយ។ - Run billចេញវិក្កយបត្រ Billingផ្នែកវិក្កយបត្រ
Generates electricity invoices for the usage month, plus advance-billed service bills (management fee, parking) for the next month. បង្កើតវិក្កយបត្រអគ្គិសនីសម្រាប់ខែប្រើប្រាស់ រួមទាំងថ្លៃសេវា (ថ្លៃគ្រប់គ្រង ថ្លៃចំណត) ដែលគិតមុនសម្រាប់ខែបន្ទាប់។ - Print & distributeបោះពុម្ព និងចែក
Invoices print with KHQR codes; paid status is judged per customer across all services of the month. បោះពុម្ពវិក្កយបត្រជាមួយ KHQR; ស្ថានភាព "បង់ហើយ" ត្រូវវិនិច្ឆ័យតាមអតិថិជន លើសេវាទាំងអស់ក្នុងខែ។ - Collect paymentទទួលប្រាក់បង់ Cashierអ្នកគិតលុយ
Cash, prepay balance, deposit, bank import or KHQR — overpayment becomes prepayment. សាច់ប្រាក់ ប្រាក់បង់មុន ប្រាក់តម្កល់ ធនាគារ ឬ KHQR — ប្រាក់លើសក្លាយជាប្រាក់បង់មុន។ - Enforceអនុវត្ត Operationsប្រតិបត្តិការ
Overdue customers are blocked (relay/IR disconnect + reconnection fee) and unblocked after settlement. អតិថិជនហួសកំណត់ត្រូវផ្តាច់ចរន្ត (Relay/IR + ថ្លៃភ្ជាប់ឡើងវិញ) ហើយភ្ជាប់វិញក្រោយបង់រួច។ - Accountគណនេយ្យ
Invoices, payments, deposits and adjustments post as journal entries to Pointer ERP. វិក្កយបត្រ ការបង់ប្រាក់ ប្រាក់តម្កល់ និងការកែសម្រួល ត្រូវបញ្ជូនជាបញ្ជីគណនេយ្យទៅ Pointer ERP។
Invoice status modelស្ថានភាពវិក្កយបត្រ
Open (1) — not yet paidមិនទាន់បង់ (1) Pay (2) — partialបង់ខ្លះ (2) Cancel (3) — voidedលុប (3) Close (4) — paidបង់ហើយ (4)
Core invariantគោលការណ៍សំខាន់
- An invoice is never born "paid" — every invoice is created Open, even 0-amount ones. វិក្កយបត្រមិនដែលបង្កើតមកជា "បង់ហើយ"ទេ — គ្រប់វិក្កយបត្របង្កើតជា "មិនទាន់បង់" សូម្បីតែចំនួន 0 ក៏ដោយ។
- Never stamped Close while nothing was paid — a 0-amount invoice closes only when the customer really settles the month. មិនអាចក្លាយជា "បង់ហើយ" ដោយគ្មានការបង់ប្រាក់ពិត — វិក្កយបត្រចំនួន 0 នឹងបិទតែពេលអតិថិជនបង់ផ្តាច់ខែនោះពិតប្រាកដ។
- Cancelling / deleting a payment re-opens everything it had closed. ការលុបការបង់ប្រាក់ បើកវិក្កយបត្រដែលបានបិទដោយបង្កាន់ដៃនោះឡើងវិញទាំងអស់។
- A database trigger guards even the encrypted vendor bill-run procs. Trigger ក្នុង Database ការពារសូម្បីតែ Stored Proc ចេញវិក្កយបត្ររបស់ក្រុមហ៊ុនផ្គត់ផ្គង់ (បានអ៊ិនគ្រីប)។
- Exception: merge-child customers' 0-amount administrative rows keep vendor behaviour; the parent decides the group's status. ករណីលើកលែង៖ វិក្កយបត្រ 0 របស់អតិថិជនកូនក្នុងគណនីរួម រក្សាតាមប្រព័ន្ធដើម — ស្ថានភាពក្រុមកំណត់ដោយវិក្កយបត្រម្តាយ។
Solution architectureរចនាសម្ព័ន្ធកម្មវិធី
| Projectគម្រោង | Responsibilityតួនាទី |
|---|---|
| EPower (EXE) | Main app — all UI forms, billing logic, reporting, DB migrationsកម្មវិធីមេ — ផ្ទាំង UI ទាំងអស់ តក្កវិជ្ជាគិតថ្លៃ របាយការណ៍ និង Migration |
| EPower.Base (DLL) | Shared foundation — models, REST API clients, enums, helpers, accounting pushមូលដ្ឋានរួម — Model, API Client, Enum, Helper និងការបញ្ជូនគណនេយ្យ |
| EPower.Accounting (DLL) | Accounting module — journal, chart of accounts, fixed assetsម៉ូឌុលគណនេយ្យ — បញ្ជីគណនេយ្យ គណនី និងទ្រព្យសកម្ម |
| EPower.AMRClient | Automatic Meter Reading — EDMI smart-meter integrationអានកុងទ័រស្វ័យប្រវត្តិ — តភ្ជាប់នាឡិកាស្ទង់ EDMI |
| EPower.Component (DLL) | Custom WinForms controlsControl WinForms ផ្ទាល់ខ្លួន |
| EPowerUpdater (EXE) | Standalone self-update utility (legacy)កម្មវិធីធ្វើបច្ចុប្បន្នភាពដោយឡែក (ចាស់) |
External integrationsការតភ្ជាប់ខាងក្រៅ
| Integrationសេវា | Purposeគោលបំណង |
|---|---|
| CoreAPI | Bill run, receive payment, meter/modem/relay operationsចេញវិក្កយបត្រ ទទួលប្រាក់ និងបញ្ជានាឡិកាស្ទង់/Modem/Relay |
| Bill24 / DigitalBill | Digital bill upload, KHQR payment QR codesវិក្កយបត្រឌីជីថល និង KHQR |
| ACLEDA Bank | Bank payment export / settlement importទូទាត់តាមធនាគារ |
| Keycloak | Service-account tokens for backend APIsToken សុវត្ថិភាពសម្រាប់ API |
| Pointer ERP | Accounting journal backendប្រព័ន្ធគណនេយ្យ |
| EDMI / AMR | Smart-meter reading and relay controlអានកុងទ័រ និងបញ្ជា Relay |
| epower-updater | Version release / forced auto-updateការចេញផ្សាយកំណែថ្មី |