docs: add project docs and test updates

writable/database/free_recipient_test_seed.sql

@@ -0,0 +1,28 @@
+-- 무료용 대상자 테스트 데이터 (/bag/free-recipients 목록 확인용)
+-- 전제: free_recipient 테이블 존재, code_master_init_daegu.sql 로 H(무상지급) 코드 적용됨
+--
+-- 넣는 지자체 (둘 다 있으면 각각에 삽입, UNION 으로 중복 lg_idx 제거):
+--   1) lg_state=1 인 지자체 중 가장 작은 lg_idx (tester_local mb_lg_idx=1·메뉴 기본값과 맞추기)
+--   2) lg_code = '110204' 대구 남구
+--
+-- 목록이 비면: Super Admin 은 상단에서 지자체 선택, 지자체관리자는 member.mb_lg_idx 와 일치하는지 확인.
+
+SET NAMES utf8mb4;
+
+INSERT INTO `free_recipient` (`fr_lg_idx`, `fr_type_code`, `fr_name`, `fr_phone`, `fr_addr`, `fr_dong_code`, `fr_note`, `fr_end_date`, `fr_state`, `fr_regdate`)
+SELECT t.lg_idx, v.tp, v.nm, v.ph, v.ad, '', v.nt, v.ed, 1, NOW()
+FROM (
+  (SELECT lg_idx FROM local_government WHERE lg_state = 1 ORDER BY lg_idx ASC LIMIT 1)
+  UNION
+  (SELECT lg_idx FROM local_government WHERE lg_code = '110204' LIMIT 1)
+) t
+CROSS JOIN (
+  SELECT '10' AS tp, '테스트생보_홍길동' AS nm, '010-9001-0001' AS ph, '대구 남구 대명로 1 (테스트)' AS ad, '개발/테스트 시드' AS nt, NULL AS ed
+  UNION ALL SELECT '4', '테스트복지관_남구', '053-900-0002', '대구 남구 봉덕로 100 (테스트)', '시설 테스트용', NULL
+  UNION ALL SELECT '3', '테스트무공수훈_김국가', '010-9001-0003', '대구 남구 이천로 50 (테스트)', '무공수훈자 테스트', '2027-12-31'
+) v
+WHERE NOT EXISTS (
+  SELECT 1 FROM `free_recipient` f WHERE f.fr_lg_idx = t.lg_idx AND f.fr_name = v.nm
+);
+
+-- fr_type_code: H 종류 — 1 시설보호, 10 생보자, 3 무공수훈자, 4 사회복지시설