Skip to content

docs: audit and align all documentation to actual Python/FastAPI code… - #1

Merged
Ethan-da-Tech-Wizard merged 1 commit into
mainfrom
claude/audit-documentation-xWYCv
Mar 5, 2026
Merged

Ethan-da-Tech-Wizard merged 1 commit into
mainfrom
claude/audit-documentation-xWYCv

Conversation

@Ethan-da-Tech-Wizard

Copy link
Copy Markdown
Owner

…base

The original planning docs described a C# ASP.NET Core + Python Flask dual-runtime architecture that was never implemented. The actual codebase is a single-process Python FastAPI application. Updated six documents to accurately reflect the implementation:

  • 03_functional_requirements: FR-ING-04 — embedding is in-process, not a Python worker subprocess
  • 04_system_requirements: replace entire C# backend section with Python/ FastAPI stack; remove .NET SDK prerequisite; fix performance attribution (PyMuPDF not PdfPig); update security/privacy and architecture constraints
  • 05_architecture: full rewrite — single-process FastAPI diagram; updated data-flow pipelines (no C#→Python HTTP calls); correct component table referencing actual source files; add missing /text-positions endpoint; remove non-existent Python worker API section and IPC bridge section
  • 06_scope_and_milestones: fix in-scope tech (PyMuPDF not PdfPig/C#); update M1/M2 milestone descriptions and gantt section labels
  • 07_repo_structure: replace C# project tree (QuickGuide.Api/, .sln, wwwroot/, python_worker/) with actual directory layout (src/main.py, src/services/, src/static/); update naming conventions and key dirs table
  • 08_risk_register: R-02 PdfPig→PyMuPDF; R-05 retitled and rewritten for single Python runtime; R-08 PdfPig→PyMuPDF; R-09 retitled and rewritten for FastAPI process startup failures

https://claude.ai/code/session_01SPUUZCfAfzQ7Kna5JGCZSD

…base

The original planning docs described a C# ASP.NET Core + Python Flask
dual-runtime architecture that was never implemented. The actual codebase
is a single-process Python FastAPI application. Updated six documents to
accurately reflect the implementation:

- 03_functional_requirements: FR-ING-04 — embedding is in-process, not a
  Python worker subprocess
- 04_system_requirements: replace entire C# backend section with Python/
  FastAPI stack; remove .NET SDK prerequisite; fix performance attribution
  (PyMuPDF not PdfPig); update security/privacy and architecture constraints
- 05_architecture: full rewrite — single-process FastAPI diagram; updated
  data-flow pipelines (no C#→Python HTTP calls); correct component table
  referencing actual source files; add missing /text-positions endpoint;
  remove non-existent Python worker API section and IPC bridge section
- 06_scope_and_milestones: fix in-scope tech (PyMuPDF not PdfPig/C#);
  update M1/M2 milestone descriptions and gantt section labels
- 07_repo_structure: replace C# project tree (QuickGuide.Api/, .sln,
  wwwroot/, python_worker/) with actual directory layout (src/main.py,
  src/services/, src/static/); update naming conventions and key dirs table
- 08_risk_register: R-02 PdfPig→PyMuPDF; R-05 retitled and rewritten for
  single Python runtime; R-08 PdfPig→PyMuPDF; R-09 retitled and rewritten
  for FastAPI process startup failures

https://claude.ai/code/session_01SPUUZCfAfzQ7Kna5JGCZSD
@Ethan-da-Tech-Wizard
Ethan-da-Tech-Wizard merged commit 182948a into main Mar 5, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants