Skip to content

Latest commit

 

History

History
536 lines (453 loc) · 23.5 KB

PROGRESS.md

File metadata and controls

536 lines (453 loc) · 23.5 KB

Tiến độ dịch JavaGuide → Tiếng Việt

Nguồn sự thật duy nhất về trạng thái dịch. Agent/người nào tiếp tục công việc: đọc file này đầu tiên. Luật dịch: ../CLAUDE.md · Thuật ngữ: GLOSSARY.md

Nội dung: 444/444 file · Hạ tầng site: xong · Cập nhật: 2026-09-18

Ký hiệu: [ ] chưa dịch · [x] xong · [~] đang dịch


🚦 BẮT ĐẦU TỪ ĐÂY

File tiếp theo cần dịch: Không còn file chưa dịch.

Xem toàn bộ việc còn lại: make sync

Quy trình mỗi file:

  1. Đọc file gốc: cat docs/<path> (CodeGraph KHÔNG index .md, xem CLAUDE.md §6)
  2. Dịch → ghi vào vi/<path> (đúng đường dẫn mirror)
  3. Verify chữ Hán: make check → chỉ được còn ngoại lệ ở CLAUDE.md §3.3.1
  4. Fix YAML frontmatter (CLAUDE.md §3.1.1 — bắt buộc, nếu không sẽ fail build)
  5. make vi-build → phải "success"
  6. Đánh dấu [x] vào file này + cập nhật số đếm ở trên

Lệnh

Lệnh Việc
make help Danh sách lệnh
make cn-dev Site tiếng Trung → localhost:8080
make vi-dev Site tiếng Việt → localhost:8081/vi/
make build Build cả hai site
make sync Sau git pull: file nào mới / gốc nào đã đổi
make check Quét chữ Hán còn sót

⚠️ KHÔNG dùng pnpm vi:dev — script đã bị gỡ khỏi package.json để tránh conflict khi pull upstream. Dùng make (xem CLAUDE.md §9).


✅ Hạ tầng site VuePress (HOÀN TẤT — đã build thành công)

Chi tiết: ../CLAUDE.md §8.

  • .vuepress/config.ts — base:"/vi/", dest:"./dist/vi", lang:"vi-VN", loại PROGRESS/GLOSSARY khỏi pages
  • .vuepress/theme.ts — docsDir:"vi", SEO/JSON-LD tiếng Việt, canonical /vi, trimDescription() đổi sang dấu câu Latin, legacyRedirects làm rỗng, linksCheck hạ xuống warn
  • .vuepress/navbar.ts — dịch xong
  • .vuepress/sidebar/ — 11 file, dịch xong toàn bộ (289 chuỗi)
  • .vuepress/components/ — dịch chuỗi UI (LayoutToggle, unlock ×2, LazyMermaid, ClickImagePreview)
  • .vuepress/features/unlock/ — dịch comment
  • .vuepress/styles/ — dịch comment (SCSS giữ nguyên → UI y hệt bản gốc)
  • .vuepress/public/ — copy nguyên (logo, favicon, icon)
  • package.json — đã revert về nguyên bản (zero-conflict, xem CLAUDE.md §9)
  • Makefile — toàn bộ lệnh, thay cho npm scripts
  • i18n/lang-switch/ — nút chuyển ngôn ngữ CN | VI trên cả hai site
  • i18n/cn.config.ts — wrapper config, chèn nút vào site CN mà không sửa docs/
  • i18n/sync-check.mjs — báo cáo file chưa dịch / gốc đã đổi sau khi pull

Kiểm chứng đã chạy:

  • make vi-build → success, 11 trang, asset prefix /vi/, <html lang="vi-VN">
  • make cn-build → success, 641 trang, wrapper config load được config upstream
  • Toggle: trang đã dịch → link đúng trang tương ứng; trang chưa dịch → nút VI mờ, trỏ về /vi/ (không link gãy)
  • git diff rỗng hoàn toàn → pull upstream không conflict

⚠️ Việc phải làm khi dịch xong toàn bộ: đổi linksCheck.build từ "warn" về "error" trong vi/.vuepress/theme.ts.


Giai đoạn 0 — Snippets (dùng chung) ✅ 7/7

  • snippets/article-header.snippet.md
  • snippets/article-footer.snippet.md
  • snippets/small-advertisement.snippet.md
  • snippets/planet.snippet.md
  • snippets/planet2.snippet.md
  • snippets/rag-project.snippet.md
  • snippets/yuanma.snippet.md

Giai đoạn 1 — Trục lộ trình học · 8/8 ✅

  • README.md — trang chủ
  • home.md — mục lục tổng
  • roadmap/README.md — tổng hợp lộ trình
  • roadmap/java-roadmap.md — ⭐ lộ trình Java backend (77KB)
  • roadmap/java-to-ai-roadmap.md — lộ trình AI cho dev Java/Go (63KB)
  • roadmap/backend-to-ai-agent-roadmap.md — đề xuất chuyển từ backend sang AI Agent
  • roadmap/full-stack-roadmap.md — lộ trình full-stack
  • roadmap/test-development-roadmap.md — lộ trình phát triển và kiểm thử

Giai đoạn 2 — Java core · 80/80 ✅

2.0 Mục lục

  • java/README.md

2.1 Java Basics (15)

  • java/basis/README.md
  • java/basis/java-basic-questions-01.md (70KB)
  • java/basis/java-basic-questions-02.md (47KB)
  • java/basis/java-basic-questions-03.md
  • java/basis/java-keyword-summary.md
  • java/basis/why-there-only-value-passing-in-java.md
  • java/basis/generics-and-wildcards.md
  • java/basis/reflection.md
  • java/basis/proxy.md
  • java/basis/spi.md
  • java/basis/serialization.md
  • java/basis/bigdecimal.md
  • java/basis/money-long-vs-bigdecimal.md
  • java/basis/unsafe.md
  • java/basis/syntactic-sugar.md

2.2 Collection (13) ✅

  • java/collection/README.md
  • java/collection/java-collection-questions-01.md
  • java/collection/java-collection-questions-02.md
  • java/collection/java-collection-precautions-for-use.md
  • java/collection/arraylist-source-code.md
  • java/collection/linkedlist-source-code.md
  • java/collection/hashmap-source-code.md
  • java/collection/concurrent-hash-map-source-code.md
  • java/collection/linkedhashmap-source-code.md
  • java/collection/copyonwritearraylist-source-code.md
  • java/collection/arrayblockingqueue-source-code.md
  • java/collection/priorityqueue-source-code.md
  • java/collection/delayqueue-source-code.md

2.3 Concurrent (17) ✅

  • java/concurrent/README.md
  • java/concurrent/java-concurrent-questions-01.md
  • java/concurrent/java-concurrent-questions-02.md (66KB)
  • java/concurrent/java-concurrent-questions-03.md (97KB)
  • java/concurrent/jmm.md
  • java/concurrent/java-lock.md
  • java/concurrent/optimistic-lock-and-pessimistic-lock.md
  • java/concurrent/cas.md
  • java/concurrent/aqs.md (104KB)
  • java/concurrent/reentrantlock.md (48KB)
  • java/concurrent/atomic-classes.md
  • java/concurrent/threadlocal.md
  • java/concurrent/java-thread-pool-summary.md (52KB)
  • java/concurrent/java-thread-pool-best-practices.md
  • java/concurrent/java-concurrent-collections.md
  • java/concurrent/completablefuture-intro.md
  • java/concurrent/virtual-thread.md

2.4 JVM (11) ✅

  • java/jvm/README.md
  • java/jvm/memory-area.md
  • java/jvm/jvm-garbage-collection.md
  • java/jvm/class-file-structure.md
  • java/jvm/class-loading-process.md
  • java/jvm/classloader.md
  • java/jvm/jvm-parameters-intro.md
  • java/jvm/jvm-intro.md
  • java/jvm/jdk-monitoring-and-troubleshooting-tools.md
  • java/jvm/jvm-in-action.md
  • java/jvm/jvm-interview-questions.md

2.5 IO (5) ✅

  • java/io/README.md
  • java/io/io-basis.md
  • java/io/io-design-patterns.md
  • java/io/io-model.md
  • java/io/nio-basis.md

2.6 New Features (18) ✅

  • java/new-features/README.md
  • java/new-features/java8-common-new-features.md
  • java/new-features/java8-tutorial-translate.md
  • java/new-features/java9.md
  • java/new-features/java10.md
  • java/new-features/java11.md
  • java/new-features/java12-13.md
  • java/new-features/java14-15.md
  • java/new-features/java16.md
  • java/new-features/java17.md
  • java/new-features/java18.md
  • java/new-features/java19.md
  • java/new-features/java20.md
  • java/new-features/java21.md
  • java/new-features/java22-23.md
  • java/new-features/java24.md
  • java/new-features/java25.md
  • java/new-features/java26.md

Giai đoạn 3 — CS basics · 68 file đã dịch

Network

  • cs-basics/network/README.md
  • cs-basics/network/osi-and-tcp-ip-model.md
  • cs-basics/network/application-layer-protocol.md
  • cs-basics/network/tcp-connection-and-disconnection.md
  • cs-basics/network/tcp-byte-stream-udp-datagram.md
  • cs-basics/network/http1.0-vs-http1.1.md
  • cs-basics/network/other-network-questions.md
  • cs-basics/network/other-network-questions2.md
  • cs-basics/network/the-whole-process-of-accessing-web-pages.md
  • cs-basics/network/http-vs-https.md
  • cs-basics/network/https-rsa-vs-ecdhe.md
  • cs-basics/network/http-status-codes.md
  • cs-basics/network/tcp-reliability-guarantee.md
  • cs-basics/network/tcp-time-wait.md
  • cs-basics/network/tcp-keepalive-vs-http-keepalive.md
  • cs-basics/network/dns.md
  • cs-basics/network/http-vs-rpc.md
  • cs-basics/network/arp.md
  • cs-basics/network/nat.md
  • cs-basics/network/network-attack-means.md
  • cs-basics/network/computer-network-xiexiren-summary.md
  • cs-basics/network/can-ping-but-tcp-may-not-connect.md
  • cs-basics/network/can-tcp-and-udp-use-the-same-port.md
  • cs-basics/network/maximum-number-of-tcp-connections-per-host.md

Operating System

  • cs-basics/operating-system/README.md
  • cs-basics/operating-system/operating-system-basic-questions-01.md
  • cs-basics/operating-system/operating-system-basic-questions-02.md
  • cs-basics/operating-system/process-and-thread.md
  • cs-basics/operating-system/interrupt-exception-syscall.md
  • cs-basics/operating-system/cpu-scheduling-and-load.md
  • cs-basics/operating-system/ipc.md
  • cs-basics/operating-system/os-lock-and-sync.md
  • cs-basics/operating-system/dead-lock.md
  • cs-basics/operating-system/memory-management.md
  • cs-basics/operating-system/virtual-memory.md
  • cs-basics/operating-system/file-system.md
  • cs-basics/operating-system/io-multiplexing.md
  • cs-basics/operating-system/zero-copy.md
  • cs-basics/operating-system/linux-intro.md
  • cs-basics/operating-system/shell-intro.md

Algorithms

  • cs-basics/algorithms/README.md
  • cs-basics/algorithms/complexity-analysis.md
  • cs-basics/algorithms/binary-search.md
  • cs-basics/algorithms/two-pointers-and-sliding-window.md
  • cs-basics/algorithms/dfs-bfs.md
  • cs-basics/algorithms/backtracking.md
  • cs-basics/algorithms/dynamic-programming.md
  • cs-basics/algorithms/greedy.md
  • cs-basics/algorithms/top-k.md
  • cs-basics/algorithms/string-algorithm-problems.md
  • cs-basics/algorithms/linkedlist-algorithm-problems.md
  • cs-basics/algorithms/10-classical-sorting-algorithms.md
  • cs-basics/algorithms/classical-algorithm-problems-recommendations.md
  • cs-basics/algorithms/common-data-structures-leetcode-recommendations.md
  • cs-basics/algorithms/the-sword-refers-to-offer.md

Data Structure

  • cs-basics/data-structure/README.md
  • cs-basics/data-structure/linear-data-structure.md
  • cs-basics/data-structure/hash-table.md
  • cs-basics/data-structure/tree.md
  • cs-basics/data-structure/heap.md
  • cs-basics/data-structure/red-black-tree.md
  • cs-basics/data-structure/skip-list.md
  • cs-basics/data-structure/trie.md
  • cs-basics/data-structure/union-find.md
  • cs-basics/data-structure/bloom-filter.md
  • cs-basics/data-structure/graph.md
  • cs-basics/data-structure/lru-cache.md

Giai đoạn 4 — Database · 44 file đã dịch

  • database/README.md, database/basis.md, database/nosql.md, database/character-set.md
  • database/mysql/ — 16 file đã dịch
  • database/redis/ — 13 file đã dịch
  • database/sql/ — 7 file đã dịch
  • database/mongodb/ — 3 file đã dịch
  • database/elasticsearch/elasticsearch-questions-01.md
  • database/mysql/mysql-questions-01.md
  • database/redis/3-commonly-used-cache-read-and-write-strategies.md

Giai đoạn 5 — System design · 36 file đã dịch

  • system-design/ — 36 file đã dịch

Giai đoạn 6 — Distributed system · 28 file đã dịch

  • distributed-system/ — các file nền tảng và protocol đã dịch trước đó
  • distributed-system/microservices-interview-questions.md
  • distributed-system/rpc/README.md
  • distributed-system/rpc/rpc-intro.md
  • distributed-system/rpc/dubbo.md
  • distributed-system/api-gateway.md
  • distributed-system/spring-cloud-gateway-questions.md
  • distributed-system/distributed-id.md
  • distributed-system/distributed-id-design.md
  • distributed-system/distributed-lock.md
  • distributed-system/distributed-lock-implementations.md
  • distributed-system/distributed-transaction.md
  • distributed-system/distributed-configuration-center.md
  • distributed-system/distributed-process-coordination/zookeeper/README.md
  • distributed-system/distributed-process-coordination/zookeeper/zookeeper-intro.md
  • distributed-system/distributed-process-coordination/zookeeper/zookeeper-plus.md
  • distributed-system/distributed-process-coordination/zookeeper/zookeeper-in-action.md

Giai đoạn 6 — High-performance · 15/15 ✅

  • high-performance/high-performance-system-interview-questions.md
  • high-performance/cdn.md
  • high-performance/load-balancing.md
  • high-performance/read-and-write-separation-and-library-subtable.md
  • high-performance/sql-optimization.md
  • high-performance/deep-pagination-optimization.md
  • high-performance/message-queue/message-queue-interview-questions.md
  • high-performance/message-queue/message-queue.md
  • high-performance/message-queue/kafka-questions-01.md
  • high-performance/message-queue/rocketmq-questions.md
  • high-performance/message-queue/rabbitmq-questions.md
  • high-performance/message-queue/disruptor-questions.md
  • high-performance/data-cold-hot-separation.md
  • high-performance/README.md
  • high-performance/message-queue/README.md

High-availability · 9/9 ✅

  • high-availability/README.md
  • high-availability/limit-request.md
  • high-availability/idempotency.md
  • high-availability/redundancy.md
  • high-availability/high-availability-system-interview-questions.md
  • high-availability/fallback-and-circuit-breaker.md
  • high-availability/performance-test.md
  • high-availability/high-availability-system-design.md
  • high-availability/timeout-and-retry.md

Giai đoạn 7 — AI · 38/38 ✅

  • ai/README.md
  • ai/ai-core-concepts.md
  • ai/interview-questions/README.md
  • ai/interview-questions/ai-interview-guide.md
  • ai/llm-basis/README.md
  • ai/llm-basis/llm-operation-mechanism.md
  • ai/llm-basis/llm-api-engineering.md
  • ai/agent/README.md
  • ai/agent/agent-basis.md
  • ai/agent/prompt-engineering.md
  • ai/agent/context-engineering.md
  • ai/agent/multi-agent.md
  • ai/rag/README.md
  • ai/rag/rag-basis.md
  • ai/rag/rag-document-processing.md
  • ai/rag/rag-optimization.md
  • ai/system-design/README.md
  • ai/system-design/ai-application-architecture.md
  • ai/system-design/llm-security.md
  • ai/system-design/llm-gateway.md
  • ai/llm-basis/structured-output-function-calling.md
  • ai/llm-basis/llm-evaluation.md
  • ai/agent/agent-memory.md
  • ai/agent/skills.md
  • ai/agent/mcp.md
  • ai/agent/harness-engineering.md
  • ai/agent/workflow-graph-loop.md
  • ai/agent/loop-engineering.md
  • ai/rag/rag-vector-store.md
  • ai/rag/graphrag.md
  • ai/rag/rag-knowledge-update.md
  • ai/system-design/ai-observability.md
  • ai/system-design/ai-voice.md
  • ai/interview-questions/llm-interview-questions.md
  • ai/interview-questions/agent-interview-questions.md
  • ai/interview-questions/agent-project-interview-guide.md
  • ai/interview-questions/rag-interview-questions.md
  • ai/interview-questions/ai-system-design-interview-questions.md

AI coding · 28/28 ✅

  • ai-coding/README.md
  • ai-coding/practices/ai-ide.md
  • ai-coding/practices/cli-vs-ide.md
  • ai-coding/practices/ghostty.md
  • ai-coding/practices/claudecode-tips.md
  • ai-coding/practices/claudecode-commands.md
  • ai-coding/practices/oh-my-pi.md
  • ai-coding/practices/claudecode-agentview.md
  • ai-coding/practices/claude-md-best-practices.md
  • ai-coding/principles/claude-code-context-management.md
  • ai-coding/principles/claude-code-memory.md
  • ai-coding/principles/claude-code-skills.md
  • ai-coding/principles/claude-code-hooks.md
  • ai-coding/principles/claude-code-multi-agent.md
  • ai-coding/practices/programmer-essential-skills.md
  • ai-coding/practices/skill-selection-and-pruning.md
  • ai-coding/practices/mattpocock-skills.md
  • ai-coding/practices/drawio-chart-skill.md
  • ai-coding/practices/codex-best-practices.md
  • ai-coding/practices/spec-coding.md
  • ai-coding/practices/the-cool-tricks-for-vibe-coding.md
  • ai-coding/cases/idea-qoder-plugin.md
  • ai-coding/cases/trae-m2.7.md
  • ai-coding/cases/cc-glm5.1.md
  • ai-coding/cases/deepseek-v4-claude-code.md
  • ai-coding/cases/cc-m3.md
  • ai-coding/cases/kimi-k3.md
  • ai-coding/project/cc-guide.md

Tools · 11/11 ✅

  • tools/README.md
  • tools/maven/README.md
  • tools/maven/maven-core-concepts.md
  • tools/maven/maven-best-practices.md
  • tools/gradle/gradle-core-concepts.md
  • tools/git/README.md
  • tools/git/git-intro.md
  • tools/git/github-tips.md
  • tools/docker/README.md
  • tools/docker/docker-intro.md
  • tools/docker/docker-in-action.md

Books · 7/7 ✅

  • books/README.md
  • books/cs-basics.md
  • books/database.md
  • books/distributed-system.md
  • books/java.md
  • books/search-engine.md
  • books/software-quality.md

Interview preparation · 13/13 ✅

  • interview-preparation/README.md
  • interview-preparation/backend-interview-plan.md
  • interview-preparation/backend-project-interview-guide.md
  • interview-preparation/how-to-handle-interview-nerves.md
  • interview-preparation/internship-experience.md
  • interview-preparation/interview-experience.md
  • interview-preparation/java-roadmap.md
  • interview-preparation/key-points-of-interview.md
  • interview-preparation/pdf-interview-javaguide.md
  • interview-preparation/project-experience-guide.md
  • interview-preparation/resume-guide.md
  • interview-preparation/self-test-of-common-interview-questions.md
  • interview-preparation/teach-you-how-to-prepare-for-the-interview-hand-in-hand.md

High-quality technical articles · 27/27 ✅

  • high-quality-technical-articles/README.md
  • high-quality-technical-articles/advanced-programmer/20-bad-habits-of-bad-programmers.md
  • high-quality-technical-articles/advanced-programmer/meituan-three-year-summary-lesson-10.md
  • high-quality-technical-articles/advanced-programmer/programmer-quickly-learn-new-technology.md
  • high-quality-technical-articles/advanced-programmer/seven-tips-for-becoming-an-advanced-programmer.md
  • high-quality-technical-articles/advanced-programmer/ten-years-of-dachang-growth-road.md
  • high-quality-technical-articles/advanced-programmer/the-growth-strategy-of-the-technological-giant.md
  • high-quality-technical-articles/advanced-programmer/thinking-about-technology-and-business-after-five-years-of-work.md
  • high-quality-technical-articles/interview/how-to-examine-the-technical-ability-of-programmers-in-the-first-test-of-technology.md
  • high-quality-technical-articles/interview/my-personal-experience-in-2021.md
  • high-quality-technical-articles/interview/screen-candidates-for-packaging.md
  • high-quality-technical-articles/interview/some-secrets-about-alibaba-interview.md
  • high-quality-technical-articles/interview/summary-of-spring-recruitment.md
  • high-quality-technical-articles/interview/technical-preliminary-preparation.md
  • high-quality-technical-articles/interview/the-experience-and-thinking-of-an-interview-experienced-by-an-older-programmer.md
  • high-quality-technical-articles/interview/the-experience-of-get-offer-from-over-20-big-companies.md
  • high-quality-technical-articles/personal-experience/8-years-programmer-work-summary.md
  • high-quality-technical-articles/personal-experience/four-year-work-in-tencent-summary.md
  • high-quality-technical-articles/personal-experience/huawei-od-275-days.md
  • high-quality-technical-articles/personal-experience/two-years-of-back-end-develop--experience-in-didi-and-toutiao.md
  • high-quality-technical-articles/programmer/efficient-book-publishing-and-practice-guide.md
  • high-quality-technical-articles/programmer/high-value-certifications-for-programmers.md
  • high-quality-technical-articles/programmer/how-do-programmers-publish-a-technical-book.md
  • high-quality-technical-articles/programmer/programmer-career-directions.md
  • high-quality-technical-articles/work/32-tips-improving-career.md
  • high-quality-technical-articles/work/employee-performance.md
  • high-quality-technical-articles/work/get-into-work-mode-quickly-when-you-join-a-company.md

About the author · 11/11 ✅

  • about-the-author/README.md
  • about-the-author/deprecated-java-technologies.md
  • about-the-author/dog-that-copies-other-people-essay.md
  • about-the-author/feelings-after-one-month-of-induction-training.md
  • about-the-author/feelings-of-half-a-year-from-graduation-to-entry.md
  • about-the-author/internet-addiction-teenager.md
  • about-the-author/javaguide-100k-star.md
  • about-the-author/my-article-was-stolen-and-made-into-video-and-it-became-popular.md
  • about-the-author/my-college-life.md
  • about-the-author/writing-technology-blog-six-years.md
  • about-the-author/zhishixingqiu-two-years.md

JavaGuide · 5/5 ✅

  • javaguide/contribution-guideline.md
  • javaguide/faq.md
  • javaguide/history.md
  • javaguide/intro.md
  • javaguide/use-suggestion.md

Open-source project · 8/8 ✅

  • open-source-project/README.md
  • open-source-project/big-data.md
  • open-source-project/machine-learning.md
  • open-source-project/practical-project.md
  • open-source-project/system-design.md
  • open-source-project/tool-library.md
  • open-source-project/tools.md
  • open-source-project/tutorial.md

Zhuanlan · 6/6 ✅

  • zhuanlan/README.md
  • zhuanlan/back-end-interview-high-frequency-system-design-and-scenario-questions.md
  • zhuanlan/handwritten-rpc-framework.md
  • zhuanlan/interview-guide.md
  • zhuanlan/java-mian-shi-zhi-bei.md
  • zhuanlan/source-code-reading.md

Kiểm định ngữ nghĩa

  • Đối chiếu toàn bộ các file đã dịch trong roadmap, Java core, CS basics, Database, System design và Distributed system với file gốc.
  • Sửa các lỗi sai nghĩa, thiếu ý, thêm ý, sai công thức, sai thuật ngữ, sai URL và sai ngữ cảnh đã phát hiện.
  • make vi-build — thành công sau kiểm định.

Đã hoàn tất toàn bộ 444 file tài liệu.