Avni uses PostgreSQL as the database. It particularly depends on a couple of features quite heavily - JSONB data type and row-level security. JSONB allows for user-defined schema and row-level security for achieving multi-tenancy. If you planning to do Avni server-side, product development then reading up on these two concepts is highly recommended. But if you plan to use Avni to implement for your organisation then these two concepts are not necessary reading.
Avni's database schema documentation is available here, but if you are here for the first time then do read the rest of the documentation here before browsing through the schema documentation. Please also note that since this schema definition is handwritten after generation some of the fields in the table may be absent. For full schema definition, but without description, you may see this.
Avni database can be logically broken down into a smaller-cohesive group of tables - which for our purposes of understanding could be called modules (to reiterate, this is only for understanding purposes - Avni database doesn't have these modules in the database in any form). The functions of the tables and key-columns are provided in dbdocs.
An explanation for a few columns which are repeated across the tables
- organisation_id: This column indicates the organisation to which a row belongs (since Avni uses row-level multi-tenancy.
- is_voided or active: This is used to perform soft delete of data
- id: the primary key of a table
- uuid: identifier via which an externally integrating system can refer to records in Avni. id should not be used for this purpose.
- version: although this column is present, please ignore it because this column is not used as the functionality around it has not been developed fully.
Avni is multi-tenant with multiple organisation's data residing within the same schema - protected by row-level security. Avni also supports a group of organisations with one master organisation.
organisation, organisation_group, organisation_group_organisation
For more about work-area please refer to this.
address_level_type, address_level, location_location_mapping, catchment, catchment_address_mapping
For few commonly required entities recognised, hence recognised by the platform.
gender, individual_relation, individual_relationship_type, individual_relation_gender_mapping
These tables allow the user of the platform (aka implementer) to define their data model. These tables could be further sub-grouped into form, concept and types tables. Concept tables describe your data independent of how it has been captured. Form tables describe how the data should be captured. *Types tables allow you to define the high-level relationship between your data entities, as explained in section 2 and 4 here.
concept, concept_answer, subject_type, operational_subject_type, program, operational_program, encounter_type, group_role, operational_encounter_type, form, form_element_group, form_element, non_applicable_form_element, form_mapping
individual, program_enrolment, encounter, program_encounter, group_subject, individual_relationship
Note that here tables for transaction and meta/master data are grouped together.
Identifiers have been documented here.
identifier_assignment, identifier_source, identifier_user_assignment
checklist, checklist_detail, checklist_item, checklist_item_detail
deps_saved_ddl, rule, rule_dependency
users, user_group, user_facility_mapping
privilege, group_privilege, groups
rule_failure_log, rule_failure_telemetry, sync_telemetry, video_telemetric
Task, Task_Status, Task_Type, Task_Unassignment
Manual_Message, Message_Receiver, message_request_queue, message_rule, msg91_config, news
dashboard, dashboard_card_mapping, dashboard_filter, dashboard_section, dashboard_section_card_mapping, standard_report_card_type, group_dashboard, report_card
table_metadata, column_metadata, scheduled_job_run
- Contains information about the downloads done by the user
Updated 2 months ago