akvo / akvo-mis / #675

88%

main: 88%

push

coveralls-python

[#236] Add FB-007 form import/export requirements and design docs (#237)

* [#236] Add FB-007 form import/export design doc

Single consolidated design document covering requirements and design:
- Requirements: user stories, FR-1..FR-16, NFR-1..NFR-8, out of scope
- Discovery decisions D-1..D-10 (editor-payload JSON format,
  update-in-place by Forms.id, async import via v1_jobs, shared
  seeder/importer parser) and risk notes R-1..R-3
- Export format spec (format_version 1, metadata envelope,
  model<->key mapping, type/constant tables)
- API contract: manage/forms {id}/export, import/preflight, import,
  import/status/{task_id}
- Backend architecture: shared form_definition.py parser
  (normalize/validate/export/import), job task, form_seeder refactor
- Design decisions DD-1..DD-7, frontend ImportFormModal flow,
  compatibility/security checklists, testing strategy, implementation
  plan, worked update-in-place example from a real editor payload

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* [#236] Update FB-007 design doc: cascade/SQLite scope + import template example

- Add §11 "Cascade data & mobile SQLite" subsection: explain generate_sqlite
  is out of scope, document cascade question data dependencies per type,
  and introduce the unknown_entity_type preflight warning
- Add unknown_entity_type warning to §6.2 preflight response example
- Add level field to validate_form_definition return shape in §8 docstring
- Add Appendix B: concrete end-to-end import process template example covering
  normalize/validate output, preflight response, and job task flow

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* [#236] Add JobTypes.import_form=8, FORM_IMPORT_MAX_FILE_SIZE setting, migration

- v1_jobs/constants.py: add import_form = 8 to JobTypes + FieldStr
- mis/settings.py: add FORM_IMPORT_MAX_FILE_SIZE (env-c... (continued)

5641 of 6554 branches covered (86.07%)

Branch coverage included in aggregate %.

10640 of 11875 relevant lines covered (89.6%)

0.9 hits per line