# Taho

> Tài liệu hành vi hiện tại của hệ thống Taho, được xác minh từ source code.

- [Tài liệu Taho](https://docs.taho.com.vn/index.md): Chọn hướng dẫn vận hành, quy trình nghiệp vụ, tài liệu kỹ thuật và trang tra cứu của Taho.
- [Vai trò và phạm vi](https://docs.taho.com.vn/overview/roles-and-scope.md): Vai trò, quyền và phạm vi tòa nhà được xác minh từ authorization code.
- [Thuật ngữ](https://docs.taho.com.vn/overview/terminology.md): Các thuật ngữ được đối chiếu với identifiers, models và UI hiện tại.
- [Tạo công ty và tòa nhà đầu tiên](https://docs.taho.com.vn/operations/organization-onboarding.md): Các bước quản trị nền tảng tạo công ty, tòa nhà đầu tiên và tài khoản quản trị công ty.
- [Căn hộ và cư dân](https://docs.taho.com.vn/operations/apartments-residents.md): Cách quản lý căn hộ, hồ sơ cư dân và các liên kết cư dân–căn hộ.
- [Dịch vụ và phương tiện](https://docs.taho.com.vn/operations/services-vehicles.md): Cách quản lý dịch vụ tòa nhà, phương tiện và chỉ số điện nước.
- [Công nợ và thanh toán](https://docs.taho.com.vn/operations/debt-payments.md): Trang wiki tổng hợp các use case công nợ, bảng kê, phiếu thu, điều chỉnh và nhắc phí.
- [Tính công nợ](https://docs.taho.com.vn/finance/calculate-billing.md): Cách tạo bảng kê nháp và dòng phí cho một kỳ đang mở.
- [Duyệt bảng kê](https://docs.taho.com.vn/finance/approve-bill.md): Cách chuyển một bảng kê nháp sang trạng thái approved.
- [Lập phiếu thu](https://docs.taho.com.vn/finance/create-receipt.md): Cách tạo phiếu thu, phân bổ tiền vào công nợ và ghi nhận tiền thừa.
- [Tạo điều chỉnh công nợ](https://docs.taho.com.vn/finance/create-adjustment.md): Cách tạo bản nháp điều chỉnh cho các dòng của một bảng kê.
- [Duyệt điều chỉnh công nợ](https://docs.taho.com.vn/finance/approve-adjustment.md): Cách áp dụng một điều chỉnh draft vào dòng phí và công nợ.
- [Hủy điều chỉnh công nợ](https://docs.taho.com.vn/finance/cancel-adjustment.md): Cách hoàn tác một điều chỉnh đã duyệt khi không có dữ liệu phụ thuộc chặn.
- [Hủy phiếu thu](https://docs.taho.com.vn/finance/cancel-receipt.md): Cách đảo phân bổ, tiền thừa và bút toán của một phiếu thu posted.
- [Gửi nhắc công nợ](https://docs.taho.com.vn/finance/send-debt-reminders.md): Cách xem trước, đưa vào hàng đợi và gửi email nhắc công nợ.
- [Báo cáo và sổ quỹ](https://docs.taho.com.vn/operations/reports-ledgers.md): Cách xem và xuất báo cáo công nợ, tiền thừa, sổ tiền mặt và sổ ngân hàng.
- [Tương tác cư dân](https://docs.taho.com.vn/operations/resident-interactions.md): Cách tiếp nhận ý kiến, xử lý yêu cầu dịch vụ, phản hồi và tài liệu đính kèm.
- [Duyệt truy cập Mini App](https://docs.taho.com.vn/operations/resident-miniapp.md): Duyệt, từ chối hoặc thu hồi quyền xem căn hộ của cư dân và hiểu phạm vi dữ liệu Mini App.
- [Thêm tòa nhà cho công ty](https://docs.taho.com.vn/operations/add-tower.md): Cách quản trị công ty tạo tòa nhà mới và quản lý tên, trạng thái tòa nhà.
- [Tài khoản và phân quyền](https://docs.taho.com.vn/operations/accounts-permissions.md): Cách tạo tài khoản, gán tòa nhà, quản lý nhóm quyền và offboard người dùng.
- [Cấu hình hệ thống](https://docs.taho.com.vn/operations/system-configuration.md): Cách quản lý cấu hình tòa nhà, danh mục hạch toán và khóa kỳ tài chính.
- [Use case và workflow](https://docs.taho.com.vn/product-specs/workflow-specifications.md): Luồng nghiệp vụ hiện tại, acceptance criteria và call path đã được đối chiếu với source code.
- [Quy tắc nghiệp vụ](https://docs.taho.com.vn/product-specs/business-rules.md): Các invariant được validation và workflow code hiện tại thực thi.
- [Vòng đời trạng thái](https://docs.taho.com.vn/product-specs/state-machines.md): Sơ đồ và ý nghĩa nghiệp vụ của các trạng thái được hệ thống sử dụng.
- [Trợ lý AI](https://docs.taho.com.vn/ai/index.md): Chỉ mục phần AI: trò chuyện, kho tri thức, tra cứu dữ liệu vận hành và kết nối MCP trong Taho.
- [Mini App cư dân](https://docs.taho.com.vn/mini-app/index.md): Đọc chức năng, luồng cấp quyền, cách chạy local và hợp đồng API của Mini App cư dân.
- [Chạy Mini App local](https://docs.taho.com.vn/mini-app/local-development.md): Chạy giao diện minh họa, preview nối backend và tạo bản build Mini App từ các script hiện có.
- [API / Swagger](https://docs.taho.com.vn/api-reference/index.md): Điểm bắt đầu cho hợp đồng HTTP, xác thực và đặc tả OpenAPI của Mini App và trợ lý AI.
- [Xác minh danh tính Zalo](https://docs.taho.com.vn/api-reference/resident-auth.md): Mini App gửi Zalo access token tới backend để nhận token phiên Taho.
- [Đọc portal cư dân](https://docs.taho.com.vn/api-reference/resident-portal.md): Đọc trạng thái liên kết hoặc dữ liệu của căn hộ được duyệt.
- [Gửi thao tác cư dân](https://docs.taho.com.vn/api-reference/resident-actions.md): Gửi thông tin liên kết căn hộ hoặc tạo yêu cầu theo quyền cư dân.
- [Duyệt quyền căn hộ](https://docs.taho.com.vn/api-reference/resident-access-review.md): BQL duyệt, từ chối hoặc thu hồi một liên kết căn hộ trong tòa nhà đang chọn.
- [Đọc lịch sử AI](https://docs.taho.com.vn/api-reference/ai-history.md): Đọc danh sách cuộc trò chuyện hoặc tin nhắn theo chủ và tòa nhà.
- [Gửi câu hỏi AI](https://docs.taho.com.vn/api-reference/ai-chat.md): Tạo câu trả lời từ tài liệu, lịch sử và công cụ dữ liệu được phép.
- [Tải tài liệu tri thức](https://docs.taho.com.vn/api-reference/ai-knowledge-upload.md): Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.
- [Lưu trữ tài liệu tri thức](https://docs.taho.com.vn/api-reference/ai-knowledge-archive.md): Chuyển tài liệu đang hoạt động sang trạng thái lưu trữ.
- [Mô hình nghiệp vụ](https://docs.taho.com.vn/product-specs/domain-model.md): Trách nhiệm, model ownership, quan hệ và implementation boundary của các domain trong current source code.
- [Phân quyền và phạm vi tòa nhà](https://docs.taho.com.vn/product-specs/permissions-matrix.md): Specification của grouped RBAC, permission checks và tenant scope theo tòa nhà trong source code hiện tại.
- [Kiến trúc thực thi](https://docs.taho.com.vn/engineering/architecture.md): Cấu trúc runtime và đường đi dữ liệu được quan sát trong source code hiện tại.
- [Chạy application local](https://docs.taho.com.vn/engineering/local-development.md): Cách khởi động application và documentation từ scripts hiện tại.
- [Cấu hình môi trường](https://docs.taho.com.vn/engineering/environment-setup.md): Chọn nhóm biến cho backend, AI, Mini App, email và lưu ảnh trước khi chạy ứng dụng.
- [Database](https://docs.taho.com.vn/engineering/database.md): PostgreSQL, Prisma client, migrations và repository boundaries hiện tại.
- [Route handlers](https://docs.taho.com.vn/engineering/route-handlers.md): Server handler patterns, guards và response boundaries hiện tại.
- [Nhập và xuất dữ liệu](https://docs.taho.com.vn/engineering/import-export.md): Luồng xem trước, ghi dữ liệu, import tài chính và xuất file theo phạm vi tòa nhà.
- [Integrations](https://docs.taho.com.vn/engineering/integrations.md): External systems và integration boundaries được source sử dụng.
- [Kiểm thử](https://docs.taho.com.vn/engineering/testing.md): Lệnh kiểm thử tự động và chỉ mục testcase cho PM, BA và QA.
- [Deployment](https://docs.taho.com.vn/engineering/deployment.md): Docker image và GitHub Actions deployment path hiện tại.
- [Route catalog](https://docs.taho.com.vn/reference/route-catalog.md): Catalog 55 admin route definitions và 28 HTTP route handlers trong source hiện tại.
- [Data dictionary](https://docs.taho.com.vn/reference/data-dictionary.md): Đầy đủ model, database column, Prisma type, nullability, default, relation và constraint từ current schema.
- [Biến môi trường](https://docs.taho.com.vn/reference/environment-variables.md): Ý nghĩa, runtime sử dụng và validation của các nhóm biến được source Taho đọc.
- [Mẫu env](https://docs.taho.com.vn/reference/env-example.md): Mẫu cấu hình bằng placeholder cho backend Taho và frontend Mini App, kèm nhóm biến cần điền.
- [Error/status catalog](https://docs.taho.com.vn/reference/error-status-catalog.md): Error codes, HTTP boundaries và domain statuses được route/service code sử dụng.
- [Runbooks](https://docs.taho.com.vn/reference/runbooks.md): Các executable operational commands và kiểm tra được current repository cung cấp.
- [Chỉ mục testcase](https://docs.taho.com.vn/reference/manual-testcases.md): Tra mã testcase, phạm vi nghiệm thu MVP và tài liệu liên quan cho PM, BA và QA.
- [Tình trạng tính năng](https://docs.taho.com.vn/reference/release-status.md): Các giới hạn và mâu thuẫn giữa testcase MVP, tài liệu cũ và source hiện tại.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.