{ "schema": "ftc.architecture-export.v1", "release": "architecture-20261027-r2", "title": "Kiến trúc FlyTrustContent", "generatedAt": "2026-10-27T06:13:28.409Z", "observedAt": "2026-10-27T05:09:09Z", "sourceCommit": "b8511e37f59397ad06da37a34362283591ea6a3c", "sourceScope": "Working tree đã đối chiếu; Git HEAD không đại diện toàn bộ image đang chạy.", "labels": { "verified": "Runtime đã xác minh", "existing": "Hiện hữu · phạm vi từng luồng", "canary": "Canary giới hạn", "source": "Đã đối chiếu source", "partial": "Còn một phần", "blocked": "Chưa mở / có gate", "research": "Nghiên cứu" }, "modules": [ { "id": "entry", "name": "Cửa vào & nhận diện", "owner": "FTC", "status": "existing", "short": "Google, xác nhận email, workspace và thương hiệu", "detail": "Tạo phiên và ngữ cảnh; mỗi API tiếp tục kiểm quyền riêng. Vòng đăng ký mới không được tái nghiệm thu trong lần xuất này.", "source": "FlytrustContent/src/index.ts" }, { "id": "mission", "name": "Growth Mission", "owner": "FTC", "status": "existing", "short": "Mục tiêu → kế hoạch → công việc → kết quả", "detail": "Business object của FTC. Runtime có allowlist, quyền actor/brand, duyệt và lineage; PostgreSQL là điều kiện authority của Mission.", "source": "FlytrustContent/src/services/growth-mission.service.ts" }, { "id": "campaign", "name": "Campaign Center", "owner": "FTC", "status": "existing", "short": "Điều phối, lịch, duyệt và receipt xuất bản", "detail": "Campaign active không tự chứng minh bài đã đăng. Receipt/readback và thời điểm nền tảng xác nhận cần được đối soát riêng.", "source": "FlytrustContent/src/services/campaign.service.ts" }, { "id": "idealab", "name": "IdeaLab & Harness", "owner": "FTC", "status": "existing", "short": "Brief có căn cứ → nội dung → kiểm tra → duyệt", "detail": "Tái sử dụng creative production. Bản nháp, đầu ra AI, nội dung được duyệt và nội dung đã xuất bản là những trạng thái khác nhau.", "source": "FlytrustContent/src/services/content-generation-harness.service.ts" }, { "id": "today", "name": "Today Grow / Research", "owner": "FTC", "status": "source", "short": "Tín hiệu, ưu tiên và bước cần quyết định", "detail": "Các bộ chọn vận hành và nguồn GEO có trong source. Chất lượng khuyến nghị và tác động tăng trưởng chưa được chứng minh từ health check.", "source": "FlytrustContent/src/services/today-operations-selection.ts" }, { "id": "geo", "name": "GEO / AI Visibility", "owner": "FTC", "status": "existing", "short": "Quan sát → đối soát → gap → nhiệm vụ", "detail": "Readiness nội dung khác với hiện diện thực trên engine. Thiếu nguồn, dữ liệu cũ và chưa đo phải được giữ rõ.", "source": "FlytrustContent/src/services/geo-workspace-map.service.ts" }, { "id": "website", "name": "Website tri thức", "owner": "FTC", "status": "existing", "short": "Bản thể thương hiệu và nội dung theo thời gian", "detail": "FTC-managed website và CMS là kênh nghiệp vụ. Nguồn, canonical, trạng thái công khai và lịch bài đi qua kiểm tra/duyệt; không bảo đảm indexing hoặc thứ hạng AI.", "source": "FlytrustContent/src/services/managed-knowledge.service.ts" }, { "id": "channels", "name": "Traffic Integration", "owner": "FTC + provider", "status": "source", "short": "Fanpage, Website/CMS, LinkedIn, Email và các adapter", "detail": "Năng lực có trong source không đồng nghĩa đã được kết nối và cấp quyền cho mọi tenant. Xuất bản/gửi thật cần cấu hình, consent và phê duyệt tương ứng.", "source": "FlytrustContent/src/routes/campaign-channel-workspace.routes.ts" }, { "id": "radar", "name": "LeadRadar & thông báo", "owner": "FTC", "status": "source", "short": "Tín hiệu đầu vào, cảnh báo và theo dõi", "detail": "First-party signal store, mail vận hành và nhắc cấu hình có source. Khả năng gửi đến từng người nhận chưa được thử lại trong lần xuất kiến trúc.", "source": "FlytrustContent/src/services/leadradar-first-party.service.ts" }, { "id": "sales", "name": "Sales Workspace", "owner": "FTC / tenant", "status": "canary", "short": "CRM → đánh giá → báo giá → đơn hàng", "detail": "Canary trên một workspace. UI mới đã lên production; E2E ghi dữ liệu dùng môi trường cô lập. CRM của tenant tách với CRM bán thuê bao của nền tảng.", "source": "FlytrustContent/src/services/revenue-operations.service.ts" }, { "id": "money", "name": "Receipt & doanh thu", "owner": "FTC / merchant", "status": "blocked", "short": "Tiền đã đối soát, hoàn tiền và attribution", "detail": "Verifier và ledger đã thử bằng receipt kỹ thuật. Provider thật chưa mở; đơn hàng hoặc won không được tính thành tiền thực thu.", "source": "FlytrustContent/src/domain/commercial/native-sales-payment.ts" }, { "id": "events", "name": "Commercial Outbox", "owner": "FTC", "status": "partial", "short": "Sự kiện bền vững, dedup, lease và retry", "detail": "Nghiệp vụ + event + command receipt cùng transaction. Chuẩn hóa Mission/Campaign/visitor còn một phần; bridge sales→FTA đang OFF.", "source": "FlytrustContent/src/services/revenue-state-adapter.ts" }, { "id": "bridge", "name": "FTC ↔ FTA Bridge", "owner": "FTC adapter / FTA grants", "status": "canary", "short": "Principal, tenant, StateRef và readback", "detail": "Bridge theo binding/quyền hiện hữu; không cấp quyền nhờ cùng email. UI/Agent là người dùng của kernel, không là canonical writer độc lập.", "source": "FlytrustContent/src/services/unified-fta-bridge.ts" }, { "id": "fta", "name": "FTA State & Runtime", "owner": "FTA", "status": "verified", "short": "Evidence, canonical state, policy, execution, audit", "detail": "Runtime đang healthy/restart 0 ở thời điểm quan sát. Bounded store đã deploy; đây không phải chứng nhận mọi workflow hay quy mô vô hạn.", "source": "FlyTrust Agent/apps/agent-runtime/src/store.ts" }, { "id": "projections", "name": "Feed / Diagram / Workbook", "owner": "FTA projection + FTC UX", "status": "canary", "short": "Cùng tham chiếu state, version và evidence", "detail": "Các view vận hành tái sử dụng FTA. Website này chỉ mô tả kiến trúc tĩnh; không tạo thêm Diagram/Workbook hoặc state store nghiệp vụ.", "source": "FlyTrust Agent/apps/agent-runtime/src/unified-platform.ts" }, { "id": "assistant", "name": "FTC Agent", "owner": "FTC product assistant", "status": "existing", "short": "Giải thích ngữ cảnh và đề nghị bước được phép", "detail": "Giữ workspace/Mission/state và evidence theo quyền. Duyệt, dispatch, receipt và outcome không được nhập thành một trạng thái thành công.", "source": "FlytrustContent/src/services/ftc-fta-runtime.service.ts" }, { "id": "market", "name": "State Feed / Market", "owner": "FTC discovery / FarmTruth source", "status": "canary", "short": "Khám phá dịch vụ và DTO công khai đã được phép", "detail": "Không đưa dữ liệu Station riêng tư hoặc fixture vào discovery thật. Handoff sang tenant sales đang OFF nếu chưa có source/receiver grant.", "source": "FlytrustContent/src/services/farmtruth-market-public.ts" }, { "id": "station", "name": "FarmTruth Station", "owner": "FarmTruth", "status": "partial", "short": "Nhà cung cấp, lô hàng, chứng cứ và seller workflow", "detail": "Web/API/worker/PostgreSQL đang chạy; một số phụ thuộc Station đang dừng. Luồng seller/RLS/handoff V3 mới có kiểm thử cô lập, chưa chốt source production.", "source": "docs/architecture/FLYTRUST_V3_TARGET_ARCHITECTURE.md" }, { "id": "data", "name": "Data Fabric & lưu trữ", "owner": "Từng domain", "status": "verified", "short": "PostgreSQL, SQLite, Redis và vector store", "detail": "FTC có nhiều authority: Mission/data fabric dùng PG, transaction Campaign/Sales dùng SQLite; FTA có RuntimeStore riêng. Không có một database chung cho mọi domain.", "source": "FlytrustContent/src/database/campaign-transaction.ts" }, { "id": "billing", "name": "Billing & Admin", "owner": "FTC platform", "status": "existing", "short": "Thuê bao, CRM nền tảng và quyền thương mại", "detail": "Authority tiền thuê bao khác merchant revenue của tenant. Không thay giá, VAT, hợp đồng, entitlement hoặc checkout trong lần xuất này.", "source": "FlytrustContent/src/services/revenue-operations.runtime.ts" }, { "id": "research", "name": "FCSI / nghiên cứu", "owner": "Research + FTA admission", "status": "research", "short": "Mô hình, baseline, uncertainty và outcome review", "detail": "Shadow canary không chứng minh causal uplift. Model/dataset admission, quyền sử dụng dữ liệu và H1–H4 vẫn là những gate độc lập.", "source": "docs/research/fcsi/implementation-20261025/production-20261025-r2/PRODUCTION_DEPLOYMENT_REPORT.md" } ], "views": [ { "id": "overview", "title": "Toàn cảnh hệ thống", "description": "FTC sở hữu luồng tăng trưởng và bán hàng. FTA cung cấp cơ chế state, evidence và runtime. FarmTruth giữ nghiệp vụ và dữ liệu nguồn riêng.", "rows": [ [ "entry", "assistant", "projections" ], [ "mission", "campaign", "idealab" ], [ "geo", "website", "sales" ], [ "bridge", "fta", "data" ], [ "market", "station", "money" ] ], "edges": [ [ "entry", "mission" ], [ "assistant", "bridge" ], [ "projections", "bridge" ], [ "mission", "campaign" ], [ "campaign", "idealab" ], [ "idealab", "website" ], [ "geo", "mission" ], [ "sales", "money", "gate" ], [ "bridge", "fta" ], [ "fta", "projections" ], [ "market", "sales", "gate" ], [ "station", "market", "gate" ] ] }, { "id": "mission", "title": "Từ mục tiêu đến hành động", "description": "Một Mission tạo kế hoạch và tác vụ có lineage. Con người duyệt tác động trước khi runtime gọi API nghiệp vụ; outcome cần quan sát độc lập.", "rows": [ [ "entry", "mission" ], [ "today", "geo", "idealab" ], [ "assistant", "bridge", "fta" ], [ "campaign", "website", "channels" ], [ "events", "projections", "sales" ] ], "edges": [ [ "entry", "mission" ], [ "mission", "today" ], [ "mission", "idealab" ], [ "geo", "mission" ], [ "idealab", "campaign" ], [ "assistant", "bridge" ], [ "bridge", "fta" ], [ "fta", "campaign" ], [ "campaign", "channels" ], [ "website", "events" ], [ "events", "projections", "gate" ], [ "sales", "events" ] ] }, { "id": "content", "title": "Nội dung & bản thể thương hiệu", "description": "Website tri thức và các kênh là những đầu ra được điều phối từ cùng ngữ cảnh. Readiness, xuất bản, indexing và AI visibility có bằng chứng khác nhau.", "rows": [ [ "mission", "geo" ], [ "idealab", "assistant", "campaign" ], [ "website", "channels" ], [ "radar", "today", "events" ] ], "edges": [ [ "mission", "idealab" ], [ "geo", "idealab" ], [ "idealab", "campaign" ], [ "campaign", "website" ], [ "campaign", "channels" ], [ "assistant", "website" ], [ "website", "geo" ], [ "channels", "events" ], [ "events", "today", "gate" ], [ "radar", "today" ] ] }, { "id": "commerce", "title": "Từ nhu cầu đến doanh thu", "description": "Đơn hàng là chấp nhận được ghi nhận; tiền thực thu chỉ đến từ receipt hợp lệ. Market là nguồn bổ sung, không là điều kiện để FTC hoạt động.", "rows": [ [ "entry", "market", "station" ], [ "website", "radar", "sales" ], [ "money", "events", "billing" ], [ "bridge", "fta", "projections" ] ], "edges": [ [ "station", "market", "gate" ], [ "market", "sales", "gate" ], [ "website", "sales" ], [ "radar", "sales" ], [ "sales", "money", "gate" ], [ "sales", "events" ], [ "money", "events", "gate" ], [ "events", "bridge", "gate" ], [ "bridge", "fta" ], [ "fta", "projections" ] ] }, { "id": "authority", "title": "Dữ liệu & ranh giới quyền", "description": "Domain sở hữu dữ liệu nghiệp vụ. Shared kernel giữ cơ chế kiểm chứng và versioning trong scope được cấp; read, operate, publish và training là quyền khác nhau.", "rows": [ [ "entry", "billing", "sales" ], [ "mission", "campaign", "website" ], [ "data", "bridge", "fta" ], [ "station", "market", "research" ], [ "projections", "assistant" ] ], "edges": [ [ "entry", "sales" ], [ "mission", "data" ], [ "campaign", "data" ], [ "sales", "data" ], [ "bridge", "fta" ], [ "station", "market", "gate" ], [ "research", "fta", "gate" ], [ "fta", "projections" ], [ "assistant", "bridge" ] ] } ], "flows": [ { "title": "Mission & thực thi", "steps": [ "Website + mục tiêu + ngân sách + hạn", "Nghiên cứu có nguồn", "Kế hoạch và tác vụ có lineage", "IdeaLab tạo bản nháp", "Người có quyền duyệt", "Runtime gọi adapter nghiệp vụ", "Đọc lại receipt / evidence", "Review outcome và Mission tiếp theo" ], "limit": "Không có quyền publish, chi tiền hay chuyển dữ liệu nhạy cảm chỉ vì đã tạo Mission." }, { "title": "Website tri thức", "steps": [ "Chọn đúng thương hiệu", "Thu thập dữ kiện có căn cứ", "FTC Agent gợi ý để người dùng kiểm tra", "Lưu hồ sơ thương hiệu", "Tạo nội dung website từ chiến dịch", "Kiểm tra và duyệt công khai", "Lưu version, canonical, nguồn và thời gian", "Đo lường rồi đưa gap về GEO / Today" ], "limit": "Sơ đồ này mô tả luồng; không xác nhận website nào đã index hoặc được engine AI trích dẫn." }, { "title": "Bán hàng của tenant", "steps": [ "Nhu cầu có consent", "Lead / cơ hội", "Qualification và lịch theo dõi", "Quotation snapshot bất biến", "Duyệt nội bộ", "Căn cứ khách chấp nhận", "Order", "Receipt / refund hợp lệ", "Doanh thu đối soát → outbox" ], "limit": "Gateway tiền thật và sales→FTA chưa bật. Receipt kỹ thuật không phải doanh thu thật." }, { "title": "FarmTruth → FTC tùy chọn", "steps": [ "Nguồn / listing thuộc seller", "Projection công khai được chấp thuận", "Người mua gửi inquiry cho seller", "Seller xử lý native, không bắt buộc FTC", "Consent và mapping source / receiver riêng", "FTC intake có dedup và thu hồi consent" ], "limit": "Handoff V3 mới được kiểm thử cô lập; production source RLS/grant và intake vẫn là gate." }, { "title": "State & quyết định", "steps": [ "Observation có source time", "Evidence admission", "Reconciliation / policy", "Canonical state có version", "Feed / Diagram / Workbook cùng StateRef", "Đề nghị và approval snapshot", "Dispatch qua runtime hiện hữu", "Readback và outcome review" ], "limit": "Transport ACK, approved action, canonical record và causal outcome là các khái niệm khác nhau." } ], "stores": [ [ "FTC Mission / Data Fabric", "PostgreSQL", "Quyền và business record theo domain; Mission runtime yêu cầu PG authority.", "Source + container PG healthy. Không đọc dữ liệu tenant trong lần xuất này." ], [ "FTC Campaign / Sales", "SQLite durable transaction", "Campaign feedback, tenant sales, command receipt và outbox trong transaction bản địa.", "Đã đối chiếu campaignTransaction; E2E kỹ thuật, sales canary." ], [ "FTA RuntimeStore", "Store riêng có snapshot / audit / retention", "State, evidence, policy và runtime trong scope của FTA.", "Bản bounded store đang healthy; backup lớn cần xác minh offline." ], [ "Redis / queue và vector store", "Hạ tầng FTC chuyên biệt", "Hỗ trợ queue/cache và truy hồi; không tự là canonical authority.", "Container Redis đang chạy; Qdrant healthy. Chưa benchmark toàn bộ pipeline." ], [ "FarmTruth Station", "PostgreSQL và phụ thuộc riêng", "Seller, lot, evidence và supply-chain records thuộc FarmTruth.", "PG healthy; một số phụ thuộc khác đang dừng; không chứng nhận pipeline toàn phần." ] ], "contracts": [ [ "Phiên và context", "Workspace / brand trong URL là yêu cầu ngữ cảnh, không phải quyền. API kiểm principal và object scope." ], [ "FTA-native", "Cùng StateRef, version/hash và evidence khi chuyển Feed / Diagram / Workbook; adapter không là writer thứ hai." ], [ "Command / event", "Nghiệp vụ + event + command receipt cùng transaction; key và payload hash cho replay; CAS phát hiện bản cũ." ], [ "Commercial event", "flytrust.commercial-event.v1 có origin, domain, tenant, event time, receipt time và correlation; producer coverage vẫn còn một phần." ], [ "Dữ liệu và consent", "Source và receiver grant theo purpose/resource; cùng Gmail không cấp quyền. Thu hồi consent phải bền vững qua replay." ], [ "Tiền và thuế", "Order / won / ACK không xác nhận tiền. Provider receipt phải khớp merchant, order, currency, origin và chữ ký." ], [ "Publishing", "AI draft → human approval → provider dispatch → receipt/readback. Lịch được nhận chưa đồng nghĩa đã xuất bản." ], [ "Nghiên cứu", "Actual / estimated / simulated / desired và epistemic status tách biệt. Thiếu nguồn thì UNKNOWN / ABSTAIN." ] ], "risks": [ [ "P0", "Nguồn và provider thật", "Merchant payment, Market intake và sales→FTA chưa được mở; không suy diễn từ adapter hoặc fixture." ], [ "P0", "Nghiệm thu UI toàn phần", "Production mới xác minh đọc Tổng quan / Báo giá. Các vòng ghi business E2E thuộc môi trường cô lập." ], [ "P0", "Authority và normalized event", "Mission/PG và Campaign–Sales/SQLite không được dual-write tùy tiện. Chưa suy ra lịch sử revenue/outcome từ active status." ], [ "P1", "Đóng gói và rollback", "FTC image có 127 lớp sau UI r2; release tiếp theo cần nền hợp nhất có provenance. Không tiếp tục chồng overlay." ], [ "P1", "FarmTruth dependencies", "Một số phụ thuộc source domain đang dừng tại snapshot; cần thẩm tra trước khi công bố readiness cho toàn bộ supply flow." ], [ "P1", "Quy mô FTA và backup", "Store đã được giới hạn bộ nhớ cho dữ liệu đã kiểm thử. Backup lớn và năng lực tăng trưởng cần kiểm chứng riêng." ], [ "Research", "Lợi thế thuật toán / hiệu quả", "Không có causal uplift, ROI, retention, CAC hoặc ranking AI được xác minh chỉ từ đợt triển khai kỹ thuật." ] ], "runtime": [ { "name": "FTC application", "release": "sales-ux-20261027-r2", "image": "sha256:a3221db009abf6bcc2954aa99dec6acb325fa534a78e7d7313b0c2f3df53d484", "status": "running", "restarts": 0, "health": "Health / ready 200", "scope": "Ứng dụng hiện hữu; Sales V3 canary một workspace" }, { "name": "FTA runtime", "release": "bounded-store-v3-20261026-r2", "image": "sha256:1ca9924404029247f49d4886b6f25c5fa8c7affd2b272ea2f2694dfecfde4295", "status": "running", "restarts": 0, "health": "healthy", "scope": "Shared state / evidence / runtime; không phải mọi domain flow đã nghiệm thu" } ], "links": [ [ "FTC Business Suite", "https://flytrustcontent.io.vn/dashboard/business" ], [ "State Feed", "https://flytrustcontent.io.vn/dashboard/intelligence" ], [ "Workbook vận hành", "https://workbook.flytrustcontent.io.vn/" ], [ "Diagram vận hành", "https://diagram.flytrustcontent.io.vn/" ], [ "FTA console", "https://flytrust-agent.io.vn/platform/" ], [ "FarmTruth Market", "https://market.farmtruth-station.io.vn/market" ] ], "flags": [ [ "Sales workspace", "Canary đang bật" ], [ "Đổi trang mặc định sang Sales", "OFF" ], [ "Merchant payment thật", "OFF" ], [ "Market → tenant Sales intake", "OFF" ], [ "Commercial Sales → FTA", "OFF" ], [ "Public copy V3 mới", "OFF" ] ], "references": [ "docs/platform/FLYTRUST_OFFICIAL_PLATFORM_THESIS.md", "docs/thesis/FLYTRUST_OFFICIAL_THESIS_V3.md", "docs/strategic-realignment-2026-10/FLYTRUST_ARCHITECTURE_DECISION_REGISTER.md", "docs/audit/FLYTRUST_V3_IMPLEMENTATION_REPORT.md", "docs/audit/FLYTRUST_V3_PLATFORM_GAP_MATRIX.md", "docs/architecture/FLYTRUST_COMMERCIAL_EVENT_CONTRACT.md", "docs/releases/FTC_SALES_UI_UX_2026-10-27.md" ] }