← Về thư mục
📄 / / projects / fsppm / micro_sim / README.md

EconSim: Bộ Mô Phỏng Kinh Tế Tương Tác (FSPPM MPP28)

Ứng dụng mô phỏng đồ thị tương tác cho cả Kinh tế Vi mô và Kinh tế Vĩ mô, phục vụ chương trình MPP28 tại Trường Chính sách công và Quản lý Fulbright (FSPPM).

Vi mô và Vĩ mô được quản lý kiến thức trên 2 notebook NotebookLM riêng biệt (do giới hạn context ngữ nghĩa), nhưng bổ trợ lẫn nhau trong cùng một app. Các module vi mô và vĩ mô dùng chung lớp đồ thị (graph) và giao diện (ui), còn engine được tổ chức theo 2 nhánh engine/micro/ và engine/macro/.

Tài liệu nền tảng (đọc theo thứ tự)

  1. AGENTS.md: Quy tắc kiến trúc 4 lớp, hợp đồng module, bất biến kinh tế
  2. docs/APP_CONTEXT.md: Trạng thái dự án, stack, hạ tầng, liên kết 2 notebook NotebookLM
  3. docs/MODULE_MIGRATION.md: Phân tích bản gốc và đặc tả toán học đã fix cho 3 module vi mô đầu tiên
  4. docs/WORKFLOW.md: Quy trình thêm module mới hoặc clone module từ bên ngoài
  5. docs/IMPLEMENTATION_PLAN.md: Kế hoạch thực thi chi tiết, phân chia task, bàn giao cho agent

Cấu trúc thư mục

econ_sim/
  AGENTS.md                             # Luật kiến trúc và hợp đồng module
  README.md                             # File này
  docs/
    APP_CONTEXT.md                      # Trạng thái app, lộ trình, hạ tầng
    MODULE_MIGRATION.md                 # Chẩn đoán code cũ & công thức đã fix
    WORKFLOW.md                         # Quy trình làm việc tiết kiệm context
    IMPLEMENTATION_PLAN.md              # Kế hoạch thực thi và bàn giao chi tiết
  reference/
    micro_macro_animation_legacy.html   # File HTML gốc từ Gemini để đối chiếu
  src/
    engine/
      shared/                           # Hàm dùng chung: glossary, types, math utils
      micro/                            # Lý thuyết người tiêu dùng, doanh nghiệp, thị trường
      macro/                            # IS LM, AD AS, Mundell Fleming, Solow, Phillips
    graph/                              # Khối vẽ SVG dùng chung cho cả micro và macro
    ui/                                 # Giao diện React dùng chung
    scenarios/
      micro/                            # Các module tình huống vi mô
        consumer/                       # Lý thuyết người tiêu dùng (3 module đầu tiên ở đây)
      macro/                            # Các module tình huống vĩ mô (tương lai)
      registry.ts                       # Tự động nhận module mới, sinh menu chia theo nhánh
  tests/                                # Kiểm tra bất biến kinh tế (Vitest)

Trạng thái hiện tại

Đang ở bước Scaffolding (đã chốt kế hoạch, cấu trúc thư mục và quy tắc; chưa viết code thực thi). Bắt đầu xây dựng từ 3 module vi mô. Module vĩ mô sẽ bổ sung khi cần.