update CIQ app

apps/ciq_2g_generator.py

@@ -1,9 +1,39 @@
+from pathlib import Path
+
 import pandas as pd
 import streamlit as st
 
-from queries.process_ciq_2g import generate_ciq_2g_excel
+from queries.process_ciq_2g import generate_ciq_2g_excel, generate_free_bcf_excel
 
 st.title("CIQ 2G Generator")
+st.markdown(
+    """
+Génère les exports CIQ 2G à partir du dump OML + CIQ brut.
+- **Dump** : obligatoire (format .xlsb)
+- **CIQ brut 2G** : obligatoire pour générer le CIQ
+- **BCF forbidden** : optionnel (colonnes BSC/BCF ou BSCID/BCFID)
+"""
+)
+
+st.subheader("📄 Sample files")
+samples_dir = Path(__file__).resolve().parents[1] / "samples"
+sample_ciq_2g = samples_dir / "CIQ_2G.xlsx"
+sample_forbidden = samples_dir / "FORBIDEN_SCF.xlsx"
+
+if sample_ciq_2g.exists():
+    st.download_button(
+        label="Download CIQ 2G sample",
+        data=sample_ciq_2g.read_bytes(),
+        file_name=sample_ciq_2g.name,
+        mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    )
+if sample_forbidden.exists():
+    st.download_button(
+        label="Download BCF forbidden sample",
+        data=sample_forbidden.read_bytes(),
+        file_name=sample_forbidden.name,
+        mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    )
 
 col1, col2 = st.columns(2)
 with col1:
@@ -26,11 +56,40 @@ with col3:
 with col4:
     mnc = st.number_input("MNC", value=2, step=1, min_value=0, key="ciq2g_mnc")
 
-if dump_file is None or ciq_file is None:
+if dump_file is None:
     st.info("Upload dump xlsb + CIQ brut Excel to generate CIQ 2G.")
     st.stop()
 
-if st.button("Generate", type="primary"):
+st.subheader("✅ Génération BCF libre")
+if st.button("Generate BCF libre", type="secondary"):
+    try:
+        with st.spinner("Generating BCF libre..."):
+            free_bcf_df, free_bcf_bytes = generate_free_bcf_excel(
+                dump_file, forbidden_file=forbidden_file
+            )
+            st.session_state["ciq2g_free_bcf_df"] = free_bcf_df
+            st.session_state["ciq2g_free_bcf_bytes"] = free_bcf_bytes
+        st.success("BCF libre generated")
+    except Exception as e:
+        st.error(f"Error: {e}")
+
+free_bcf_df = st.session_state.get("ciq2g_free_bcf_df")
+free_bcf_bytes = st.session_state.get("ciq2g_free_bcf_bytes")
+if free_bcf_df is not None:
+    st.dataframe(free_bcf_df, use_container_width=True)
+if free_bcf_bytes:
+    st.download_button(
+        label="Download BCF libre",
+        data=free_bcf_bytes,
+        file_name="BCF_LIBRE.xlsx",
+        mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    )
+
+st.subheader("✅ Génération CIQ 2G")
+if ciq_file is None:
+    st.info("Upload CIQ brut 2G Excel to generate CIQ 2G.")
+
+if ciq_file is not None and st.button("Generate", type="primary"):
     try:
         with st.spinner("Generating CIQ 2G... (dump is heavy)"):
             sheets, excel_bytes = generate_ciq_2g_excel(

apps/ciq_3g_generator.py

@@ -1,9 +1,29 @@
+from pathlib import Path
+
 import pandas as pd
 import streamlit as st
 
 from queries.process_ciq_3g import generate_ciq_3g_excel
 
 st.title("CIQ 3G Generator")
+st.markdown(
+    """
+Génère les exports CIQ 3G (WBTS + WCEL) à partir du CIQ brut.
+- **CIQ brut 3G** : obligatoire (format Excel)
+"""
+)
+
+st.subheader("📄 Sample files")
+samples_dir = Path(__file__).resolve().parents[1] / "samples"
+sample_ciq_3g = samples_dir / "CIQ_3G.xlsx"
+
+if sample_ciq_3g.exists():
+    st.download_button(
+        label="Download CIQ 3G sample",
+        data=sample_ciq_3g.read_bytes(),
+        file_name=sample_ciq_3g.name,
+        mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    )
 
 ciq_file = st.file_uploader(
     "Upload CIQ brut 3G (Excel)", type=["xlsx", "xls"], key="ciq3g_ciq"

apps/ciq_4g_generator.py

@@ -1,9 +1,29 @@
+from pathlib import Path
+
 import pandas as pd
 import streamlit as st
 
 from queries.process_ciq_4g import generate_ciq_4g_excel
 
 st.title("CIQ 4G Generator")
+st.markdown(
+    """
+Génère les exports CIQ 4G à partir du CIQ brut.
+- **CIQ brut 4G** : obligatoire (format Excel)
+"""
+)
+
+st.subheader("📄 Sample files")
+samples_dir = Path(__file__).resolve().parents[1] / "samples"
+sample_ciq_4g = samples_dir / "CIQ_LTE.xlsx"
+
+if sample_ciq_4g.exists():
+    st.download_button(
+        label="Download CIQ 4G sample",
+        data=sample_ciq_4g.read_bytes(),
+        file_name=sample_ciq_4g.name,
+        mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    )
 
 ciq_file = st.file_uploader(
     "Upload CIQ brut 4G (Excel)", type=["xlsx", "xls"], key="ciq4g_ciq"

queries/process_ciq_2g.py

@@ -425,6 +425,22 @@ def _build_bcf_sheet_from_assigned_sites(
     return pd.DataFrame(rows)
 
 
+def generate_free_bcf_excel(
+    dump_file, forbidden_file=None
+) -> tuple[pd.DataFrame, bytes]:
+    dump_bts = _read_dump_bts_required_columns(dump_file)
+    forbidden_by_bsc, forbidden_df = _read_forbidden_bcfs(forbidden_file)
+    df_bcf_free = _build_free_bcf_sheet(dump_bts, forbidden_by_bsc=forbidden_by_bsc)
+
+    bytes_io = io.BytesIO()
+    with pd.ExcelWriter(bytes_io, engine="xlsxwriter") as writer:
+        df_bcf_free.to_excel(writer, sheet_name="BCF_LIBRE", index=False)
+        if not forbidden_df.empty:
+            forbidden_df.to_excel(writer, sheet_name="BCF_FORBIDDEN", index=False)
+
+    return df_bcf_free, bytes_io.getvalue()
+
+
 def _build_free_bcf_sheet(
     dump_bts: pd.DataFrame, forbidden_by_bsc: dict[int, set[int]] | None = None
 ) -> pd.DataFrame: