cyclone

tyler/cyclone

Fork 0

Commit Graph

Author	SHA1	Message	Date
Tyler	561018c690	feat(sp8): outbound 837P serializer — full rebuild + round-trip tests - backend/src/cyclone/parsers/serialize_837.py — full-rebuild 837P serializer. Emits envelope (ISA/GS/ST/SE/GE/IEA + BHT) + submitter/receiver/billing provider/subscriber/payer hierarchy + editable segments (CLM/REFG1/HI) + per-service-line LX/SV1/DTP472/REF6R — all from canonical ClaimOutput fields. Pivoted from spec §3.1 hybrid to full rebuild because ClaimOutput.raw_segments only captures post-CLM segments (CLM, REFG1, HI, LX, SV1 pairs) — not the envelope or hierarchies. A pass-through approach cannot regenerate those without expanding raw_segments in parse_837.py (out of scope for this SP). - backend/tests/test_serialize_837.py — 36 tests covering envelope shape, hierarchy segments, claim-level builders, service-line builders, edited-field propagation, round-trip, custom sender/receiver IDs, and resubmit helper. - backend/tests/test_prodfiles_smoke.py::test_claims_prodfile_round_trip — every file in docs/prodfiles/claims/ (113 files) round-trips through serialize_837 → parse_837_text with deep-equal ClaimOutput (modulo validation, which is recomputed by the parser). - docs/superpowers/plans/2026-06-20-cyclone-serialize-837.md — full plan with amendment note documenting the Approach A pivot. Per session convention, plan note about unrelated modifications to parse_835.py / fixtures stashed separately.	2026-06-20 20:27:48 -06:00
Tyler	76278ec9f6	feat(ta1): TA1 interchange ACK parser, persistence, and API Adds full TA1 (Interchange Acknowledgment, X12 envelope-level) support to mirror the existing 999 transaction-set ACK pipeline. Parser & models - parsers/models_ta1.py: Pydantic Ta1Ack + ParseResultTa1 models (AckCode = Literal['A','E','R'], date serializer mirroring 999) - parsers/parse_ta1.py: TA1 segment parser - Tolerant YYMMDD (6-digit) + CCYYMMDD (8-digit) date handling for CO Medicaid interchange_date / ack_generated_date - 106-char ISA validation (15-char sender/receiver IDs) - source_batch_id = 'TA1-<ISA13>' Persistence - migrations/0005_create_ta1_acks.sql: ta1_acks table + indexes on source_batch_id and ack_code - db.py: Ta1Ack ORM model (flat columns + raw_json, mirrors Ack) - store.py: add_ta1_ack, list_ta1_acks (returns all rows), get_ta1_ack - db version bumped 4 -> 5 (test_acks.py updated) API (api.py) - POST /api/parse-ta1: text/file ingest, persists ta1_ack, returns detail-ready payload - GET /api/ta1-acks: list with limit + total (mirrors 999 pattern) - GET /api/ta1-acks/{ack_id}: detail - _ta1_to_ui / _serialize_ta1 / _serialize_ta1_from_row helpers Tests (17 new, 508 total passing) - tests/test_parse_ta1.py (8): CCYYMMDD + YYMMDD acceptance, E/R codes, source_batch_id, missing ISA/TA1, short defaults - tests/test_api_ta1.py (9): happy path, rejected persists, empty/malformed 400, missing file 422, detail regenerates segment, 404, empty list, newest-first - tests/test_prodfiles_smoke.py: extended to smoke-test 352 production TA1 files (A=0, R=352, E=0) - tests/test_api_parse_persists.py: cross-pipeline reconciliation test asserting invariants across 837P + 835 prod files Real-data finding: all 352 production TA1s are R (rejected); operator follow-up warranted.	2026-06-20 18:58:56 -06:00

Author

SHA1

Message

Date

Tyler

561018c690

feat(sp8): outbound 837P serializer — full rebuild + round-trip tests

- backend/src/cyclone/parsers/serialize_837.py — full-rebuild 837P serializer.
  Emits envelope (ISA/GS/ST/SE/GE/IEA + BHT) + submitter/receiver/billing
  provider/subscriber/payer hierarchy + editable segments (CLM/REF*G1/HI)
  + per-service-line LX/SV1/DTP*472/REF*6R — all from canonical
  ClaimOutput fields.

  Pivoted from spec §3.1 hybrid to full rebuild because ClaimOutput.raw_segments
  only captures post-CLM segments (CLM, REF*G1, HI, LX, SV1 pairs) — not the
  envelope or hierarchies. A pass-through approach cannot regenerate those
  without expanding raw_segments in parse_837.py (out of scope for this SP).

- backend/tests/test_serialize_837.py — 36 tests covering envelope shape,
  hierarchy segments, claim-level builders, service-line builders, edited-field
  propagation, round-trip, custom sender/receiver IDs, and resubmit helper.

- backend/tests/test_prodfiles_smoke.py::test_claims_prodfile_round_trip —
  every file in docs/prodfiles/claims/ (113 files) round-trips through
  serialize_837 → parse_837_text with deep-equal ClaimOutput (modulo
  validation, which is recomputed by the parser).

- docs/superpowers/plans/2026-06-20-cyclone-serialize-837.md — full plan
  with amendment note documenting the Approach A pivot.

Per session convention, plan note about unrelated modifications to
parse_835.py / fixtures stashed separately.

2026-06-20 20:27:48 -06:00

Tyler

76278ec9f6

feat(ta1): TA1 interchange ACK parser, persistence, and API

Adds full TA1 (Interchange Acknowledgment, X12 envelope-level) support
to mirror the existing 999 transaction-set ACK pipeline.

Parser & models
- parsers/models_ta1.py: Pydantic Ta1Ack + ParseResultTa1 models
  (AckCode = Literal['A','E','R'], date serializer mirroring 999)
- parsers/parse_ta1.py: TA1 segment parser
  - Tolerant YYMMDD (6-digit) + CCYYMMDD (8-digit) date handling
    for CO Medicaid interchange_date / ack_generated_date
  - 106-char ISA validation (15-char sender/receiver IDs)
  - source_batch_id = 'TA1-<ISA13>'

Persistence
- migrations/0005_create_ta1_acks.sql: ta1_acks table + indexes
  on source_batch_id and ack_code
- db.py: Ta1Ack ORM model (flat columns + raw_json, mirrors Ack)
- store.py: add_ta1_ack, list_ta1_acks (returns all rows),
  get_ta1_ack
- db version bumped 4 -> 5 (test_acks.py updated)

API (api.py)
- POST /api/parse-ta1: text/file ingest, persists ta1_ack,
  returns detail-ready payload
- GET /api/ta1-acks: list with limit + total (mirrors 999 pattern)
- GET /api/ta1-acks/{ack_id}: detail
- _ta1_to_ui / _serialize_ta1 / _serialize_ta1_from_row helpers

Tests (17 new, 508 total passing)
- tests/test_parse_ta1.py (8): CCYYMMDD + YYMMDD acceptance,
  E/R codes, source_batch_id, missing ISA/TA1, short defaults
- tests/test_api_ta1.py (9): happy path, rejected persists,
  empty/malformed 400, missing file 422, detail regenerates
  segment, 404, empty list, newest-first
- tests/test_prodfiles_smoke.py: extended to smoke-test 352
  production TA1 files (A=0, R=352, E=0)
- tests/test_api_parse_persists.py: cross-pipeline reconciliation
  test asserting invariants across 837P + 835 prod files

Real-data finding: all 352 production TA1s are R (rejected);
operator follow-up warranted.

2026-06-20 18:58:56 -06:00

2 Commits