EconSim là nền tảng mô phỏng đồ thị tương tác cho cả hai môn Kinh tế học Vi mô và Kinh tế học Vĩ mô trong chương trình Thạc sĩ Chính sách công (MPP28) tại FSPPM.
Vì giới hạn context ngữ nghĩa, tài liệu của hai môn được tách thành 2 notebook riêng biệt trên NotebookLM. Tuy nhiên, về mặt học thuật và phân tích chính sách, vi mô và vĩ mô luôn bổ trợ trực tiếp cho nhau: • Hành vi tối ưu hóa của hộ gia đình và doanh nghiệp ở vi mô là nền tảng vi mô (microfoundations) cho tiêu dùng, đầu tư, tổng cung và thị trường lao động ở vĩ mô. • Các cú sốc chính sách vĩ mô (lãi suất, tỷ giá, thuế, chi tiêu công) lại làm dịch chuyển đường ngân sách, chi phí vốn và cấu trúc thị trường của từng tác nhân vi mô.
Do đó, EconSim dùng chung một khung đồ thị (SVG Graph Primitives) và một khung giao diện (React UI Shell), trong khi chia tầng tính toán và tình huống thành hai nhánh rõ ràng (micro và macro) kèm cơ chế liên kết chéo (related_scenarios).
Khi thêm một tình huống mới (dù là vi mô hay vĩ mô), agent không cần đọc lại toàn bộ codebase mà chỉ cần đọc 4 file:
• AGENTS.md (quy tắc kiến trúc và hợp đồng module)
• docs/IMPLEMENTATION_PLAN.md (chi tiết kỹ thuật và phân công task)
• src/scenarios/registry.ts (danh mục các module hiện có)
• Một module mẫu gần nhất để clone cấu trúc
• NotebookLM Title: Kinh tế học vi mô 1 - MPP28
• NotebookLM ID: e8a30630-0df2-4932-8740-9ffe7d8882bc
• Sources chủ chốt: Đề cương môn học (f2cc2f7e-a86f-4887-a533-ef8e8511dbe0), SAB Ch.1 (5b1481d8-2643-4657-9bdb-3ada79c21b8a) và 48 tài liệu bài đọc/tình huống.
• Giáo trình chuẩn (APA 7):
• Pindyck, R. S., & Rubinfeld, D. L. (2015). Kinh tế học vi mô (Ấn bản lần thứ 8). NXB Đại học Kinh tế TP.HCM.
• Steinemann, A. C., Apgar, W. C., & Brown, H. J. (2005). Microeconomics for public decisions. Thomson/South-Western.
• Mankiw, N. G. (2014). Nguyên lý kinh tế học. NXB Hồng Đức.
• Các nhóm mô hình cốt lõi theo đề cương:
• Hành vi người tiêu dùng (PR Ch.3): Đường ngân sách, đường bàng quan, định lượng, giá trần thiếu hụt, giải pháp góc, trợ cấp hiện vật vs tiền mặt.
• Cung cầu và phúc lợi thị trường (PR Ch.2, Ch.9): Độ co giãn, thặng dư tiêu dùng/sản xuất, thuế, trợ cấp, giá trần/sàn, tổn thất vô ích (DWL).
• Sản xuất, chi phí và cấu trúc thị trường (PR Ch.6 đến Ch.12): Cạnh tranh hoàn hảo, độc quyền bán, định giá theo sức mạnh thị trường, độc quyền nhóm.
• Thất bại thị trường (PR Ch.17, Ch.18; SAB Ch.9, Ch.10): Thông tin bất cân xứng, ngoại tác, hàng hóa công (cộng dọc đường cầu).
• NotebookLM Title: Kinh tế học vĩ mô - MPP28
• NotebookLM ID: 99090327-f66b-4d8d-8b9e-a3c00acb599f
• Sources chủ chốt: Đề cương môn học (dc45b706-3302-47c0-9bf4-5a43571e58b7) và 88 tài liệu bài đọc/tình huống.
• Giáo trình chuẩn (APA 7):
• Mankiw, N. G. (2019). Macroeconomics (10th ed.). Worth Publishers.
• Blanchard, O. (2017). Macroeconomics (7th ed.). Pearson.
• Krugman, P. R., Obstfeld, M., & Melitz, M. J. (2015). International economics: Theory and policy (10th ed.). Pearson.
• Moss, D. A. (2014). A concise guide to macroeconomics (2nd ed.). Harvard Business School Press.
• Châu, V. T. (2017). Những câu chuyện ngắn về kinh tế vĩ mô (Tập 1). NXB Đại học Quốc gia TP.HCM.
• Các nhóm mô hình cốt lõi theo đề cương:
• Ngắn hạn & Chu kỳ kinh tế: Giao điểm Keynes, thị trường tiền tệ, khủng hoảng ngân hàng Diamond Dybvig, Đường Phillips & Định luật Okun, mô hình IS LM, mô hình AS AD, phối hợp chính sách tài khóa và tiền tệ.
• Kinh tế mở: Cán cân thanh toán (BOP), ngang bằng sức mua (PPP), ngang bằng lãi suất (IRP), bộ ba bất khả thi, mô hình Mundell Fleming.
• Dài hạn: Mô hình tăng trưởng Solow, mô hình tăng trưởng nội sinh, bẫy thu nhập trung bình.
• [x] Phân tích file mẫu reference/micro_macro_animation_legacy.html và chẩn đoán lỗi toán/cấu trúc
• [x] Thiết lập thư mục dự án /opt/ai-os/products/ceo/projects/fsppm/econ_sim/ (kèm symlink /root/projects/fsppm/econ_sim và micro_sim)
• [x] Hoàn thiện bộ tài liệu nền tảng: README.md, AGENTS.md, docs/APP_CONTEXT.md, docs/MODULE_MIGRATION.md, docs/WORKFLOW.md, docs/IMPLEMENTATION_PLAN.md
• [x] Task 1: Khởi tạo Vite + TypeScript + React + Tailwind + KaTeX + Vitest
• [x] Task 2: Xây dựng Engine Layer (engine/shared/ và engine/micro/) + Unit tests bất biến (22/22 passed)
• [x] Task 3: Xây dựng SVG Graph Primitives (src/graph/)
• [x] Task 4: Xây dựng React UI Shell (src/ui/)
• [x] Task 5: Chuyển đổi 4 module vi mô & cầu nối đầu tiên (rationing, price_ceiling, corner_solution, inkind_vs_cash) + Unit tests kịch bản (62/62 passed)
• [x] Task 6: Build tĩnh, cấu hình Nginx route (/econ-sim/ & /micro-sim/) và kiểm thử qua Tailscale Funnel (HTTP 200)
• [ ] Giai đoạn tiếp theo: Bổ sung module Cung Cầu / Phúc lợi (Vi mô) và IS LM / Mundell Fleming (Vĩ mô)
• Thư mục vật lý: /opt/ai-os/products/ceo/projects/fsppm/econ_sim/
• Symlink tiện lợi: /root/projects/fsppm/econ_sim (và /root/projects/fsppm/micro_sim)
• Bản build tĩnh: /opt/ai-os/products/ceo/projects/fsppm/econ_sim/dist/
• Cấu hình Nginx: Thêm block location /econ-sim/ (và alias /micro-sim/) trong /etc/nginx/sites-available/hermes-dashboard (port 9121) trỏ vào thư mục dist/
• Public URL qua Tailscale Funnel: https://vmi3427693.tail8c1aaf.ts.net/econ-sim/